---
title: "Create a new order"
method: POST
path: "/orders"
tags: ["Orders"]
---

# Create a new order

`POST /orders`

Create an order for selected items (products).

When an order is created through through this endpoint, the data isn't yet ordered from the commercial data provider. The client MUST explicitly confirm the order through `POST /orders/{order_id}` whereupon the order is executed.

The order can contain additional parameters that specify how the items should be delivered.
For example, it might be possible to set the projection, resampling method, bit depth etc. of the delivered data.

Back-ends SHOULD expose the available ordering parameters in `GET /collections/{collection_id}` in the `order_parameters` field, following the `process_parameters` schema of [`GET /service_types`](https://openeo.org/documentation/1.0/developers/api/reference.html#tag/Secondary-Services/operation/list-service-types). 

Returns `Location` and `OpenEO-Identifier` header with the link to the detailed information about the order.

## Request body

- object
  - `source_collection_id` string, required — Unique identifier of the collection.
  - `items` OrderId[], required — Array of items IDs to order.
  - `parameters` OrderParameters, required — Key-value pairs of available `order_parameters` as listed at `GET /collections/{collection_id}` for filtering available items.

## Response `201`

The order has been created successfully.

## Other responses

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

---

[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)