---
title: "List all commercial data orders"
method: GET
path: "/orders"
tags: ["Orders"]
---

# List all commercial data orders

`GET /orders`

Lists all created orders submitted by a user, regardless of the status
or the collection.

It is **strongly RECOMMENDED** to keep the response size small by
omitting all optional non-scalar values from objects in `orders` (e.g. `parameters`).
To get the full metadata for an order clients MUST request `GET /orders/{order_id}`.

## Parameters

- `../../openapi.yaml#/components/parameters/pagination_limit` — unresolved $ref

## Response `200`

List of orders and related links.

- object
  - `orders` Order[], required
    - `id` string, required — Unique identifier of the order at the back-end, which MUST match the specified pattern.
    - `order:id` string — Identifier of the order at the data provider.
    - `order:status` 'orderable' | 'ordered' | 'pending' | 'shipping' | 'succeeded' | 'failed' | 'canceled', required — The status of the order. * `orderable`: The item or asset is orderable via the provider scenario. * `ordered`: The item or asset is ordered and the provider is preparing to make it available. * `pending`: The item or asset is ordered but wait for an activation before being able for shipping. * `shipping` The item or asset order are being processed by the provider to provide you with the asset(s). * `succeeded`: The provider has delivered your order and asset(s) are available. * `failed`: The provider is not able to deliver the order. * `canceled` The order has been canceled.
    - `order:date` string, date-time, required — The order time. Formatted as a [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339.html) date-time.
    - `order:expiration_date` string, date-time — The validity time of the order. Formatted as a [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339.html) date-time.
    - `source_collection_id` string, required — Unique identifier of the source collection.
    - `target_collection_id` string, required — Unique identifier of the target collection. Can be the same as `source_collection_id`.
    - `costs` Money, required — unresolved $ref
    - `parameters` OrderParameters — Key-value pairs of available `order_parameters` as listed at `GET /collections/{collection_id}` for filtering available items.
    - `items` ItemId[] — List of ordered item IDs.
    - `links` Link[] — Links related to this order, e.g. to metadata for ordered items listed in `items`. It is highly RECOMMENDED to provide links with the following `rel` (relation) types: 1. `item`: A link back to a valid STAC Item that has been ordered. Could be a link to `GET /collections/{collection_id}/items/{item_id}`. 2. `order`: A link pointing to a dcoument describing the ordering terms and conditions of the data provider. For additional relation types see also the lists of [common relation types in openEO](#section/API-Principles/Web-Linking). — unresolved $ref
  - `links` LinksPagination, required — unresolved $ref

## Other responses

- `4XX` — unresolved $ref
- `5XX` — unresolved $ref

## Changes

> 7 revisions in range; 1 could not be searched.

- **2022-08-18** `08c94a3c726a` — 3 warning, 2 info
  - added the new `failed` enum value to the `orders/items/order:status` response property for the response status `200`
  - added the new `pending` enum value to the `orders/items/order:status` response property for the response status `200`
  - added the new `succeeded` enum value to the `orders/items/order:status` response property for the response status `200`
  - removed the `delivered` enum value from the `orders/items/order:status` response property for the response status `200`
  - …1 more
- **2022-08-15** `16d94ef07eec` — 2 warning, 3 info
  - added the new `delivered` enum value to the `orders/items/order:status` response property for the response status `200`
  - added the new `unable_to_deliver` enum value to the `orders/items/order:status` response property for the response status `200`
  - removed the `failed` enum value from the `orders/items/order:status` response property for the response status `200`
  - removed the `pending` enum value from the `orders/items/order:status` response property for the response status `200`
  - …1 more

[Change history](https://skmtc.dev/open-eo/apis/openeo-api-commercial-data-extension/changes/orders/get.md)

---

[API](https://skmtc.dev/open-eo/apis/openeo-api-commercial-data-extension.md) · [All operations](https://skmtc.dev/open-eo/apis/openeo-api-commercial-data-extension/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/open-eo/openeo-api-commercial-data-extension/revisions/5484a04170e2/schema)