Get customer by ID
API Refs
- Staging: Get customer by ID
Path parameters
| Name | Type | Description | Required |
|---|---|---|---|
| id | string | StripeCustomerID - use Stripe ID (cus_xxxxx) or numeric ID | yes |
Response body
Returns a detailed customer object including:
- Customer profile (id, email, firstName, lastName, phone)
- Address information (line1, line2, city, state, postal_code, country)
- Payment methods on file (id, type, isDefault)
- Stripe StripeCustomerID
- Timestamps (createdAt, updatedAt)
Description
This endpoint retrieves customer information including their profile details, address, and payment methods on file. While both numeric IDs and Stripe StripeCustomerIDs are accepted, we recommend using Stripe StripeCustomerIDs (cus_xxxxx) for consistency. For subscription history, use the /customers/{id}/subscriptions endpoint.
Updated 3 days ago