Skip to content

List customers, most recent first.

GET
/customers
limit
required
integer | null format: int32

How many to return. Defaults to 10, capped at 100.

A page of customers

object
has_more
required
boolean
items
required
Array<object>

A customer as returned. Timestamps are Unix milliseconds, matching every other resource on this API.

object
created
required
integer format: int64
default_payment_method_id
One of:
null
email
string | null
id
required

Identifier for a customer (cus_…).

string
livemode
required
boolean
metadata
required
object
key
additional properties
string
name
string | null
phone
string | null
updated
required
integer format: int64