Skip to main content
GET
Retrieve a customer

Authorizations

Authorization
string
header
required

Bearer token authentication. Pass your API key as Authorization: Bearer sk_.... See Authentication for keys, scopes, and sandbox vs production.

Path Parameters

customer_id
string
required

Response

Success

customer_id
string
required

Unique identifier for the customer, prefixed with cust_.

Example:

"cust_1a2b3c4d5e6f"

email
string<email>
required

The customer's email address.

Example:

"jane@example.com"

metadata
object
required

Your own key-value data attached to the customer.

Example:
created_at
string<date-time>
required

ISO 8601 timestamp when the customer was created.

Example:

"2026-01-24T12:00:00.000Z"

updated_at
string<date-time>
required

ISO 8601 timestamp when the customer was last updated.

Example:

"2026-01-24T12:00:00.000Z"

name
string | null

The customer's full name. null when not set.

Example:

"Jane Doe"

phone_number
string | null

The customer's phone number in E.164 format, e.g. +2348012345678.

Example:

"+2348012345678"

billing_address
object | null

The customer's billing address, or null if none is set.