{"uid":"cap_-9e6EeYgbw9znwEJ6j1oR","slug":"airlines-reference-flight-number-parser-c4c758b6","name":"Airlines Reference – Flight Number Parser","description":"Parse a flight number like BA117, BAW117 or U21234 into airline code, number and suffix, validate format, find the airline.","url":"https://airlines-reference.x402tookit.com/flight-number-parse?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["flight"],"properties":{"flight":{"type":"string","description":"Flight number: BA117, BAW 117, U2 1234, AA100A"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"input":{"type":["null","string"]},"valid":{"type":["boolean","null"]},"source":{"type":["null","string"]},"suffix":{},"airline":{"type":["null","object"],"properties":{"iata":{"type":["null","string"]},"icao":{"type":["null","string"]},"name":{"type":["null","string"]},"alias":{},"active":{"type":["boolean","null"]},"country":{"type":["null","string"]},"callsign":{"type":["null","string"]},"openflightsId":{"type":["null","number"]},"routesInSnapshot":{"type":["null","number"]}}},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"designator":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"normalized":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"attribution":{"type":["null","string"]},"flightNumber":{"type":["null","number"]},"otherMatches":{"type":["array","null"]},"designatorType":{"type":["null","string"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Wv5ZG7UOxjqpYKgCUeq9a","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Parses a raw flight number string (e.g. BA117, BAW117, U21234) into its structured components: airline designator, flight number, suffix, and enriched airline details, while validating its format.","exampleAgentPrompt":"Can you parse the flight number BA117 and tell me which airline operates it, whether the format is valid, and give me the normalized form with the IATA and ICAO codes?","exampleUseCases":[{"title":"Validate flight number from booking form","prompt":"A user just typed 'BAW0117' into our booking form — can you parse that flight number, confirm it's valid, and tell me the airline name, IATA code, and normalized format?"},{"title":"Identify airline from itinerary string","prompt":"I've got a raw itinerary string with flight code U21234 — can you break that down into the airline designator, flight number, and tell me whether U2 is an IATA or ICAO code and who the airline is?"},{"title":"Check unknown flight code for support ticket","prompt":"A customer submitted a support ticket mentioning flight AA100A — can you parse that, validate the format, and pull up the airline's name, country, and callsign so I can route the ticket correctly?"}],"resultDescription":"Returns a structured object with the parsed flight number components: normalized flight number, designator, designator type (IATA/ICAO), numeric flight number, suffix, validity flag, list of validation reasons, a human-readable summary and verdict, and a nested airline object containing IATA code, ICAO code, airline name, alias, country, callsign, active status, OpenFlights ID, and route count in snapshot. Also includes degraded flag, disclaimer, attribution, and any unmatched designator alternatives.","failureModes":["Invalid or unrecognizable flight number string returns valid=false with reasons array explaining the failure","Airline not found in snapshot returns null airline object but may still parse the designator","Ambiguous designator (same IATA and ICAO share letters) returns otherMatches array","Malformed input missing the flight query parameter returns a validation error","Service temporarily unavailable returns a non-200 HTTP error"],"whenToPreferThis":"Use this endpoint when you need to decompose a raw flight number string into structured components and simultaneously look up the operating airline's metadata. It is the right choice when the input is a combined flight identifier (designator + number, optionally with suffix) in either IATA or ICAO format and you need both parsing and airline enrichment in one call. Prefer it over generic airline lookup endpoints when your input is a flight string rather than a standalone airline code.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T12:31:09.350Z","isFirstParty":false,"canonicalSlug":"airlines-reference-flight-number-parser-c4c758b6"}