Orders

Use these endpoints to create orders, check their status, and retrieve delivered content. Orders are automatically linked to the authenticated customer.

Create an order

POST /orders

Creates a new order using the balance available on your account.

Required headers

Authorization: Bearer YOUR_ACCESS_TOKEN
Accept: application/json
Content-Type: application/json
Idempotency-Key: UNIQUE_KEY

The Idempotency-Key header is required for every order creation request.

Request

curl --request POST \
  --url https://api.key2arena.com/v1/orders \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: order-123456' \
  --data '{
    "items": [
      {
        "product_id": 190,
        "quantity": 1,
        "expected_unit_price": "10.00"
      }
    ]
  }'

Request body

{
  "items": [
    {
      "product_id": 190,
      "quantity": 1,
      "expected_unit_price": "10.00"
    }
  ]
}

Field	Type	Description
`items`	array	Products included in the order
`product_id`	integer	Product ID returned by the Products endpoint
`quantity`	integer	Quantity to purchase
`expected_unit_price`	string	Unit price expected by your integration

Always use the latest price returned by the Products endpoint as expected_unit_price.

If the price or availability changes before the order is created, the request is rejected instead of purchasing at an unexpected price.

Successful response

A newly created order returns 201 Created.

{
  "data": {
    "order_number": "ORD-20261105-N6WKN9",
    "status": "paid",
    "content_available": false,
    "total": "10.00",
    "currency": "EUR",
    "created_at": "2026-11-05T16:16:25+00:00",
    "items": [
      {
        "product_id": 190,
        "name": "Example Game",
        "platform": "Steam",
        "region": "Global",
        "quantity": 1,
        "delivered_quantity": 0,
        "cancelled_quantity": 0,
        "unit_price": "10.00",
        "fulfillment_status": "processing"
      }
    ]
  }
}

content_available is true when at least one delivered item is available to retrieve.

Idempotency

Every POST /orders request must include a unique Idempotency-Key. This prevents duplicate purchases when a request is retried because of a timeout or network issue.

Same key and same request

Sending the same request again with the same key returns the original order.

200 OK
Idempotent-Replayed: true

The account is not charged again and no duplicate order is created.

Same key and different request

Reusing the same key with different order data returns a conflict.

409 Conflict

{
  "error": {
    "code": "idempotency_conflict",
    "message": "This Idempotency-Key has already been used for a different request.",
    "request_id": "req_..."
  }
}

Use a new Idempotency-Key for every new order.

List orders

GET /orders

Returns orders created by the authenticated customer.

Request

curl --request GET \
  --url https://api.key2arena.com/v1/orders \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Response

{
  "data": [
    {
      "order_number": "ORD-20261105-N6WKN9",
      "status": "delivered",
      "total": "10.00",
      "currency": "EUR",
      "created_at": "2026-11-05T16:16:25+00:00"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 25,
    "total": 1
  }
}

Get an order

GET /orders/{order_number}

Returns the latest details and fulfillment status for a specific order.

Request

curl --request GET \
  --url https://api.key2arena.com/v1/orders/ORD-20261105-N6WKN9 \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Response

{
  "data": {
    "order_number": "ORD-20261105-N6WKN9",
    "status": "delivered",
    "content_available": true,
    "total": "10.00",
    "currency": "EUR",
    "created_at": "2026-11-05T16:16:25+00:00",
    "items": [
      {
        "product_id": 190,
        "name": "Example Game",
        "platform": "Steam",
        "region": "Global",
        "quantity": 1,
        "delivered_quantity": 1,
        "cancelled_quantity": 0,
        "unit_price": "10.00",
        "fulfillment_status": "delivered"
      }
    ]
  }
}

Order content

GET /orders/{order_number}/content

Returns delivered keys or other product content for an order. Use this endpoint when content_available is true.

Request

curl --request GET \
  --url https://api.key2arena.com/v1/orders/ORD-20261105-N6WKN9/content \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Response

{
  "data": {
    "order_number": "ORD-20261105-N6WKN9",
    "status": "delivered",
    "content": [
      {
        "product_id": 190,
        "name": "Example Game",
        "units": [
          {
            "value": "AAAAA-BBBBB-CCCCC",
            "additional_values": []
          }
        ]
      }
    ]
  }
}

Content fields

Field	Description
`product_id`	Product associated with the delivered content
`name`	Product name
`units`	Delivered units
`value`	Primary key or delivered value
`additional_values`	Additional values when provided for the product (Extra or Bundle Key)

Content may not be available immediately.
Check the order status before requesting delivered content.

Order status

status represents the overall order status.

Status	Description
`processing`	The order is being processed
`paid`	Payment has been confirmed
`awaiting_release`	The order is waiting for the product release or availability
`partially_delivered`	Part of the order has been delivered
`delivered`	All available content has been delivered
`canceled`	The order was canceled
`failed`	The order could not be completed

Item fulfillment status

Each order item has its own fulfillment_status.

{
  "quantity": 3,
  "delivered_quantity": 2,
  "cancelled_quantity": 0,
  "fulfillment_status": "partially_delivered"
}

Status	Description
`pending`	The item is waiting to be processed
`processing`	The item is being processed
`awaiting_release`	The item is waiting for release or availability
`partially_delivered`	Part of the requested quantity has been delivered
`delivered`	The requested quantity has been delivered
`failed`	The item could not be fulfilled

fulfillment_status applies to each individual item, while the order-level status represents the overall order state. This allows to track fulfillment independently for each product in a multi-item order.

Delivery behavior

Delivery depends on the product’s current delivery_type.

Delivery type	Behavior
`instant`	Fulfillment can begin immediately after the order is accepted
`preorder`	Delivery occurs when the product becomes available for release
`upon_request`	Availability is confirmed before fulfillment. Delivery may take up to 24 hours.

The latest delivery type and availability should always be retrieved from the Products endpoint before creating an order.

Insufficient balance

If the account does not have enough available balance, the order is rejected.

{
  "error": {
    "code": "insufficient_balance",
    "message": "Insufficient available balance.",
    "request_id": "req_..."
  }
}

No order is created and the account is not charged.

Required scopes

Creating orders requires:

orders:create

Reading orders and delivered content requires:

orders:read

A typical ordering integration requests:

products:read orders:read orders:create balance:read

Order creation notes

Idempotency-Key is required for every POST /orders request.

Use the latest price returned by the Products endpoint as expected_unit_price.
Prices must be sent as strings with two decimal places, for example "10.00".
If the price or availability changes before the order is created, the request is rejected.
Reusing the same Idempotency-Key with the same request returns the original order without charging again.
Reusing the same Idempotency-Key with different order data returns an idempotency_conflict.
Delivered content should be requested only when content_available is true.

Getting Started

API Reference

Guides

Create an order

Required headers

Request

Request body

Successful response

Idempotency

Same key and same request

Same key and different request

List orders

Request

Response

Get an order

Request

Response

Order content

Request

Response

Content fields

Order status

Item fulfillment status

Delivery behavior

Insufficient balance

Required scopes

Order creation notes

​Create an order

​Required headers

​Request

​Request body

​Successful response

​Idempotency

​Same key and same request

​Same key and different request

​List orders

​Request

​Response

​Get an order

​Request

​Response

​Order content

​Request

​Response

​Content fields

​Order status

​Item fulfillment status

​Delivery behavior

​Insufficient balance

​Required scopes

​Order creation notes

Create an order

Required headers

Request

Request body

Successful response

Idempotency

Same key and same request

Same key and different request

List orders

Request

Response

Get an order

Request

Response

Order content

Request

Response

Content fields

Order status

Item fulfillment status

Delivery behavior

Insufficient balance

Required scopes

Order creation notes