# Orders · Customer API

> Customer API reference for orders: GET /orders, GET /orders/{id}.

> Markdown version of https://kanorio.com/en/developers/customer-api/orders. Append `.md` to any developer docs URL for this format. Index: https://kanorio.com/llms.txt · MCP: https://app.kanorio.com/api/mcp

Base URL: `https://{site}/api/v1/customer` · [Errors](https://kanorio.com/en/developers/basics/errors) · [Pagination](https://kanorio.com/en/developers/basics/pagination)

### The customer's orders

`GET /orders`

- Stability: beta

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `limit` | query | integer | no | Maximum number of items to return, 1-100. Defaults to 20. |
| `cursor` | query | string | no | Opaque cursor from the previous page's nextCursor. Omit for the first page. |
| `locale` | query | string | no | Locale code (any letter case) or URL prefix of a live locale. Omitted: the customer's own locale (Contact.locale, set by their last checkout, sign-in or form submission), falling back to the site's primary locale. Titles and descriptions without a translation fall back to the primary locale. |

**Response** (200)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | object[] | yes | — |
| `hasMore` | boolean | yes | True when another page exists; pass nextCursor to fetch it. |
| `nextCursor` | string \| null | yes | Cursor for the next page, or null on the last page. |

**Errors**

| Code | Status | When |
| --- | --- | --- |
| `INVALID_CURSOR` | 400 | — |
| `INVALID_LIMIT` | 400 | — |

```bash
curl -X GET "https://{site}/api/v1/customer/orders" \
  -H "Authorization: Bearer $KANORIO_CUSTOMER_TOKEN"
```

### One order (add `receipt=1` for the receipt payload)

`GET /orders/{id}`

- Stability: beta

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string | yes | — |
| `receipt` | query | "1" | no | — |
| `locale` | query | string | no | Locale code (any letter case) or URL prefix of a live locale. Omitted: the customer's own locale (Contact.locale, set by their last checkout, sign-in or form submission), falling back to the site's primary locale. Titles and descriptions without a translation fall back to the primary locale. |

**Response** (200)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `order` | object | no | — |

**Errors**

| Code | Status | When |
| --- | --- | --- |
| `NOT_FOUND` | 404 | — |
| `NO_RECEIPT` | 404 | — |

```bash
curl -X GET "https://{site}/api/v1/customer/orders/{id}" \
  -H "Authorization: Bearer $KANORIO_CUSTOMER_TOKEN"
```