How does it work?

Pass the barcode/QR code value through within the ‘code’ key of the request body. Examples are stored in the API playground. The boarding pass body is returned in nested JSON format. Multiple segments are supported.

What data does it return?

The API will decode what is supplied by the airline. Not all fields are mandatory. The available response fields include:

• passengerName: The passengers full name as Lastname/Firstname;
• passengerFirstName: The passengers first name;
• passengerLastName: The passengers last name;
• legs:
  • operatingCarrierPNR: Operating carrier PNR number;
  • departureAirport: Identifies the departure airport by IATA code;
  • arrivalAirport: Identifies the arrival airport by IATA code;
  • operatingCarrierDesignator: Identifies the operating airline;
  • flightNumber: Actual flight number;
  • flightDate: Date of the flight in YYYY-MM-DD format;
  • compartmentCode: Denotes class of travel (not booking fare class), F for first, J for business, Y for economy;
  • seatNumber: Seat number if one has been assigned, or GATE/STBY designator;
  • checkInSequenceNumber: Check-in sequence number;
  • passengerStatus: 0 for passenger not checked in, 1 for passenger checked in, 2 for baggage checked in but passenger not checked in;
  • airlineNumericCode: Identifies the airline IATA ticketing designator;
  • serialNumber: Identifies the serial number of the document;
  • selecteeIndicator: Identifies passengers that require additional inspection at airports in certain countries. Mandatory field when US travel is involved;
  • internationalDocumentationVerification: Identifies passengers requiring their travel documentation to be verified;
  • marketingCarrierDesignator: May be the same as operating carrier;
  • frequentFlyerAirlineDesignator: Identifies carrier holding the passengers frequent flyer membership;
  • frequentFlyerNumber: Identifies passengers frequent flyer number for their supplied programme;
  • idIndicator: Identifies industry or agency discounts;
  • freeBaggageAllowance: Indicates free baggage allowances in pieces (PC), kilograms (K) or pounds §;
  • fastTrack: Identifies passengers entitled to use a priority security or immigration lane at some airports (Y for yes, N for no, blank if not populated;
  • airlineInfo: Allows airlines can populate this field with different entries such as but not limited to: frequent flyer tier,
    passenger preferences, etc.
• meta:
  • formatCode: Always ‘M’;
  • numberOfLegs: Number of legs encoded;
  • electronicTicketIndicator: Identifies passengers traveling on an electronic ticket versus a ticketless product;
  • versionNumber: Identifies IATA BCBP standard used;
  • securityDataIndicator: Optional field for a digital signature to verify the integrity of the boarding pass.

Where can I find out more about the IATA BCBP standard?

You can read more in the IATA Bar Coded Boarding Pass (BCBP) Implementation Guide.

Do you process or store the data?

No. We do not collect or sell the data processed by the Boarding Pass Tools API. Request bodies are decoded, returned to you, and immediately deleted from our system. Please contact us at hello@seatmate.io if you have questions.

Where can I send questions or suggestions?

We’re happy to hear from you at hello@seatmate.io with your feedback.