---
title: "Full metadata for an order"
method: GET
path: "/orders/{order_id}"
tags: ["Orders"]
---

# Full metadata for an order

`GET /orders/{order_id}`

Get full metadata of the order.

Back-ends can optionally link to the spatial and temporal extent information and other metadata about the items using the relation type `item`, preferrably by implementing and linking to `GET /collections/{collection_id}/items/{item_id}`.

## Response `200`

Full order information.

- Order — Information about an order. The properties with the `order:` prefix follow the fields defined in the [STAC Order Extension](https://github.com/stac-extensions/order/tree/v1.0.0).
  - `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

## Other responses

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

## Changes

- **2026-07-17** `5484a04170e2` — 1 breaking, 1 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - removed `subschema #2` from the response body `allOf` list for the response status `200`
- **2022-08-18** `08c94a3c726a` — 3 warning, 2 info
  - added the new `failed` enum value to the `allOf[subschema #1: Order]/order:status` response property for the response status `200`
  - added the new `pending` enum value to the `allOf[subschema #1: Order]/order:status` response property for the response status `200`
  - added the new `succeeded` enum value to the `allOf[subschema #1: Order]/order:status` response property for the response status `200`
  - removed the `delivered` enum value from the `allOf[subschema #1: Order]/order:status` response property for the response status `200`
  - …1 more
- **2022-08-15** `16d94ef07eec` — 1 breaking, 2 warning, 4 info
  - the response's body type/format changed from `object`/`` to ``/`` for status `200`
  - added the new `delivered` enum value to the `allOf[subschema #1: Order]/order:status` response property for the response status `200`
  - added the new `unable_to_deliver` enum value to the `allOf[subschema #1: Order]/order:status` response property for the response status `200`
  - added `subschema #2` to the response body `allOf` list for the response status `200`
  - …3 more

[Change history](https://skmtc.dev/open-eo/apis/openeo-api-commercial-data-extension/changes/orders/:order_id/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)