Registrar

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

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.

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)

Query parameters

app_idstring

With a tenant API key, list the orders of this one application of the tenant.

Response

Orders

countinteger required

Example response

{
  "orders": [
    {
      "orderId": "ord_1a2b3c"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.