8Read it back

GET/api/v1/flights/bookings/{id}

Reachable with a narrow key: flight_booking

Status, record locator, ticket numbers and the hold's time limit. pending: true means paid but the numbers are not issued yet; the ticket webhook fires when they are (Webhooks). Only bookings made through the booking API answer here.

Parameters

Path

iduuidrequired

Response · 200

iduuid
The booking id.
statusenum
held waits for payment, ticketing is paid and waiting for numbers, ticketed is done; cancelled, expired and failed are closed.
one ofpendingheldawaiting_approvalticketingticketedpartially_ticketedcancelledexpiredfailed
record_locatorstring
The airline booking reference (PNR).
ticketing_time_limitdate-time
While held: ticket before this, or the hold lapses.
sale_iduuid
The sale in the agency's books.
totalstring
The sell total of the booking.
currencystring
ISO 4217 code of total.
pendingboolean
Paid, ticket numbers not issued yet. The ticket webhook fires when they are.
ticketsobject[]
One per passenger once issued.
Show fieldsHide fields
- ticket_numberstring
  The e-ticket number.
- passenger_namestring
  As printed on the ticket (SURNAME/GIVEN).

Responses

401Missing or invalid Bearer token
403The key cannot reach the booking API: the account lacks an add-on (addon_required, with details.missing), the plan has no API access, or the key's scope is narrow.
404Resource not found

curl -X GET 'https://YOUR-CELL.lydira.com/api/v1/flights/bookings/2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f' \
  -H 'Authorization: Bearer sek_YOUR_API_KEY'

const response = await fetch(
  "https://YOUR-CELL.lydira.com/api/v1/flights/bookings/2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
  {
    method: "GET",
    headers: {
      "Authorization": "Bearer sek_YOUR_API_KEY",
    },
  },
);

if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
const data = await response.json();

import requests

response = requests.get(
    "https://YOUR-CELL.lydira.com/api/v1/flights/bookings/2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
    headers={
        "Authorization": "Bearer sek_YOUR_API_KEY",
    },
)
response.raise_for_status()
data = response.json()

require "net/http"
require "json"

uri = URI("https://YOUR-CELL.lydira.com/api/v1/flights/bookings/2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer sek_YOUR_API_KEY"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { it.request(request) }
raise response.body unless response.is_a?(Net::HTTPSuccess)
data = JSON.parse(response.body)

<?php
$ch = curl_init("https://YOUR-CELL.lydira.com/api/v1/flights/bookings/2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => "GET",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer sek_YOUR_API_KEY",
    ],
]);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

Response

200

{
  "id": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
  "status": "ticketed",
  "record_locator": "ABC123",
  "ticketing_time_limit": "2026-10-08T18:00:00Z",
  "sale_id": "7e6d5c4b-3a2f-4e1d-8c0b-9a8f7e6d5c4b",
  "total": "412.50",
  "currency": "EUR",
  "pending": false,
  "tickets": [
    {
      "ticket_number": "235-1234567890",
      "passenger_name": "ARSLAN/DENIZ"
    }
  ]
}