Skip to main content
GET
Retrieve a customer

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required
Example:

"cus_mi4f0oda6x9m7gcsvjk0ole1"

Response

Retrieve the customer details

object
enum<string>
required

Type of the object, always 'customer'

Available options:
customer
id
string
required

Unique identifier for the customer

Example:

"cus_mi4f0oda6x9m7gcsvjk0ole1"

first_name
string
required

Customer's first name

Required string length: 1 - 100
Example:

"John"

last_name
string
required

Customer's last name

Required string length: 1 - 100
Example:

"Doe"

email
string<email>
required

Email address

Example:

"john.doe@example.com"

created_at
required

Timestamp when the customer was created

Example:

"2024-03-14T12:00:00Z"

type
enum<string>
default:person

Type of the customer, always 'person'

Available options:
person
vat_id
string | null

VAT identification number (USt-IdNr.) of the customer

Example:

"DE123456789"