Skip to main content
GET
Get customer

Authorizations

Authorization
string
header
required

Organization API key using Authorization: Bearer sk_....

Path Parameters

id
string
required

Identifier of the customer.

Response

object | null

Customer details

Customer details response. Returns null if the customer does not exist.

id
string
required

Unique identifier of the customer.

Example:

"cus_1234567890abcdefghij"

createdAt
required

Date and time when the customer was created.

Example:

"2025-01-10T12:00:00.000Z"

updatedAt
required

Date and time when the customer was last updated.

Example:

"2025-01-10T12:00:00.000Z"

name
string
required

Name of the customer.

Example:

"Juan Pérez"

username
string
required

Username used for customer login and customer identification.

Example:

"juan_perez_01"

organizationId
string
required

Identifier of the organization this customer belongs to.

Example:

"org_1234567890abcdefghij"

acceptedServiceAgreement
boolean
required

Whether the customer has accepted the service agreement.

Example:

true

skipTaxInvoice
boolean
required

Whether tax invoice generation is skipped for this customer.

Example:

false

emailVerified
boolean
required

Whether the customer has verified their email address.

Example:

false

phoneNumberVerified
boolean
required

Whether the customer has verified their phone number.

Example:

true

hasChangedPassword
boolean
required

Whether the customer has set a non-default password.

Example:

true

email
string | null

Email address of the customer.

Example:

"juan@example.com"

phoneNumber
string | null

Primary WhatsApp phone number of the customer, usually in E.164 format.

Example:

"+525512345678"

secondaryPhoneNumber
string | null

Secondary phone number used for reminders and announcements.

Example:

null

archivedAt

Date and time when the customer was archived.

Example:

null

archivedById
string | null

Identifier of the user who archived this customer.

Example:

"u_1234567890abcdefghij"

signatureAcceptedAt

Date and time when recurring charges terms were accepted via signature.

Example:

"2025-01-10T12:00:00.000Z"

optedOutWhatsappAt

Date and time when the customer opted out of WhatsApp reminders.

Example:

null

optedInWhatsappAt

Date and time when the customer opted in to WhatsApp reminders.

Example:

"2025-01-05T10:00:00.000Z"

startedWhatsappAt

Date and time when WhatsApp opt-in flow was started for this customer.

Example:

"2025-01-05T09:55:00.000Z"

replyWithAssistant
boolean | null

Whether to reply to this customer using the assistant.

Example:

false

metadata
object[] | null

Custom metadata entries attached to this customer as key-value pairs.

Example:
meta
object | null

Flattened metadata map where each key maps to a string value.

Example: