# List the calling application's domain-purchase orders, newest first

> list sell orders: reference page for this CustomDomain™ API operation in the registrar group. Covers parameters, request body, responses and error codes.

Source: https://docs.customdomain.ai/docs/api-reference/registrar/listSellOrders

## `GET https://api.customdomain.ai/v1/sell/orders`

Every order the application recorded (quoted, purchasing, purchased, transferred, failed, or expired). `purchasing` is an order being registered right now, after its payment was authorized. A quote-only order that was never paid for is expired by the hourly reaper after 24 hours (status `expired`, with a `purchase.confirmation.expired` webhook), so "quoted" always means recent intent.

With a tenant API key it lists the orders of every application of the tenant, or of one with `app_id` (another tenant's id answers `404`). A widget token minted with scope `app`, or a delegated agent token with `domains:read`, lists its own application's orders.

### Authentication

`widgetJWT`, `apiKey`, `agentToken`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `app_id` | query | string | no | With a tenant API key, list the orders of this one application of the tenant. |

### Responses

| Status | Description |
| --- | --- |
| `200` | Orders |
| `401` | Error envelope: {code, title, details}. |
| `403` | Error envelope: {code, title, details}. |
| `503` | Error envelope: {code, title, details}. |

### `200` response body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `orders` | array of object | yes |  |
| `count` | integer | yes |  |

The full specification is served at `GET https://api.customdomain.ai/v1/openapi.json`.
