Skip to content

Get Order ​

Returns the live state of a previously created order — the same Order shape as Create Order, with the current status and per-ticket details. This is a safe, idempotent read used to reconcile an order against the provider after create/confirm/cancel (e.g. detecting a provider-side cancellation).

Endpoint ​

Method: GET

URL: /v1/order/{order_id}

Request Headers ​

ParameterTypeRequiredDescription
AuthorizationStringYesBearer <token> from Login

Path Parameters ​

ParameterTypeRequiredDescription
order_idStringYesProvider order id (Order.id returned by Create Order)

Query Parameters ​

ParameterTypeRequiredDescription
localeStringNoLocalises any human-readable fields, refer to Locale List

Response Parameters ​

The response is identical in shape to Create Order: an order object with its current status and tickets.

Response Example ​

json
{
  "order": {
    "id": "ord_7c01",
    "agentorder_id": "TTN-100245",
    "status": "paid",
    "currency": "UAH",
    "tickets": [
      {
        "number": "TKT-555001",
        "code": "BK-9931",
        "passenger_index": 0,
        "seat": "12A",
        "price": 650.0,
        "currency": "UAH",
        "status": "paid"
      }
    ]
  }
}

Error Code List ​

codemessageDescription
UNAUTHORIZEDInvalid tokenThe bearer token is missing, invalid, or expired (401).
NOT_FOUNDOrder not foundNo order exists for the supplied order_id.

TTN Octo API documentation