---
title: "Get Orders"
method: GET
path: "/api/v1/orders/"
tags: ["Orders"]
---

# Get Orders

`GET /api/v1/orders/`

**Rate limit:** 100 requests per minute

## Query parameters

- `order_number` string, nullable — Order number to search for.
- `customer_key` string, nullable — Customer key to search for.
- `carrier_key` string, nullable — Carrier key of the order to filter by. Available carrier keys can be retrieved from the Carrier model (active carriers only).
- `shop_country` string, nullable — Shop country to search for.
- `order_status` 'open' | 'shipped' | 'cancelled' | 'returned' | 'mixed'
- `order_item_status` 'open' | 'shipped' | 'cancelled' | 'returned'
- `orders_from` string, date-time, nullable — Orders from date to filter by.
- `orders_to` string, date-time, nullable — Orders to date to filter by.
- `fulfillment_type` 'dropshipping' | 'fulfillment_by_marketplace'
- `page` integer — Page number to retrieve items from.
- `per_page` integer — Number of items per page.
- `cursor` string, nullable — Opaque cursor from previous response for cursor-based pagination. When provided, omit page or use page=1.

## Response `200`

OK

- PagedGetOrderSchema
  - `items` GetOrderSchema[], required
    - `order_items` OrderItemSchema[], required — List of order items
      - `return_tracking_key` string, nullable, required
      - `shipment_tracking_key` string, nullable, required
      - `sku` string, required — SKU of the product variant
      - `status` 'open' | 'shipped' | 'cancelled' | 'returned', required
      - `id` integer, nullable
      - `vat` number — The tax percentage
      - `price_without_tax` integer, required — Price of the product excluding tax in the smallest currency unit (e.g. cents for Euro)
      - `price_with_tax` integer, required — Price of the product including tax in the smallest currency unit (e.g. cents for Euro)
    - `order_number` string, required — Order number of the order
    - `carrier_key` string, required — Carrier key from the Carrier model.
    - `cost_without_tax` integer, required — Cost of the order without tax in the smallest currency unit (e.g. cents for Euro)
    - `cost_with_tax` integer, required — Cost of the order with tax in the smallest currency unit (e.g. cents for Euro)
    - `delivery_document_url` string, required
    - `status` 'open' | 'shipped' | 'cancelled' | 'returned' | 'mixed', required
    - `customer_key` string, required — Reference key of the customer (MAPI: customer_key)
    - `shop` integer, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `fulfillment_type` string — Fulfillment type
    - `payment_method` string, nullable — Payment method
    - `billing_street` string, required — Billing address
    - `billing_zip_code` string, required — Billing zip code
    - `billing_city` string, required — Billing city
    - `billing_country_code` string, required — Billing country code
    - `billing_recipient_gender` string, nullable — Gender of the recipient
    - `billing_recipient_first_name` string, required — First name of the recipient
    - `billing_recipient_last_name` string, required — Last name of the recipient
    - `billing_additional` string, nullable — Additional billing information
    - `shipping_street` string, nullable — Shipping address
    - `shipping_zip_code` string, nullable — Shipping zip code
    - `shipping_city` string, nullable — Shipping city
    - `shipping_country_code` string, nullable — Shipping country
    - `shipping_additional` string, nullable — Additional shipping information
    - `shipping_collection_point_key` string, nullable — Shipping collection point key
    - `shipping_collection_point_type` string, nullable — Shipping collection point type
    - `shipping_collection_point_description` string, nullable — Shipping collection point description
    - `customer_phone` string, nullable — Customer phone number for collection point delivery notifications
    - `customer_email` string, nullable — Customer email address for collection point delivery notifications
    - `shipping_recipient_gender` string, nullable — Gender of the recipient
    - `shipping_recipient_first_name` string, required — First name of the recipient
    - `shipping_recipient_last_name` string, required — Last name of the recipient
    - `currency_code` string, required — Currency code
  - `pagination` Pagination, required
    - `per_page` integer, required — Number of items per page.
    - `page` integer, nullable — Page number (null in cursor mode).
    - `pages` integer, nullable — Total pages (null in cursor mode).
    - `total` integer, nullable — Total count (null in cursor mode).
    - `next` string, nullable — URL for next page (null in cursor mode).
    - `prev` string, nullable — URL for previous page (null in cursor mode).
    - `next_cursor` string, nullable — Opaque cursor for next page when using cursor-based pagination.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `default`

---

[API](https://skmtc.dev/aboutyou/apis/sellers-center-api.md) · [All operations](https://skmtc.dev/aboutyou/apis/sellers-center-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aboutyou/sellers-center-api/revisions/578d18d6e63c/schema)