Get Orders

Get Orders

get

Rate limit: 100 requests per minute

Authorizations

APIKeyAuth

X-API-KeystringRequired

Query parameters

order_numberany ofOptional

Order number to search for.

stringOptional

or

nullOptional

customer_keyany ofOptional

Customer key to search for.

stringOptional

or

nullOptional

carrier_keyany ofOptional

Carrier key of the order to filter by. Available carrier keys can be retrieved from the Carrier model (active carriers only).

stringOptional

or

nullOptional

shop_countryany ofOptional

Shop country to search for.

stringOptional

or

nullOptional

order_statusany ofOptional

Status of the order to filter by. Choose from: "open", "shipped", "cancelled", "returned", "mixed".

string · enumOptionalPossible values:

or

nullOptional

order_item_statusany ofOptional

Status of the order item to filter by. Choose from: "open", "shipped", "cancelled", "returned".

string · enumOptionalPossible values:

or

nullOptional

orders_fromany ofOptional

Orders from date to filter by.

string · date-timeOptional

or

nullOptional

orders_toany ofOptional

Orders to date to filter by.

string · date-timeOptional

or

nullOptional

fulfillment_typeany ofOptional

Fulfillment type to filter by.

string · enumOptionalPossible values:

or

nullOptional

pageinteger · min: 1Optional

Page number to retrieve items from.

Default: 1

per_pageinteger · min: 1 · max: 100Optional

Number of items per page.

Default: 20

Responses

200

OK

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

default

get

/api/v1/orders/

HTTPcURLJavaScriptPython

GET /api/v1/orders/ HTTP/1.1
Host: 
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "items": [
    {
      "order_items": [
        {
          "return_tracking_key": "text",
          "shipment_tracking_key": "text",
          "sku": "text",
          "status": "open",
          "id": 1,
          "vat": 19,
          "price_without_tax": 1,
          "price_with_tax": 1,
          "custom_data": {}
        }
      ],
      "order_number": "text",
      "carrier_key": "text",
      "delivery_document_url": "text",
      "status": "open",
      "customer_key": "text",
      "shop": 1,
      "created_at": "2025-12-12T08:03:34.527Z",
      "updated_at": "2025-12-12T08:03:34.527Z",
      "fulfillment_type": "dropshipping",
      "custom_data": {},
      "payment_method": "text",
      "billing_street": "text",
      "billing_zip_code": "text",
      "billing_city": "text",
      "billing_country_code": "text",
      "billing_recipient_gender": "text",
      "billing_recipient_first_name": "text",
      "billing_recipient_last_name": "text",
      "billing_additional": "text",
      "shipping_street": "text",
      "shipping_zip_code": "text",
      "shipping_city": "text",
      "shipping_country_code": "text",
      "shipping_additional": "text",
      "shipping_collection_point_key": "text",
      "shipping_collection_point_type": "text",
      "shipping_collection_point_customer_key": "text",
      "shipping_collection_point_description": "text",
      "shipping_recipient_gender": "text",
      "shipping_recipient_first_name": "text",
      "shipping_recipient_last_name": "text",
      "currency_code": "text",
      "cost_without_tax": 1,
      "cost_with_tax": 1
    }
  ],
  "pagination": {
    "per_page": 1,
    "page": 1,
    "pages": 1,
    "total": 1,
    "next": "text",
    "prev": "text"
  }
}