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
| Parameter | Type | Required | Description |
|---|---|---|---|
| Authorization | String | Yes | Bearer <token> from Login |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| order_id | String | Yes | Provider order id (Order.id returned by Create Order) |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| locale | String | No | Localises 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
| code | message | Description |
|---|---|---|
| UNAUTHORIZED | Invalid token | The bearer token is missing, invalid, or expired (401). |
| NOT_FOUND | Order not found | No order exists for the supplied order_id. |