Ticket a hold

POST

/v1/flights/bookings/:id/ticket

POST

/v1/flights/bookings/:id/ticket

curl -X POST https://sandbox-api.kitionz.com/v1/flights/bookings/bkg_034nVJTkDsCsHQZf293Bgq/ticket \
     -H "Idempotency-Key: replace-with-a-new-uuid-held-booking-ticketed" \
     -H "Authorization: Bearer <token>"

200Successful

{
  "success": true,
  "statusCode": 200,
  "data": {
    "id": "bkg_034nVJTkDsCsHQZf293Bgq",
    "supplierCode": "kitionz_test_air",
    "seller": {
      "name": "Kitionz Test Air",
      "website": null,
      "supportPhone": null,
      "supportEmail": null
    },
    "environment": "SANDBOX",
    "status": "CONFIRMED",
    "bookingMode": "LIVE",
    "bookingChannel": "API",
    "supplierReference": "SIM-HOLD-1793152939-3MRXK4LPRP",
    "pnr": "TESTXSAFXQ",
    "ticketingTimeLimit": "2026-10-29T02:02:19.000Z",
    "booker": {
      "name": "Raj Kumar",
      "email": "raj@example-agency.in",
      "phone": "+919800000000"
    },
    "passengers": [
      {
        "id": "bkgpax_034nVJTmkvreqyRklsf7d2",
        "passengerIndex": 0,
        "title": "MR",
        "firstName": "Raj",
        "lastName": "Kumar",
        "passengerType": "ADULT",
        "dateOfBirth": null,
        "dateOfBirthDefaulted": true,
        "passportNumber": null,
        "passportIssueDate": null,
        "passportExpiryDate": null,
        "nationality": null,
        "passportIssuingCountry": null,
        "gender": "MALE",
        "guardianPassengerIndex": null,
        "wheelChair": false,
        "perPaxStatus": null,
        "perPaxAmount": null,
        "travelerType": "ADULT",
        "guardian": null
      }
    ],
    "segments": [
      {
        "id": "bkgseg_034nVJTn96nGEIbG6riJAU",
        "segmentIndex": 0,
        "legType": "OUTBOUND",
        "legIndex": 0,
        "marketingCarrier": {
          "iataCode": "ZZ",
          "name": "Zz",
          "flightNumber": "108"
        },
        "origin": {
          "iataCode": "DEL",
          "name": "Indira Gandhi International Airport",
          "city": "New Delhi",
          "countryCode": "IN",
          "timezone": "Asia/Kolkata"
        },
        "destination": {
          "iataCode": "BOM",
          "name": "Chhatrapati Shivaji Maharaj International Airport",
          "city": "Mumbai",
          "countryCode": "IN",
          "timezone": "Asia/Kolkata"
        },
        "departureTime": "2026-11-30T17:30:00+05:30",
        "arrivalTime": "2026-11-30T19:40:00+05:30",
        "technicalStops": [],
        "unnamedStops": 0,
        "layoverAfterMinutes": null,
        "departureTerminal": "3",
        "arrivalTerminal": "2",
        "cabin": null,
        "airlineCode": "ZZ",
        "airlineName": "Zz",
        "flightNumber": "108",
        "originCode": "DEL",
        "originName": "Indira Gandhi International Airport",
        "destCode": "BOM",
        "destName": "Chhatrapati Shivaji Maharaj International Airport",
        "departureTimezone": "Asia/Kolkata",
        "arrivalTimezone": "Asia/Kolkata",
        "originTerminal": "3",
        "destinationTerminal": "2",
        "cabinClass": null
      }
    ],
    "events": [
      {
        "id": "bkgevent_034nVJTxrz4ZzhMuwOyDae",
        "eventType": "ISSUE_TICKET_CONFIRMED",
        "status": "SUCCESS",
        "errorCode": null,
        "errorMessage": null,
        "createdAt": "2026-10-28T02:02:19.704Z"
      },
      {
        "id": "bkgevent_034nVJTnR7cWcKWJ5pIXD6",
        "eventType": "FARE_RECHECK_PASSED",
        "status": "SUCCESS",
        "errorCode": null,
        "errorMessage": null,
        "createdAt": "2026-10-28T02:02:19.597Z"
      },
      {
        "id": "bkgevent_034nVJTnR6Qn9WqjmYGuPi",
        "eventType": "BOOK_HELD",
        "status": "SUCCESS",
        "errorCode": null,
        "errorMessage": null,
        "createdAt": "2026-10-28T02:02:19.597Z"
      }
    ],
    "adults": 1,
    "children": 0,
    "infants": 0,
    "departureDate": "2026-11-30",
    "returnDate": null,
    "tripType": "ONE_WAY",
    "origin": {
      "iataCode": "DEL",
      "name": "Indira Gandhi International Airport",
      "city": "New Delhi",
      "countryCode": "IN",
      "timezone": "Asia/Kolkata"
    },
    "destination": {
      "iataCode": "BOM",
      "name": "Chhatrapati Shivaji Maharaj International Airport",
      "city": "Mumbai",
      "countryCode": "IN",
      "timezone": "Asia/Kolkata"
    },
    "price": {
      "totalAmount": 6124,
      "currency": "INR",
      "baseFare": null,
      "taxes": null,
      "commission": null,
      "tds": null,
      "netPayable": null,
      "publishedTotal": null,
      "publishedBaseFare": null,
      "publishedTaxes": null,
      "taxBreakdown": [],
      "commercials": [],
      "passengerFares": [
        {
          "passengerType": "ADULT",
          "count": 1,
          "perPerson": 6124,
          "total": 6124,
          "baseFare": null,
          "taxes": null
        }
      ],
      "infantFare": null
    },
    "quotedTotalAmount": 6124,
    "reconciliation": {
      "inSync": null,
      "supplierDataAvailable": false,
      "diffs": []
    },
    "baggage": {
      "perPax": [
        {
          "paxType": "ADT",
          "checkIn": {
            "weightKg": 15
          },
          "cabin": {
            "weightKg": 7
          }
        }
      ]
    },
    "policy": {
      "refundBeforeDeparture": {
        "allowed": null
      },
      "changeBeforeDeparture": {
        "allowed": null
      },
      "refund": "NOT_GIVEN",
      "change": "NOT_GIVEN",
      "refundPolicy": "NOT_GIVEN",
      "changePolicy": "NOT_GIVEN"
    },
    "externalReference": null,
    "failure": null,
    "nextAction": {
      "code": "NONE",
      "description": "Nothing to do: the booking is confirmed.",
      "method": null,
      "path": null,
      "pollAfterSeconds": null,
      "deadlineAt": null
    },
    "bookedAt": "2026-10-28T02:02:19.584Z",
    "createdAt": "2026-10-28T02:02:19.568Z",
    "updatedAt": "2026-10-28T02:02:19.696Z",
    "sourceCode": "kitionz_test_air",
    "supplier": {
      "name": "Kitionz Test Air",
      "website": null,
      "supportPhone": null,
      "supportEmail": null
    },
    "returnSupplier": null,
    "originCode": "DEL",
    "destCode": "BOM",
    "totalAmount": 6124,
    "currency": "INR",
    "fareBreakdown": {
      "tenantTotal": 6124,
      "currency": "INR",
      "composition": {
        "baseFare": null,
        "taxes": null,
        "commission": null,
        "tds": null,
        "netPayable": null
      },
      "published": {
        "baseFare": null,
        "taxes": null,
        "total": null
      },
      "taxComponents": [],
      "commercials": [],
      "perPax": [
        {
          "paxType": "ADT",
          "count": 1,
          "perHeadTotal": 6124,
          "baseFare": null,
          "totalTax": null
        }
      ]
    },
    "cabin": null
  },
  "meta": {
    "requestId": "req_034nVJTtyIx08IjukoFHai",
    "timestamp": "2026-10-28T02:02:19.759Z",
    "path": "/v1/flights/bookings/bkg_034nVJTkDsCsHQZf293Bgq/ticket",
    "method": "POST"
  }
}

Ticket a HELD booking.

Only Kitionz Test Air supports this today. With your Live suppliers this call is refused, so build it in Test but do not depend on it in Live yet.

What: issues the ticket for a HELD booking (the seats are held, not yet ticketed).

When: when the booking’s nextAction.code is ISSUE_TICKET, before nextAction.deadlineAt.

Answers: 200 with the booking once ticketed (asking again for a CONFIRMED booking also answers 200, with no supplier call). 202 when the supplier accepted the ticketing but it is not done yet: read the booking later. 409 BOOKING_NOT_TICKETABLE when the booking is not on hold. 422 TICKETING_REFUSED when the supplier said no: it stays HELD. Carries the Idempotency-Key header like any write.

Authentication

AuthorizationBearer

Your Kitionz API key, sent as Authorization: Bearer keyId:secret. Create a Test key at sandbox.kitionz.com → API keys, a Live key at kitionz.com → API → API keys.

Path parameters

idstringRequired

Response

Default Response

successboolean

statusCodedouble

dataobject

A full persisted booking (passengers, segments, events, amounts, status).

metaobject

Authentication

Path parameters

Headers

Response