API reference

Ticket printer

2 endpoints

The Air Printer ingest: a desktop agent watches the GDS ticketing-printer folder and POSTs each new file here, where it is parsed into a draft ticket sale. Requires a key with the ticket_import (or full) scope — the narrow one is the point, since the agent runs on a PC in an agency office.

Idempotent twice over: the same BYTES answer 200 with status: "duplicate", and so does a re-print carrying a ticket number the account already holds (a different file, same document). The agent replays its watch folder after any restart, so that is the normal case rather than the exotic one.

Recent captures

GET/api/v1/ticket_imports

Reachable with a narrow key: ticket_import

Newest first. Doubles as the agent's "test connection" probe and its "last N imported" panel; walk page.next_cursor to read back past the first page, which is what a reconnecting agent needs after an outage.

Parameters

Query

limitintegerdefault 25
Rows per page.
cursorstring
Opaque; take it from the previous response's page.next_cursor.

Response · 200

dataobject[]required
Show fieldsHide fields
- iduuid
- statusenum
  one ofparsedduplicatefailed
- providerstring
- formatstring
- filenamestringnullable
- ticket_sale_iduuidnullable
- errorstringnullable
- captured_atdate-timenullable
- created_atdate-time
- duplicate_ticket_numbersstring[]nullable
  On a ticket-grain duplicate, the document numbers this capture repeats.
pageobjectrequired
The cursor for the list beside it. Re-send the same request with ?cursor=<next_cursor> while has_more is true. next_cursor is null on the last page.
Show fieldsHide fields
- next_cursorstringrequirednullable
- has_morebooleanrequired
- limitintegerrequired

Responses

401Missing or invalid Bearer token
403The key lacks the required scope, or the plan doesn't include API access
429Rate limit exceeded

curl -X GET 'https://YOUR-CELL.lydira.com/api/v1/ticket_imports' \
  -H 'Authorization: Bearer sek_YOUR_API_KEY'

const response = await fetch(
  "https://YOUR-CELL.lydira.com/api/v1/ticket_imports",
  {
    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/ticket_imports",
    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/ticket_imports")
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/ticket_imports");
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

{
  "data": [
    {
      "id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
      "status": "parsed",
      "provider": "amadeus",
      "format": "amadeus_air",
      "filename": "voucher.pdf",
      "ticket_sale_id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
      "error": "string",
      "captured_at": "2026-03-14T09:30:00Z",
      "created_at": "2026-03-14T09:30:00Z",
      "duplicate_ticket_numbers": [
        "string"
      ]
    }
  ],
  "page": {
    "next_cursor": "MjAyNi0wMy0xNFQwOTozMDowMC4wMDAwMDBafDk0MQ",
    "has_more": true,
    "limit": 25
  }
}

Submit a printer file

POST/api/v1/ticket_imports

Reachable with a narrow key: ticket_import

201 when the file parsed into a new draft sale, 200 when it was already captured (same bytes, or a ticket number the account holds) and 422 when it could not be parsed — the capture is still recorded, so a failure is visible rather than lost.

The GDS and the format are sniffed from the CONTENT and are authoritative over any provider / format the agent sends.

Parameters

Headers

Idempotency-Keystring
Your own unique string for this write (a UUID is the obvious choice), max 255 characters. Optional: omit it and nothing changes. Send it and a repeat of the same request returns this call's response verbatim, with Idempotent-Replay: true, instead of writing again.

Body

contentstringrequired
The printer file, base64-encoded.
filenamestring
encodingstring
Source encoding
providerstring
A hint only; the content decides.
formatstring
A hint only; the content decides.
agentobject
The desktop agent's own build, for support.
Show fieldsHide fields
- versionstring
- hoststring
- osstring

Response · 200

iduuid
statusenum
one ofduplicate
providerstring
formatstring
filenamestringnullable
ticket_sale_iduuidnullable
errorstringnullable
captured_atdate-timenullable
created_atdate-time
duplicate_ticket_numbersstring[]nullable

Responses

201Parsed into a new draft ticket sale
401Missing or invalid Bearer token
403The key lacks the required scope, or the plan doesn't include API access
422The file could not be parsed; the capture is recorded anyway
429Rate limit exceeded

curl -X POST 'https://YOUR-CELL.lydira.com/api/v1/ticket_imports' \
  -H 'Authorization: Bearer sek_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90' \
  -d '{
  "content": "string",
  "filename": "AIR07.05.24.1342.0000.txt",
  "encoding": "string",
  "provider": "string",
  "format": "string",
  "agent": {
    "version": "string",
    "host": "string",
    "os": "string"
  }
}'

const response = await fetch(
  "https://YOUR-CELL.lydira.com/api/v1/ticket_imports",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sek_YOUR_API_KEY",
      "Content-Type": "application/json",
      "Idempotency-Key": "8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90",
    },
    body: JSON.stringify({
      "content": "string",
      "filename": "AIR07.05.24.1342.0000.txt",
      "encoding": "string",
      "provider": "string",
      "format": "string",
      "agent": {
        "version": "string",
        "host": "string",
        "os": "string"
      }
    }),
  },
);

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

import requests

response = requests.post(
    "https://YOUR-CELL.lydira.com/api/v1/ticket_imports",
    headers={
        "Authorization": "Bearer sek_YOUR_API_KEY",
        "Content-Type": "application/json",
        "Idempotency-Key": "8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90",
    },
    json={
      "content": "string",
      "filename": "AIR07.05.24.1342.0000.txt",
      "encoding": "string",
      "provider": "string",
      "format": "string",
      "agent": {
        "version": "string",
        "host": "string",
        "os": "string"
      }
    },
)
response.raise_for_status()
data = response.json()

require "net/http"
require "json"

uri = URI("https://YOUR-CELL.lydira.com/api/v1/ticket_imports")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer sek_YOUR_API_KEY"
request["Content-Type"] = "application/json"
request["Idempotency-Key"] = "8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90"
request.body = JSON.generate({
  content: "string",
  filename: "AIR07.05.24.1342.0000.txt",
  encoding: "string",
  provider: "string",
  format: "string",
  agent: {
    version: "string",
    host: "string",
    os: "string"
  }
})

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/ticket_imports");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => "POST",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer sek_YOUR_API_KEY",
        "Content-Type: application/json",
        "Idempotency-Key: 8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90",
    ],
    CURLOPT_POSTFIELDS     => json_encode([
        "content" => "string",
        "filename" => "AIR07.05.24.1342.0000.txt",
        "encoding" => "string",
        "provider" => "string",
        "format" => "string",
        "agent" => [
            "version" => "string",
            "host" => "string",
            "os" => "string",
        ],
    ]),
]);

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

Response

200

{
  "id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
  "status": "duplicate",
  "provider": "amadeus",
  "format": "amadeus_air",
  "filename": "voucher.pdf",
  "ticket_sale_id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
  "error": "string",
  "captured_at": "2026-03-14T09:30:00Z",
  "created_at": "2026-03-14T09:30:00Z",
  "duplicate_ticket_numbers": [
    "string"
  ]
}