---
title: "Get order information"
method: GET
path: "/orders/{orderReferenceId}"
tags: ["Booking API"]
---

# Get order information

`GET /orders/{orderReferenceId}`

## Path parameters

- `orderReferenceId` string, required

## Query parameters

- `lang` string
- `external` boolean

## Headers

- `Authorization` string, required

## Response `200`

Successful operation.

- object
  - `product_id` integer — ID of the booked product.
  - `promoted_product_id` integer, nullable — Only applicable for products that aggregate the availability of a group of products. The `promoted_product_id` is the ID that was originally promoted while the actually booked product is different.
  - `order_reference_id` string — Order reference ID of the order.
  - `basket_reference_id` string — Basket reference ID of the order.
  - `day` string, date, nullable — Booked visit date.
  - `timeslot` string, nullable — Booked timeslot at the given visit date.
  - `variants` object[] — Variants included in this order.
    - `count` integer — Number of tickets for this variant.
    - `variant_id` integer — Variant ID.
  - `customer_details` CustomerDetailsResponse, nullable — Customer details as provided during order creation. Please note that customer details are only returned up to one year after the visit date. For orders with a visit date further in the past, the object is returned as `null`.
    - `firstname` string — Customer's first name.
    - `lastname` string — Customer's last name.
    - `email` string — Customer's email address.
    - `phone` string — Customer's phone number as provided during order creation.
  - `order_status` string — 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.
  - `is_currently_cancellable` boolean — Indicates if the order is currently eligible for cancellation.
  - `cancellation_deadline` string, nullable — The latest timestamp allowed for the order cancellation. Only returned if the value of `is_currently_cancellable` is `true`. Format ISO_8601 YYYY-MM-DDTHH:MM:SS±HH:MM.
  - `price_components_eur` PriceComponentMediationInEUR, nullable — Order pricing details in EUR.
    - `sale_ticket_value_incl_vat` number — Sale tickets value, including VAT. Sum of `sale_ticket_value_incl_vat` of all the tickets in the order.
    - `booking_fee_incl_vat` number — Booking fee, including VAT.
    - `sale_order_value__incl_vat` number — Sale order value, including VAT. Sum of `sale_ticket_value_incl_vat` and `booking_fee_incl_vat` of all the tickets in the order.
    - `distributor_commission_excl_vat` number — Total distributor commission of the order, excluding VAT.
  - `price_components` PriceComponentMediation, nullable — Order pricing details in the distributor's invoicing currency.
    - `sale_ticket_value_incl_vat` number — Sale tickets value, including VAT. Sum of `sale_ticket_value_incl_vat` of all the tickets in the order.
    - `booking_fee_incl_vat` number — Booking fee, including VAT.
    - `sale_order_value__incl_vat` number — Sale order value, including VAT. Sum of `sale_ticket_value_incl_vat` and `booking_fee_incl_vat` of all the tickets in the order.
    - `distributor_commission_excl_vat` number — Total distributor commission of the order, excluding VAT.
    - `currency` string — Currency code (ISO 4217) for the existing amounts.
    - `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.
  - `external_reference` string, nullable — External order ID as provided upon order creation API request. Unique, maximum 255 characters
  - `expected_ticket_delivery_date` string, date, nullable — The date on which the tickets will be expected to be delivered. Relevant when ticket_delivery != direct_via_tiqets_api

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