List tasking orders

get

Returns tasking orders for the caller's organization, ordered by submitted_at according to the sort query parameter (newest-first by default). Each row includes customer information, ordered products with statuses, ordered zone count, and pagination/count metadata.

Authorizations

x-api-keystringRequired

API key passed via request header. Either this or the api_key query parameter is required.

Query parameters

limitinteger · min: 1 · max: 100Optional

Maximum number of orders to return. Defaults to 100 and cannot exceed 100.

Default: 100

cursorstringOptional

Opaque keyset pagination token. Follow the next/prev URLs rather than constructing it by hand.

Pattern: ^[aV64kbEPFOzgpjAGnN710Bvw8sucxrIQyXtdRJfMqK39CZUhoiLS2DWeH5mYlT]+$

searchstring · min: 3Optional

Case-insensitive partial match against spexi_order_id and external_order_id. Minimum 3 characters.

statusstring · enumOptional

current returns orders with at least one product in any non-terminal status, including submitted, feasibility_check, pending_confirmation, in_review, in_planning, capture_in_progress, processing, or qa. past returns orders where every product is delivered, cancelled, or unfulfillable. Omit for all.

Possible values:

sortstring · enumOptional

Sort direction on the sort_by field. desc (default) is newest-first.

Default: descPossible values:

sort_bystring · enumOptional

Field to sort by. Currently only submitted_at is supported.

Default: submitted_atPossible values:

Responses

200

Tasking orders for the caller's organization.

application/json

cursorstringOptional

Opaque next-page token. Present only when more pages are available; pass as the cursor query param to fetch the next page.

nextstring · uriOptional

Absolute URL for the next page, carrying the current filters. Present only when more results exist.

prevstring · uriOptional

Absolute URL for the previous page, carrying the current filters. Present only when a previous page exists.

401

Missing or invalid authentication credentials.

403

Caller lacks permission to access tasking orders.

get/developer-api/api/v1/order/tasking

GET /developer-api/api/v1/order/tasking HTTP/1.1
Host: world.spexi.com
x-api-key: YOUR_API_KEY
Accept: */*

{
  "orders": [
    {
      "spexi_order_id": "text",
      "external_order_id": "text",
      "customer": {
        "org_name": "text",
        "first_name": "text",
        "last_name": "text",
        "email": "[e-mail]"
      },
      "products": [
        {
          "type": "panorama",
          "subtype": "standard",
          "status": "submitted"
        }
      ],
      "ordered_zone_count": 1,
      "submitted_at": "2026-01-01T00:00:00.000Z"
    }
  ],
  "metadata": {
    "page_size": 1,
    "counts": {
      "all": 1,
      "current": 1,
      "past": 1
    }
  },
  "cursor": "text",
  "next": "https://example.com",
  "prev": "https://example.com"
}