---
title: "Retrieve tickets"
method: GET
path: "/orders/{orderReferenceId}/tickets"
tags: ["Booking API"]
---

# Retrieve tickets

`GET /orders/{orderReferenceId}/tickets`

## Path parameters

- `orderReferenceId` string, required

## Query parameters

- `lang` string

## Headers

- `Authorization` string, required

## Response `200`

Successful operation.

- object
  - `success` boolean
  - `order_reference_id` string — Unique order reference ID.
  - `order_status` 'new' | 'pending' | 'failed' | 'done' | 'cancelled' — The order status, as one of the following values: * new: Order is successfully created in Tiqets but not yet confirmed by the distributor. * pending: Order is confirmed; Tiqets is currently working on the fulfilment. * failed: Order fulfilment failed. * done: Order is fulfilled and the PDF tickets are ready. * cancelled: A previously fulfilled order has been cancelled.
  - `how_to_use_info` string, nullable — Instructions of how to use the tickets. Also displayed on the voucher.
  - `post_purchase_info` string, nullable — Post-purchase information.
  - `tickets_pdf_url` string, nullable — URL to PDF document with the tickets. Language on the voucher follows order language as defined at order creation. Value is `null` unless the order_status is `done`.
  - `must_know` string, nullable — Important information. Also displayed on the voucher.
  - `pre_purchase` string, nullable — Pre-purchase information.
  - `good_to_know` string, nullable — Additional information.
  - `included` string, nullable — Description of what is included in the ticket.
  - `excluded` string, nullable — Description of what is explicitly not included in the ticket.
  - `has_timeslots` boolean, nullable — Indicates whether the product has timeslots.
  - `has_dynamic_pricing` boolean — Indicates whether the product has dynamic pricing.
  - `customer_data_required_on_create_order` boolean — This element can be ignored and is only returned for compatibility with legacy integrations. Always `true`.
  - `starting_point_address` string, nullable — Address of the starting point.
  - `starting_point_latitude` number, nullable — Latitude of the starting point.
  - `starting_point_longitude` number, nullable — Longitude of the starting point.
  - `starting_point_city_id` integer, nullable — Tiqets city ID of the starting point.

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