Poll status

GET

/v1/flights/bookings/:id/status

GET

/v1/flights/bookings/:id/status

curl https://sandbox-api.kitionz.com/v1/flights/bookings/bkg_034nVJSR1PGFZYW9sYEu7h/status \
     -H "Authorization: Bearer <token>"

200Retrieved

{
  "success": true,
  "statusCode": 200,
  "data": {
    "state": "CONFIRMED",
    "pnr": "TESTERYVTQ",
    "supplierReference": "SIM-CONFIRM-1793152938-ASG179D0LO",
    "retryAfterSeconds": null,
    "message": null,
    "booking": {
      "id": "bkg_034nVJSR1PGFZYW9sYEu7h",
      "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-CONFIRM-1793152938-ASG179D0LO",
      "pnr": "TESTERYVTQ",
      "ticketingTimeLimit": null,
      "booker": {
        "name": "Raj Kumar",
        "email": "raj@example-agency.in",
        "phone": "+919800000000"
      },
      "passengers": [
        {
          "id": "bkgpax_034nVJSUot0o8bxi6gfFx9",
          "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_034nVJSVJGMBWziK3OEgRk",
          "segmentIndex": 0,
          "legType": "OUTBOUND",
          "legIndex": 0,
          "marketingCarrier": {
            "iataCode": "ZZ",
            "name": "Zz",
            "flightNumber": "100"
          },
          "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-30T05:30:00+05:30",
          "arrivalTime": "2026-11-30T07:40:00+05:30",
          "technicalStops": [],
          "unnamedStops": 0,
          "layoverAfterMinutes": null,
          "departureTerminal": "3",
          "arrivalTerminal": "2",
          "cabin": null,
          "airlineCode": "ZZ",
          "airlineName": "Zz",
          "flightNumber": "100",
          "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_034nVJTDlB0qufeWEpxsKM",
          "eventType": "TRACK_STATUS_CONFIRMED",
          "status": "SUCCESS",
          "errorCode": null,
          "errorMessage": null,
          "createdAt": "2026-10-28T02:02:19.231Z"
        },
        {
          "id": "bkgevent_034nVJSVhRfW0tfm6X1aET",
          "eventType": "FARE_RECHECK_PASSED",
          "status": "SUCCESS",
          "errorCode": null,
          "errorMessage": null,
          "createdAt": "2026-10-28T02:02:18.779Z"
        },
        {
          "id": "bkgevent_034nVJSVhGUAqLWGLVbC0m",
          "eventType": "BOOK_CONFIRMED",
          "status": "SUCCESS",
          "errorCode": null,
          "errorMessage": null,
          "createdAt": "2026-10-28T02:02:18.779Z"
        }
      ],
      "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": 5324,
        "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": 5324,
            "total": 5324,
            "baseFare": null,
            "taxes": null
          }
        ],
        "infantFare": null
      },
      "quotedTotalAmount": 5324,
      "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:18.759Z",
      "createdAt": "2026-10-28T02:02:18.735Z",
      "updatedAt": "2026-10-28T02:02:19.227Z",
      "sourceCode": "kitionz_test_air",
      "supplier": {
        "name": "Kitionz Test Air",
        "website": null,
        "supportPhone": null,
        "supportEmail": null
      },
      "returnSupplier": null,
      "originCode": "DEL",
      "destCode": "BOM",
      "totalAmount": 5324,
      "currency": "INR",
      "fareBreakdown": {
        "tenantTotal": 5324,
        "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": 5324,
            "baseFare": null,
            "totalTax": null
          }
        ]
      },
      "cabin": null
    }
  },
  "meta": {
    "requestId": "req_034nVJT95FLBQWFBDpZTFw",
    "timestamp": "2026-10-28T02:02:19.296Z",
    "path": "/v1/flights/bookings/bkg_034nVJSR1PGFZYW9sYEu7h/status",
    "method": "GET"
  }
}

Poll a booking’s async status.

What: asks the supplier directly for the latest status of a booking that is PENDING_CONFIRMATION.

When: only now and then, for example when your customer asks. Kitionz already checks a pending booking with the supplier about every 30 seconds, so for routine waiting read GET /bookings/{id} instead; most settle within 10 minutes. No webhook is sent for this change.

Gotchas

When there is nothing to ask the supplier yet (a request booking, or a booking whose supplier gave no clear answer), the answer comes from Kitionz’s own record: 200, never an error.
Never show a hard failure and never book again while it is pending. Still pending after 20 minutes: contact Kitionz support with the booking id.

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

Async booking-status poll result + the refreshed booking.

metaobject