> For the complete documentation index, see [llms.txt](https://learn.spexi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.spexi.com/api-reference/tasking-api/list-all-tasking-orders.md).

# GET List all tasking orders

## List tasking orders

> 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.

```json
{"openapi":"3.0.3","info":{"title":"Spexi Developer API","version":"1.0.0"},"servers":[{"url":"https://world.spexi.com","description":"Production"}],"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key passed via request header. Either this or the `api_key` query parameter is required."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"api_key","description":"API key passed as a query parameter. Either this or the `x-api-key` header is required."}},"schemas":{"GetOrdersResponse":{"type":"object","properties":{"orders":{"type":"array","items":{"type":"object","properties":{"spexi_order_id":{"type":"string","description":"Order identifier."},"external_order_id":{"type":"string","nullable":true,"description":"Echoed external order id if supplied at submission."},"customer":{"type":"object","properties":{"org_name":{"type":"string","description":"Organization that placed the order."},"first_name":{"type":"string","description":"First name of the primary customer contact."},"last_name":{"type":"string","description":"Last name of the primary customer contact."},"email":{"type":"string","format":"email","description":"Email of the primary customer contact."}},"required":["org_name","first_name","last_name","email"],"description":"Customer organization and primary contact information."},"products":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["panorama","orthomosaic","image"],"description":"Product type requested for this order product."},"subtype":{"type":"string","enum":["standard","aligned"],"nullable":true,"description":"Product subtype for orthomosaic products; null otherwise."},"status":{"type":"string","enum":["submitted","in_review","feasibility_check","pending_confirmation","in_planning","capture_in_progress","processing","qa","delivered","cancelled","unfulfillable"],"description":"Current status of this order product."}},"required":["type","subtype","status"]},"description":"Products included in the order, with per-product status."},"ordered_zone_count":{"type":"integer","minimum":0,"description":"Number of H3 zones ordered."},"submitted_at":{"type":"string","format":"date-time","description":"ISO-8601 timestamp when the order was submitted."}},"required":["spexi_order_id","external_order_id","customer","products","ordered_zone_count","submitted_at"]}},"metadata":{"type":"object","properties":{"page_size":{"type":"integer","minimum":0,"description":"Number of orders returned in this page."},"counts":{"type":"object","properties":{"all":{"type":"integer","minimum":0,"description":"Total order count. When `search` is active, only orders matching the search term are counted."},"current":{"type":"integer","minimum":0,"description":"Count of orders with at least one current product. When `search` is active, only matching orders are counted."},"past":{"type":"integer","minimum":0,"description":"Count of orders where every product is terminal. When `search` is active, only matching orders are counted."}},"required":["all","current","past"],"description":"Order counts for all, current, and past views. Counts respect the active `search` filter but not the `status` filter, so tab totals stay visible while browsing a filtered list."}},"required":["page_size","counts"]},"cursor":{"type":"string","description":"Opaque next-page token. Present only when more pages are available; pass as the `cursor` query param to fetch the next page."},"next":{"type":"string","format":"uri","description":"Absolute URL for the next page, carrying the current filters. Present only when more results exist."},"prev":{"type":"string","format":"uri","description":"Absolute URL for the previous page, carrying the current filters. Present only when a previous page exists."}},"required":["orders","metadata"]}}},"paths":{"/developer-api/api/v1/order/tasking":{"get":{"description":"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.","operationId":"OrderController_getOrders","parameters":[{"name":"limit","required":false,"in":"query","description":"Maximum number of orders to return. Defaults to 100 and cannot exceed 100.","schema":{"minimum":1,"maximum":100,"default":100,"type":"integer"}},{"name":"cursor","required":false,"in":"query","description":"Opaque keyset pagination token. Follow the `next`/`prev` URLs rather than constructing it by hand.","schema":{"pattern":"^[aV64kbEPFOzgpjAGnN710Bvw8sucxrIQyXtdRJfMqK39CZUhoiLS2DWeH5mYlT]+$","type":"string"}},{"name":"search","required":false,"in":"query","description":"Case-insensitive partial match against spexi_order_id and external_order_id. Minimum 3 characters.","schema":{"minLength":3,"type":"string"}},{"name":"status","required":false,"in":"query","description":"`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.","schema":{"enum":["current","past"],"type":"string"}},{"name":"sort","required":false,"in":"query","description":"Sort direction on the `sort_by` field. `desc` (default) is newest-first.","schema":{"default":"desc","enum":["asc","desc"],"type":"string"}},{"name":"sort_by","required":false,"in":"query","description":"Field to sort by. Currently only `submitted_at` is supported.","schema":{"default":"submitted_at","enum":["submitted_at"],"type":"string"}}],"responses":{"200":{"description":"Tasking orders for the caller's organization.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetOrdersResponse"}}}},"401":{"description":"Missing or invalid authentication credentials."},"403":{"description":"Caller lacks permission to access tasking orders."}},"summary":"List tasking orders","tags":["Order"]}}}}
```