Submit PNR

POST

/v1/flights/bookings/:id/fulfil

POST

/v1/flights/bookings/:id/fulfil

curl -X POST https://sandbox-api.kitionz.com/v1/flights/bookings/bkg_034nVJUDx36SuYpKozD1X1/fulfil \
     -H "Idempotency-Key: replace-with-a-new-uuid-pnr-submitted" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "pnr": "TESTA7K2Q9"
}'

200Successful

{
  "success": true,
  "statusCode": 200,
  "data": {
    "id": "bkg_034nVJUDx36SuYpKozD1X1",
    "supplierCode": "kitionz_test_portal",
    "seller": {
      "name": "Kitionz Test Air",
      "website": null,
      "supportPhone": null,
      "supportEmail": null
    },
    "environment": "SANDBOX",
    "status": "CONFIRMED",
    "bookingMode": "REQUEST",
    "bookingChannel": "API",
    "supplierReference": "TESTA7K2Q9",
    "pnr": "TESTA7K2Q9",
    "ticketingTimeLimit": null,
    "booker": {
      "name": "Raj Kumar",
      "email": "raj@example-agency.in",
      "phone": "+919800000000"
    },
    "passengers": [
      {
        "id": "bkgpax_034nVJUEpWs023PXb61mC6",
        "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_034nVJUFDV2kFzs1zlC7JW",
        "segmentIndex": 0,
        "legType": "OUTBOUND",
        "legIndex": 0,
        "marketingCarrier": {
          "iataCode": "ZZ",
          "name": "Zz",
          "flightNumber": "900"
        },
        "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": null,
        "arrivalTerminal": null,
        "cabin": null,
        "airlineCode": "ZZ",
        "airlineName": "Zz",
        "flightNumber": "900",
        "originCode": "DEL",
        "originName": "Indira Gandhi International Airport",
        "destCode": "BOM",
        "destName": "Chhatrapati Shivaji Maharaj International Airport",
        "departureTimezone": "Asia/Kolkata",
        "arrivalTimezone": "Asia/Kolkata",
        "originTerminal": null,
        "destinationTerminal": null,
        "cabinClass": null
      }
    ],
    "events": [
      {
        "id": "bkgevent_034nVJUNJSGyJJxSwzgZWm",
        "eventType": "BOOKING_FULFILLED",
        "status": "SUCCESS",
        "errorCode": null,
        "errorMessage": null,
        "createdAt": "2026-10-28T02:02:19.964Z"
      },
      {
        "id": "bkgevent_034nVJUFbzmaqQqDuBw7EI",
        "eventType": "BOOKING_REQUESTED",
        "status": "SUCCESS",
        "errorCode": null,
        "errorMessage": null,
        "createdAt": "2026-10-28T02:02:19.885Z"
      }
    ],
    "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:19.950Z",
    "createdAt": "2026-10-28T02:02:19.872Z",
    "updatedAt": "2026-10-28T02:02:19.961Z",
    "sourceCode": "kitionz_test_portal",
    "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_034nVJUKU2LopX4zyhyZym",
    "timestamp": "2026-10-28T02:02:19.995Z",
    "path": "/v1/flights/bookings/bkg_034nVJUDx36SuYpKozD1X1/fulfil",
    "method": "POST"
  }
}

Submit the PNR for an offline (request) booking.

What: confirms a request booking (an offer with booking.requestBooking: true — a Kitionz-managed portal) with the PNR you obtained by booking with the supplier on your own account. PENDING_FULFILMENT → CONFIRMED.

When: after /book returned status: PENDING_FULFILMENT and you completed the booking with the supplier — before the booking’s nextAction.deadlineAt: the expiry window after it was made (72 hours by default), or the first flight’s departure if that is earlier. After that time Kitionz may cancel the request at any time, and a PNR sent to a cancelled request is refused with 409 BOOKING_NOT_PENDING.

Note: idempotent — submitting the same PNR again returns the booking; a different PNR on an already-fulfilled booking returns 409 BOOKING_ALREADY_FULFILLED; a booking that is not a request returns 409 BOOKING_NOT_A_REQUEST (its PNR comes from the supplier). Sends the flight_booking.confirmed webhook. In Test, the PNR must be TEST followed by 6 letters or digits, without I, L, O or U (for example TESTA7K2Q9; anything else is 400 TEST_PNR_REQUIRED). To give up on a pending request, call /cancel (it is withdrawn, no supplier call).

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

Request

This endpoint expects an object.

pnrstringRequiredformat: "^[^\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F-\u009F]*$"1-64 characters

supplierReferencestringOptionalformat: "^[^\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F-\u009F]*$"1-200 characters

Response

Default Response

successboolean

statusCodedouble

dataobject

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

metaobject

Authentication

Path parameters

Headers

Request

Response