---
title: "List customer orders"
method: GET
path: "/v1/customers/{id}/orders"
tags: ["Customers"]
---

# List customer orders

`GET /v1/customers/{id}/orders`

Retrieve a paginated list of orders for a specific customer.

## Path parameters

- `id` string, required

## Query parameters

- `page_number` number
- `page_size` number

## Response `200`

Successfully retrieved customer orders

- OrderListEntity
  - `items` OrderEntity[], required — List of order items
    - `id` string, required — Unique identifier for the object.
    - `mode` 'test' | 'prod' | 'sandbox', required — String representing the environment.
    - `object` string, required — String representing the object's type. Objects of the same type share the same value.
    - `customer` string, nullable — The customer who placed the order.
    - `product` string, required — The product associated with the order.
    - `transaction` string, nullable — The transaction ID of the order
    - `discount` string, nullable — The discount ID of the order
    - `amount` number, required — The total amount of the order in cents. 1000 = $10.00
    - `sub_total` number — The subtotal of the order in cents. 1000 = $10.00
    - `tax_amount` number — The tax amount of the order in cents. 1000 = $10.00
    - `discount_amount` number — The discount amount of the order in cents. 1000 = $10.00
    - `amount_due` number — The amount due for the order in cents. 1000 = $10.00
    - `amount_paid` number — The amount paid for the order in cents. 1000 = $10.00
    - `currency` string, required — Three-letter ISO currency code, in uppercase. Must be a supported currency.
    - `fx_amount` number, nullable — The amount in the foreign currency, if applicable.
    - `fx_currency` string, nullable — Three-letter ISO code of the foreign currency, if applicable.
    - `fx_rate` number, nullable — The exchange rate used for converting between currencies, if applicable.
    - `status` 'pending' | 'paid', required — Current status of the order.
    - `type` 'recurring' | 'onetime', required — The type of order. This can specify whether it's a regular purchase, subscription, etc.
    - `affiliate` string, nullable — The affiliate associated with the order, if applicable.
    - `created_at` string, date-time, required — Creation date of the order
    - `updated_at` string, date-time, required — Last updated date of the order
  - `pagination` PaginationEntity, required
    - `total_records` number, required — Total number of records in the list
    - `total_pages` number, required — Total number of pages available
    - `current_page` number, required — The current page number
    - `next_page` number, nullable, required — The next page number, or null if there is no next page
    - `prev_page` number, nullable, required — The previous page number, or null if there is no previous page

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Invalid or missing API key
- `404` — Not Found - Resource does not exist

---

[API](https://skmtc.net/creem/apis/creem-api.md) · [All operations](https://skmtc.net/creem/apis/creem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/creem/creem-api/revisions/aa593160d96c/schema)