Show a customer
Returns the resource for a customer with id = x.
AuthorizationbearerAuth
Authorization
bearerAuth API token as bearer token — you receive a test and a live token, there is no switch between them. See Setup → Authentication and Setup → Test mode.
In: header
Path Parameters
The ID of the resource.
Header Parameters
The API only responds with JSON — this header is mandatory on every request (see Setup → Headers).
"application/json"Value in
- "application/json"
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/customers/0" \ -H "Accept: application/json"{ "id": 14, "first_name": "Delta", "last_name": "Spencer", "is_test": 0, "email": "[email protected]", "external_identifier": null, "created_at": "2026-03-02T08:31:06+00:00", "updated_at": "2026-03-02T08:31:06+00:00"}List customers GET
Fetching a list of customers. ## List Return a collection of customers. ### Filtering ##### List of customers for specific email(s) * `/customers?filter[email][email protected]` * `/customers?filter[email][email protected],[email protected]` ##### List of customers for specific external identifier(s) * `/customers?filter[external_identifier]=12345` * `/customers?filter[external_identifier]=12345,67890` See: [Pagination](/docs/checkout/2022-02-01/basic/pagination), [Filtering](/docs/checkout/2022-02-01/basic/filtering) This collection is **cursor paginated**: `links.first`/`links.last` are `null`, `links.next`/`links.prev` carry the cursor URLs and `meta` contains `next_cursor`/`prev_cursor` instead of `current_page`.
Upload media POST
In the `Media` section you can upload image or PDF files to use them in other parts of the system by referencing the Media ID. The request body is the **raw file content**; set the `Content-Type` header to the file's mime type (and `Content-Length` to its size), e.g.: ``` POST /media HTTP/1.1 Content-Type: image/jpeg Content-Length: 42840 raw content ``` The following file formats are currently supported: | Type | Options | |----------|---------------------------------------| | JPG/JPEG | RGB, 360dpi recommended | | PNG | RGB, transparency, 360dpi recommended | | PDF | RGB, 360dpi recommended | **Warning:** The maximum file size is 51.2MB.