Retrieve a customer
Returns a customer with full dashboard detail: all saved payment
methods, recent payments, and a lifetime spend summary. The
section_size parameter caps how many items appear in
payment_methods and recent_payments; omit it to receive all.
Authorizations
A merchant secret key (sk_…) sent as Authorization: Bearer <key>.
Path Parameters
The customer id (cus_…).
Query Parameters
Maximum items to return in payment_methods and recent_payments (1–100). Omit to return all.
1 <= x <= 100Response
The customer with full dashboard detail.
A customer enriched with payment summary data. The list endpoint
returns summary, default_payment_method, and last_payment for
each item. The retrieve endpoint additionally returns the full
payment_methods and recent_payments arrays.
Unique customer identifier (cus_…).
customer Whether this customer was created with a live (true) or test (false) key.
Empty string when not set.
Empty string when not set.
Empty string when not set.
Billing address; null when not set.
Shipping details; null when not set.
How the customer was created (for example api).
api, checkout, import, dashboard, platform Payment configuration stored for the customer.
True when the customer has been soft-deleted.
Unix epoch seconds.
Lifetime payment statistics for this customer.
The customer's default payment method; absent when none is set.
The customer's most recent payment; absent when there are none.
All payment methods on file. Only returned by the retrieve endpoint.
Recent payments. Only returned by the retrieve endpoint.

