---
title: "List orders"
method: GET
path: "/orders"
tags: ["Booking API"]
---

# List orders

`GET /orders`

## Query parameters

- `page_size` integer
- `page` integer
- `start_date` string, date
- `end_date` string, date

## Headers

- `Authorization` string, required

## Response `200`

Successful operation.

- object
  - `success` boolean
  - `pagination` Pagination
    - `total` integer — Total number of items.
    - `page` integer — Number of the current page.
    - `page_size` integer — Size of the current page.
  - `order` Order[], nullable
    - `external_reference` string, nullable — Partner's order reference ID as provided upon order creation through Booking API. Unique, maximum 255 characters. Not applicable for non-Booking API orders.
    - `order_reference_id` string — Order reference ID of the order.
    - `basket_reference_id` string — Basket reference ID of the order.
    - `product_id` integer — ID of the product.
    - `order_date` string, date — Date when the order was created. Always follows 'Europe/Amsterdam' timezone. It is recommended to prefer `order_created_timestamp` for the exact timestamp of the order creation.
    - `order_created_timestamp` string, date-time — Date and time when the order was created formatted according to ISO-8601 standard. Always follows UTC timezone.
    - `visit_date` string, date, nullable — Visit date selected by the guest during or after the order process. Can be null if the visit date has not been selected yet.
    - `number_of_tickets` integer — Total number of tickets in the order.
    - `sale_order_value` number — Sale order value (excluding VAT) which is the sum of all the tickets value in the order.
    - `estimated_commission` number, nullable — Estimated total distributor commission of the order (excluding VAT).
    - `estimated_partner_rate` number, nullable — As an intermediary of Tiqets, you receive a partner commission for your services in accordance with your partner contract. The Estimated Partner Rate is merely displayed to indicate the estimated difference between the ticket retail price (including VAT) and your estimated partner commission (excluding VAT). No rights can be derived from this estimation. The terms of your partner contract shall prevail and take precedence in all cases.
    - `currency` string — Currency code (ISO 4217) for the existing amounts. The returned currency follows the invoice currency.
    - `sitebrand` string, nullable — Name of partner's co-branded version of Tiqets.com.
    - `source_tool` 'affiliate_link' | 'discovery_widget' | 'availability_widget' | 'booking_widget', nullable — Affiliate tool used by user to create the order. This entire field and value will be omitted if the order was created through the Booking API.
    - `campaign_name` string, nullable — Partner's campaign name. Only applicable for non-Booking API orders.
    - `click_id` string, nullable — Partner's click ID. Only applicable for non-Booking API orders.
    - `order_type` 'REGULAR' | 'BUNDLE' | 'COMBI_DEAL' | 'PACKAGE' — The order type: * Regular: Order consisting of a single product. * Bundle: Order consisting of different products combined together with a discount. * Combi deal: Order of a product with additional products selected to be bought together with a discount during the order proces. * Package: Order of a predefined package which consists of different products with a discount on the total price.
    - `order_status` 'new' | 'pending' | 'failed' | 'done' | 'cancelled' — The order status, as one of the following values: * new: Order was created, but not yet confirmed or paid. * pending: Order was confirmed or paid, and the tickets are still being processed. * failed: Order was not paid or the ticket processing failed. * done: Order was completed and PDF tickets have been generated. * cancelled: Order was cancelled after it had been completed.

## Other responses

- `400` — Bad Request -- Check your request parameters (typo in parameter or invalid value).
- `401` — Unauthorized -- Your API key is incorrect.
- `403` — Forbidden -- The endpoint or parameters are not allowed for the matching API key.
- `404` — Not Found -- Requested resource/endpoint could not be found.
- `405` — Method Not Allowed -- Check your request method.
- `429` — Too Many Requests -- We currently apply a fair-use policy, but we might enforce limits in the future.
- `500` — Internal Server Error -- We had a problem with our server. Try again later.
- `503` — Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

---

[API](https://skmtc.net/tiqets/apis/tiqets-distributor-api.md) · [All operations](https://skmtc.net/tiqets/apis/tiqets-distributor-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tiqets/tiqets-distributor-api/versions/eaf9cf96606a/schema)