# Airlines Reference – Flight Number Parser

> Airlines Reference – Flight Number Parser is a paid API for AI agents from airlines-reference.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-02).

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.

## Facts

- Endpoint: GET https://airlines-reference.x402tookit.com/flight-number-parse?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/airlines-reference-flight-number-parser-c4c758b6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-9e6EeYgbw9znwEJ6j1oR

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability airlines-reference-flight-number-parser-c4c758b6
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Parse a flight number like BA117, BAW117 or U21234 into airline code, number and suffix, validate format, find the airline.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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": [
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/airlines-reference-flight-number-parser-c4c758b6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from airlines-reference.x402tookit.com](https://www.zero.xyz/host/airlines-reference.x402tookit.com/llms.txt)