---
title: "List the calling application's domain-purchase orders, newest first"
method: GET
path: "/sell/orders"
tags: ["Registrar"]
---

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

`GET /sell/orders`

## Request

- Base URL: `https://api.customdomain.ai/v1`
- URL: `https://api.customdomain.ai/v1/sell/orders`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.customdomain.ai/oauth/agent/authorize`, token URL `https://api.customdomain.ai/oauth/agent/token`, scopes: `domains:read`)

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.

## Query parameters

- `app_id` string

## Response `200`

Orders

- object
  - `orders` SellOrderView[], required
    - `orderId` string, required
    - `domain` string, required
    - `registrar` string
    - `status` 'quoted' | 'purchasing' | 'purchased' | 'transferred' | 'failed' | 'expired', required
    - `createdAt` string, date-time
    - `regOrderId` string: the registrar's order reference, once purchased.
    - `jobId` string
    - `link` string: sharing-rail checkout URL, if any.
    - `freeDomain` boolean: promo (first-domain-free) registration.
  - `count` integer, required

## Other responses

- `401`: Error envelope: {code, title, details}.
- `403`: Error envelope: {code, title, details}.
- `503`: Error envelope: {code, title, details}.

---

[API](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api.md) · [All operations](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc.dev/customdomain/apis/customdomain-control-plane-api/revisions/34d89cb7a7cd?raw)