Skip to main content
Glama
FreightUtils MCP Server

FreightUtils MCP Server

airline_lookup

Read-onlyIdempotent

Look up airlines by name, IATA or ICAO code, AWB prefix, or country. Use exact code and country filters or a ranked fuzzy query to identify the carrier behind a shipment or code.

Instructions

Find airlines (6,356) by name, IATA code, ICAO code, AWB prefix (the first 3 digits of an air waybill number, e.g. 176 = Emirates) or country. Provide ONE parameter: query is a ranked fuzzy search; iata / icao / prefix / country are exact filters. Searches carriers, not airports — for airports use airport_lookup; to check an AWB number's check digit use validate. Rate-limited: a limit error carries reset_at, the UTC time the allowance resets. Provenance pending independent verification — confirm operationally critical codes with IATA/ICAO or the carrier.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "airline_lookup"
  }
}

Input Schema

NameRequiredDescriptionDefault
fullNoLists only: true returns full records instead of summary rows.
iataNoExact 2-character IATA code.
icaoNoExact 3-letter ICAO code.
codesNoBatch: up to 50 airline codes (IATA, ICAO or AWB prefix). Send alone.
limitNoLists only: rows per page.
queryNoRanked fuzzy search across names and codes.
offsetNoLists only: rows to skip (default 0).
prefixNoExact AWB prefix, 3 digits.
countryNoCountry name filter.

Output Schema

NameRequiredDescriptionDefault
okYes
_metaNo
as_ofNo
resultYes
statusNo
_sourceYes
editionNo
citationYes
validityNo
warningsNo
confidenceYes
missing_inputsNo
blocking_errorsNo
envelope_versionYes
normalized_inputNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed16 schema fields changedv2.34.4
    • changedInput schema / properties / codes / description
      Previous value: -"Batch: up to 50 airline codes — 2 characters IATA, 3 letters ICAO, 3 digits AWB prefix. Send alone; answered as results[] in input order, each with its own status. One call against the daily limit, N against the Pro monthly allowance."New value: +"Batch: up to 50 airline codes (IATA, ICAO or AWB prefix). Send alone."
    • changedInput schema / properties / country / description
      Previous value: -"Filter by country name (min 2 chars). Example: \"Netherlands\"."New value: +"Country name filter."
    • changedInput schema / properties / full / description
      Previous value: -"Lists only: true returns full records (provenance, sources, rationale) instead of summary rows, five per page by default. A single-record call always returns the full record."New value: +"Lists only: true returns full records instead of summary rows."
    • changedInput schema / properties / iata / description
      Previous value: -"Exact IATA code — 2 alphanumeric characters. Examples: \"EK\", \"U2\"."New value: +"Exact 2-character IATA code."
    • changedInput schema / properties / icao / description
      Previous value: -"Exact ICAO code — 3 letters. Examples: \"UAE\", \"BAW\"."New value: +"Exact 3-letter ICAO code."
    • changedInput schema / properties / limit / description
      Previous value: -"Lists only: rows per page (default: every summary row; 5 with full: true)."New value: +"Lists only: rows per page."
    • changedInput schema / properties / offset / description
      Previous value: -"Lists only: rows to skip (default 0). The response gives total and next_offset."New value: +"Lists only: rows to skip (default 0)."
    • changedInput schema / properties / prefix / description
      Previous value: -"Exact AWB prefix — the first 3 digits of an air waybill. Example: \"176\"."New value: +"Exact AWB prefix, 3 digits."
    • changedInput schema / properties / query / description
      Previous value: -"Ranked fuzzy search across name, codes, prefix and country (min 2 chars). Example: \"emirates\"."New value: +"Ranked fuzzy search across names and codes."
    • removedOutput schema / properties / _meta / properties / upstream / properties / datasets / additionalProperties / properties / kind / description
      Removed value: -"watched (its upstream is fetched daily) or checksum-only (no upstream of its own)."
    • removedOutput schema / properties / _meta / properties / upstream / properties / datasets / additionalProperties / properties / last_success / description
      Removed value: -"The last day (YYYY-MM-DD) the upstream check succeeded; null when none is recorded."
    • removedOutput schema / properties / _meta / properties / upstream / properties / datasets / additionalProperties / properties / reason / description
      Removed value: -"Why the state is unknown."
    • removedOutput schema / properties / _meta / properties / upstream / properties / stale / description
      Removed value: -"True only when a dataset below missed its upstream check window (window_missed)."
    • removedOutput schema / properties / _meta / properties / upstream / properties / state / description
      Removed value: -"The worst state of the datasets below."
    • removedOutput schema / properties / _meta / properties / upstream / properties / state_read_at / description
      Removed value: -"When the site upstream check recorded the state (ISO 8601); null when it could not be read."
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "count": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "meta": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "propertyNames": {
      -              "type": "string"
      -            },
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "results": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": {},
      -              "properties": {
      -                "airline_name": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "aliases": {
      -                  "anyOf": [
      -                    {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "audited_at": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "awb_prefix": {
      -                  "anyOf": [
      -                    {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "callsign": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "cargo_website": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "chargeable_weight_ref": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "code_history": {
      -                  "anyOf": [
      -                    {
      -                      "items": {
      -                        "additionalProperties": {},
      -                        "properties": {
      -                          "field": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "from": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "source": {
      -                            "anyOf": [
      -                              {
      -                                "additionalProperties": {},
      -                                "propertyNames": {
      -                                  "type": "string"
      -                                },
      -                                "type": "object"
      -                              },
      -                              {
      -                                "type": "null"
      -                              }
      -                            ]
      -                          },
      -                          "until": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "value": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          }
      -                        },
      -                        "type": "object"
      -                      },
      -                      "type": "array"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "country": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "dg_acceptance_url": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "fu_id": {
      -                  "anyOf": [
      -                    {
      -                      "description": "Stable FreightUtils identifier of this record, fu:<namespace>:<key> — the same across editions; resolve_reference resolves it to exactly this record.",
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "fu_version_id": {
      -                  "anyOf": [
      -                    {
      -                      "description": "This record in one dataset edition, fu_id@<edition>. Present only where the dataset has editions (absent on airlines, ULDs, containers, vehicles).",
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "has_cargo": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                },
      -                "iata_code": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "icao_code": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "operational_status": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "active",
      -                        "ceased",
      -                        "unknown"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "operational_status_basis": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "carrier_published",
      -                        "faa_designator_current",
      -                        "domain_fetch_check",
      -                        "wikidata_dissolved"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "operational_status_since": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "prefix_holders": {
      -                  "anyOf": [
      -                    {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "prefix_shared": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                },
      -                "restrictions": {
      -                  "anyOf": [
      -                    {
      -                      "items": {
      -                        "additionalProperties": {},
      -                        "properties": {
      -                          "accessed_at": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "annex": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "list": {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "eu_air_safety_list",
      -                                  "uk_air_safety_list"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "null"
      -                              }
      -                            ]
      -                          },
      -                          "list_updated": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "listed_name": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "match_basis": {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "icao_designator",
      -                                  "name_and_state"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "null"
      -                              }
      -                            ]
      -                          },
      -                          "regulation": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "regulation_date": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "restricted": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "scope": {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "banned",
      -                                  "restricted"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "null"
      -                              }
      -                            ]
      -                          },
      -                          "sha256": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "since": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "source_url": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          }
      -                        },
      -                        "type": "object"
      -                      },
      -                      "type": "array"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "slug": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "tracking_url_template": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "verified": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "propertyNames": {
      -      "type": "string"
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "count": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "meta": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "propertyNames": {
      +              "type": "string"
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "results": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "airline_name": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "aliases": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "audited_at": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "awb_prefix": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "callsign": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "cargo_website": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "chargeable_weight_ref": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "code_history": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "additionalProperties": {},
      +                        "properties": {
      +                          "field": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "from": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "source": {
      +                            "anyOf": [
      +                              {
      +                                "additionalProperties": {},
      +                                "propertyNames": {
      +                                  "type": "string"
      +                                },
      +                                "type": "object"
      +                              },
      +                              {
      +                                "type": "null"
      +                              }
      +                            ]
      +                          },
      +                          "until": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "value": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          }
      +                        },
      +                        "type": "object"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "country": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "dg_acceptance_url": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "fu_id": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "fu_version_id": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "has_cargo": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "iata_code": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "icao_code": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "operational_status": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "active",
      +                        "ceased",
      +                        "unknown"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "operational_status_basis": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "carrier_published",
      +                        "faa_designator_current",
      +                        "domain_fetch_check",
      +                        "wikidata_dissolved"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "operational_status_since": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "prefix_holders": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "prefix_shared": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "restrictions": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "additionalProperties": {},
      +                        "properties": {
      +                          "accessed_at": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "annex": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "list": {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "eu_air_safety_list",
      +                                  "uk_air_safety_list"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "null"
      +                              }
      +                            ]
      +                          },
      +                          "list_updated": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "listed_name": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "match_basis": {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "icao_designator",
      +                                  "name_and_state"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "null"
      +                              }
      +                            ]
      +                          },
      +                          "regulation": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "regulation_date": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "restricted": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "scope": {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "banned",
      +                                  "restricted"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "null"
      +                              }
      +                            ]
      +                          },
      +                          "sha256": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "since": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "source_url": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          }
      +                        },
      +                        "type": "object"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "slug": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "tracking_url_template": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "verified": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "propertyNames": {
      +      "type": "string"
      +    },
      +    "type": "object"
      +  }
      +]
  2. Changed3 schema fields changedv2.34.0
    • addedOutput schema / properties / _meta / properties / ids
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "pattern": {
      +      "type": "string"
      +    },
      +    "scheme": {
      +      "maximum": 9007199254740991,
      +      "minimum": -9007199254740991,
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "scheme",
      +    "pattern"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / _meta / properties / upstream
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "datasets": {
      +      "additionalProperties": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "kind": {
      +            "description": "watched (its upstream is fetched daily) or checksum-only (no upstream of its own).",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "last_success": {
      +            "description": "The last day (YYYY-MM-DD) the upstream check succeeded; null when none is recorded.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "reason": {
      +            "description": "Why the state is unknown.",
      +            "type": "string"
      +          },
      +          "stale": {
      +            "type": "boolean"
      +          },
      +          "state": {
      +            "enum": [
      +              "in_step",
      +              "changed_upstream",
      +              "schema_drift",
      +              "unreachable",
      +              "window_missed",
      +              "unknown"
      +            ],
      +            "type": "string"
      +          },
      +          "window_days": {
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "state",
      +          "kind",
      +          "last_success",
      +          "window_days",
      +          "stale"
      +        ],
      +        "type": "object"
      +      },
      +      "propertyNames": {
      +        "type": "string"
      +      },
      +      "type": "object"
      +    },
      +    "stale": {
      +      "description": "True only when a dataset below missed its upstream check window (window_missed).",
      +      "type": "boolean"
      +    },
      +    "state": {
      +      "description": "The worst state of the datasets below.",
      +      "enum": [
      +        "in_step",
      +        "changed_upstream",
      +        "schema_drift",
      +        "unreachable",
      +        "window_missed",
      +        "unknown"
      +      ],
      +      "type": "string"
      +    },
      +    "state_read_at": {
      +      "description": "When the site upstream check recorded the state (ISO 8601); null when it could not be read.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "required": [
      +    "state",
      +    "stale",
      +    "state_read_at",
      +    "datasets"
      +  ],
      +  "type": "object"
      +}
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "count": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "meta": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "propertyNames": {
      -              "type": "string"
      -            },
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "results": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": {},
      -              "properties": {
      -                "airline_name": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "aliases": {
      -                  "anyOf": [
      -                    {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "audited_at": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "awb_prefix": {
      -                  "anyOf": [
      -                    {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "callsign": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "cargo_website": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "chargeable_weight_ref": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "code_history": {
      -                  "anyOf": [
      -                    {
      -                      "items": {
      -                        "additionalProperties": {},
      -                        "properties": {
      -                          "field": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "from": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "source": {
      -                            "anyOf": [
      -                              {
      -                                "additionalProperties": {},
      -                                "propertyNames": {
      -                                  "type": "string"
      -                                },
      -                                "type": "object"
      -                              },
      -                              {
      -                                "type": "null"
      -                              }
      -                            ]
      -                          },
      -                          "until": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "value": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          }
      -                        },
      -                        "type": "object"
      -                      },
      -                      "type": "array"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "country": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "dg_acceptance_url": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "has_cargo": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                },
      -                "iata_code": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "icao_code": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "operational_status": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "active",
      -                        "ceased",
      -                        "unknown"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "operational_status_basis": {
      -                  "anyOf": [
      -                    {
      -                      "enum": [
      -                        "carrier_published",
      -                        "faa_designator_current",
      -                        "domain_fetch_check",
      -                        "wikidata_dissolved"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "operational_status_since": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "prefix_holders": {
      -                  "anyOf": [
      -                    {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "prefix_shared": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                },
      -                "restrictions": {
      -                  "anyOf": [
      -                    {
      -                      "items": {
      -                        "additionalProperties": {},
      -                        "properties": {
      -                          "accessed_at": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "annex": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "list": {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "eu_air_safety_list",
      -                                  "uk_air_safety_list"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "null"
      -                              }
      -                            ]
      -                          },
      -                          "list_updated": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "listed_name": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "match_basis": {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "icao_designator",
      -                                  "name_and_state"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "null"
      -                              }
      -                            ]
      -                          },
      -                          "regulation": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "regulation_date": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "restricted": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "scope": {
      -                            "anyOf": [
      -                              {
      -                                "enum": [
      -                                  "banned",
      -                                  "restricted"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              {
      -                                "type": "null"
      -                              }
      -                            ]
      -                          },
      -                          "sha256": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "since": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          },
      -                          "source_url": {
      -                            "type": [
      -                              "string",
      -                              "null"
      -                            ]
      -                          }
      -                        },
      -                        "type": "object"
      -                      },
      -                      "type": "array"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "slug": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "tracking_url_template": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "verified": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "propertyNames": {
      -      "type": "string"
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "count": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "meta": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "propertyNames": {
      +              "type": "string"
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "results": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "airline_name": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "aliases": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "audited_at": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "awb_prefix": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "callsign": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "cargo_website": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "chargeable_weight_ref": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "code_history": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "additionalProperties": {},
      +                        "properties": {
      +                          "field": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "from": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "source": {
      +                            "anyOf": [
      +                              {
      +                                "additionalProperties": {},
      +                                "propertyNames": {
      +                                  "type": "string"
      +                                },
      +                                "type": "object"
      +                              },
      +                              {
      +                                "type": "null"
      +                              }
      +                            ]
      +                          },
      +                          "until": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "value": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          }
      +                        },
      +                        "type": "object"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "country": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "dg_acceptance_url": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "fu_id": {
      +                  "anyOf": [
      +                    {
      +                      "description": "Stable FreightUtils identifier of this record, fu:<namespace>:<key> — the same across editions; resolve_reference resolves it to exactly this record.",
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "fu_version_id": {
      +                  "anyOf": [
      +                    {
      +                      "description": "This record in one dataset edition, fu_id@<edition>. Present only where the dataset has editions (absent on airlines, ULDs, containers, vehicles).",
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "has_cargo": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "iata_code": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "icao_code": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "operational_status": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "active",
      +                        "ceased",
      +                        "unknown"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "operational_status_basis": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "carrier_published",
      +                        "faa_designator_current",
      +                        "domain_fetch_check",
      +                        "wikidata_dissolved"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "operational_status_since": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "prefix_holders": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "prefix_shared": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "restrictions": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "additionalProperties": {},
      +                        "properties": {
      +                          "accessed_at": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "annex": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "list": {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "eu_air_safety_list",
      +                                  "uk_air_safety_list"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "null"
      +                              }
      +                            ]
      +                          },
      +                          "list_updated": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "listed_name": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "match_basis": {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "icao_designator",
      +                                  "name_and_state"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "null"
      +                              }
      +                            ]
      +                          },
      +                          "regulation": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "regulation_date": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "restricted": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "scope": {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "banned",
      +                                  "restricted"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "null"
      +                              }
      +                            ]
      +                          },
      +                          "sha256": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "since": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "source_url": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          }
      +                        },
      +                        "type": "object"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "slug": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "tracking_url_template": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "verified": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "propertyNames": {
      +      "type": "string"
      +    },
      +    "type": "object"
      +  }
      +]
  3. Changed2 schema fields changedv2.31.0
    • removedOutput schema / properties / _meta / properties / receipt / properties / reason / const
      Removed value: -"key_required"
    • addedOutput schema / properties / _meta / properties / receipt / properties / reason / enum
      Added value: +[
      +  "key_required",
      +  "quota"
      +]
  4. Changed6 schema fields changedv2.27.0
    • addedInput schema / properties / codes
      Added value: +{
      +  "description": "Batch: up to 50 airline codes — 2 characters IATA, 3 letters ICAO, 3 digits AWB prefix. Send alone; answered as results[] in input order, each with its own status. One call against the daily limit, N against the Pro monthly allowance.",
      +  "items": {
      +    "maxLength": 14,
      +    "type": "string"
      +  },
      +  "maxItems": 50,
      +  "minItems": 1,
      +  "type": "array"
      +}
    • addedOutput schema / properties / _meta / properties / check_id
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / _meta / properties / edition_basis
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / _meta / properties / receipt
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "created_at": {
      +      "type": "string"
      +    },
      +    "dataset_version": {
      +      "additionalProperties": {
      +        "type": "string"
      +      },
      +      "propertyNames": {
      +        "type": "string"
      +      },
      +      "type": "object"
      +    },
      +    "engine_version": {
      +      "type": "string"
      +    },
      +    "inputs": {},
      +    "reason": {
      +      "const": "key_required",
      +      "type": "string"
      +    },
      +    "receipt_hash": {
      +      "type": "string"
      +    },
      +    "result": {
      +      "additionalProperties": {},
      +      "propertyNames": {
      +        "type": "string"
      +      },
      +      "type": "object"
      +    },
      +    "schema_version": {
      +      "type": "string"
      +    },
      +    "stored": {
      +      "const": false,
      +      "type": "boolean"
      +    },
      +    "tool": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "stored",
      +    "reason",
      +    "schema_version",
      +    "receipt_hash",
      +    "created_at",
      +    "tool",
      +    "inputs",
      +    "dataset_version",
      +    "engine_version",
      +    "result"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / _meta / properties / receipt_url
      Added value: +{
      +  "type": "string"
      +}
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "count": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "meta": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "propertyNames": {
      -              "type": "string"
      -            },
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "results": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": {},
      -              "properties": {
      -                "airline_name": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "aliases": {
      -                  "anyOf": [
      -                    {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "audited_at": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "awb_prefix": {
      -                  "anyOf": [
      -                    {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "callsign": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "country": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "has_cargo": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                },
      -                "iata_code": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "icao_code": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "slug": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "verified": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "propertyNames": {
      -      "type": "string"
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "count": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "meta": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "propertyNames": {
      +              "type": "string"
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "results": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "airline_name": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "aliases": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "audited_at": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "awb_prefix": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "callsign": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "cargo_website": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "chargeable_weight_ref": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "code_history": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "additionalProperties": {},
      +                        "properties": {
      +                          "field": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "from": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "source": {
      +                            "anyOf": [
      +                              {
      +                                "additionalProperties": {},
      +                                "propertyNames": {
      +                                  "type": "string"
      +                                },
      +                                "type": "object"
      +                              },
      +                              {
      +                                "type": "null"
      +                              }
      +                            ]
      +                          },
      +                          "until": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "value": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          }
      +                        },
      +                        "type": "object"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "country": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "dg_acceptance_url": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "has_cargo": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "iata_code": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "icao_code": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "operational_status": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "active",
      +                        "ceased",
      +                        "unknown"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "operational_status_basis": {
      +                  "anyOf": [
      +                    {
      +                      "enum": [
      +                        "carrier_published",
      +                        "faa_designator_current",
      +                        "domain_fetch_check",
      +                        "wikidata_dissolved"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "operational_status_since": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "prefix_holders": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "prefix_shared": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "restrictions": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "additionalProperties": {},
      +                        "properties": {
      +                          "accessed_at": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "annex": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "list": {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "eu_air_safety_list",
      +                                  "uk_air_safety_list"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "null"
      +                              }
      +                            ]
      +                          },
      +                          "list_updated": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "listed_name": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "match_basis": {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "icao_designator",
      +                                  "name_and_state"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "null"
      +                              }
      +                            ]
      +                          },
      +                          "regulation": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "regulation_date": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "restricted": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "scope": {
      +                            "anyOf": [
      +                              {
      +                                "enum": [
      +                                  "banned",
      +                                  "restricted"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              {
      +                                "type": "null"
      +                              }
      +                            ]
      +                          },
      +                          "sha256": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "since": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          },
      +                          "source_url": {
      +                            "type": [
      +                              "string",
      +                              "null"
      +                            ]
      +                          }
      +                        },
      +                        "type": "object"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "slug": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "tracking_url_template": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "verified": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "propertyNames": {
      +      "type": "string"
      +    },
      +    "type": "object"
      +  }
      +]
  5. Changed10 schema fields changedv2.24.0
    • addedOutput schema / properties / _meta
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "identify": {
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / as_of
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / blocking_errors / items / properties / recovery / properties / params / propertyNames
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / edition
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "applies_from": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "may_apply_until": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "name": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "name",
      +        "applies_from",
      +        "may_apply_until"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • changedOutput schema / properties / envelope_version / enum
      Previous value: -[
      -  "1",
      -  "1.1"
      -]New value: +[
      +  "1",
      +  "1.1",
      +  "1.2"
      +]
    • addedOutput schema / properties / missing_inputs
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / normalized_input / propertyNames
      Added value: +{
      +  "type": "string"
      +}
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "count": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "meta": {
      -        "anyOf": [
      -          {
      -            "additionalProperties": {},
      -            "type": "object"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "results": {
      -        "anyOf": [
      -          {
      -            "items": {
      -              "additionalProperties": true,
      -              "properties": {
      -                "airline_name": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "aliases": {
      -                  "anyOf": [
      -                    {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "audited_at": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "awb_prefix": {
      -                  "anyOf": [
      -                    {
      -                      "items": {
      -                        "type": "string"
      -                      },
      -                      "type": "array"
      -                    },
      -                    {
      -                      "type": "null"
      -                    }
      -                  ]
      -                },
      -                "callsign": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "country": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "has_cargo": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                },
      -                "iata_code": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "icao_code": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "slug": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "verified": {
      -                  "type": [
      -                    "boolean",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "type": "object"
      -            },
      -            "type": "array"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "count": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "meta": {
      +        "anyOf": [
      +          {
      +            "additionalProperties": {},
      +            "propertyNames": {
      +              "type": "string"
      +            },
      +            "type": "object"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "results": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "airline_name": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "aliases": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "audited_at": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "awb_prefix": {
      +                  "anyOf": [
      +                    {
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    {
      +                      "type": "null"
      +                    }
      +                  ]
      +                },
      +                "callsign": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "country": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "has_cargo": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                },
      +                "iata_code": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "icao_code": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "slug": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "verified": {
      +                  "type": [
      +                    "boolean",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "type": "object"
      +            },
      +            "type": "array"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "propertyNames": {
      +      "type": "string"
      +    },
      +    "type": "object"
      +  }
      +]
    • addedOutput schema / properties / status
      Added value: +{
      +  "enum": [
      +    "ok",
      +    "partial",
      +    "not_found",
      +    "unsupported",
      +    "ambiguous"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / warnings / items / properties / details / propertyNames
      Added value: +{
      +  "type": "string"
      +}
  6. Changed3 schema fields changedv2.22.3
    • addedInput schema / properties / full
      Added value: +{
      +  "description": "Lists only: true returns full records (provenance, sources, rationale) instead of summary rows, five per page by default. A single-record call always returns the full record.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / limit
      Added value: +{
      +  "description": "Lists only: rows per page (default: every summary row; 5 with full: true).",
      +  "maximum": 100,
      +  "minimum": 1,
      +  "type": "integer"
      +}
    • addedInput schema / properties / offset
      Added value: +{
      +  "description": "Lists only: rows to skip (default 0). The response gives total and next_offset.",
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
  7. Changed5 schema fields changedv2.17.2
    • addedOutput schema / properties / _source / properties / authority_current_edition
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / _source / properties / checked_at
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / _source / properties / dataset_edition
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / properties / envelope_version / const
      Removed value: -"1"
    • addedOutput schema / properties / envelope_version / enum
      Added value: +[
      +  "1",
      +  "1.1"
      +]
  8. Changed6 schema fields changedv2.11.0
    • changedInput schema / properties / country / description
      Previous value: -"Filter by country name (min 2 chars)"New value: +"Filter by country name (min 2 chars). Example: \"Netherlands\"."
    • changedInput schema / properties / iata / description
      Previous value: -"Exact IATA code (2 alphanumeric chars)"New value: +"Exact IATA code — 2 alphanumeric characters. Examples: \"EK\", \"U2\"."
    • changedInput schema / properties / icao / description
      Previous value: -"Exact ICAO code (3 letters)"New value: +"Exact ICAO code — 3 letters. Examples: \"UAE\", \"BAW\"."
    • changedInput schema / properties / prefix / description
      Previous value: -"AWB prefix (3 digits, e.g., \"176\")"New value: +"Exact AWB prefix — the first 3 digits of an air waybill. Example: \"176\"."
    • changedInput schema / properties / query / description
      Previous value: -"General search (name, code, prefix, or country — min 2 chars)"New value: +"Ranked fuzzy search across name, codes, prefix and country (min 2 chars). Example: \"emirates\"."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "http://json-schema.org/draft-07/schema#",
      +  "additionalProperties": false,
      +  "properties": {
      +    "_source": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "checked": {
      +          "type": "string"
      +        },
      +        "name": {
      +          "type": "string"
      +        },
      +        "provenance_status": {
      +          "enum": [
      +            "verified",
      +            "pending-verification",
      +            "computed",
      +            "live"
      +          ],
      +          "type": "string"
      +        },
      +        "source_url": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "name",
      +        "checked",
      +        "provenance_status"
      +      ],
      +      "type": "object"
      +    },
      +    "blocking_errors": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "code": {
      +            "type": "string"
      +          },
      +          "message": {
      +            "type": "string"
      +          },
      +          "recovery": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "action": {
      +                "type": "string"
      +              },
      +              "params": {
      +                "additionalProperties": {},
      +                "type": "object"
      +              },
      +              "tool": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "action"
      +            ],
      +            "type": "object"
      +          }
      +        },
      +        "required": [
      +          "code",
      +          "message",
      +          "recovery"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "citation": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "qualifier": {
      +          "type": "string"
      +        },
      +        "text": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "text"
      +      ],
      +      "type": "object"
      +    },
      +    "confidence": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "basis": {
      +          "enum": [
      +            "deterministic",
      +            "provenance",
      +            "match_quality",
      +            "freshness"
      +          ],
      +          "type": "string"
      +        },
      +        "level": {
      +          "enum": [
      +            "high",
      +            "medium",
      +            "low"
      +          ],
      +          "type": "string"
      +        },
      +        "score": {
      +          "maximum": 1,
      +          "minimum": 0,
      +          "type": "number"
      +        }
      +      },
      +      "required": [
      +        "level",
      +        "basis"
      +      ],
      +      "type": "object"
      +    },
      +    "envelope_version": {
      +      "const": "1",
      +      "type": "string"
      +    },
      +    "normalized_input": {
      +      "additionalProperties": {},
      +      "type": "object"
      +    },
      +    "ok": {
      +      "type": "boolean"
      +    },
      +    "result": {
      +      "anyOf": [
      +        {
      +          "additionalProperties": true,
      +          "properties": {
      +            "count": {
      +              "type": [
      +                "number",
      +                "null"
      +              ]
      +            },
      +            "meta": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": {},
      +                  "type": "object"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            },
      +            "results": {
      +              "anyOf": [
      +                {
      +                  "items": {
      +                    "additionalProperties": true,
      +                    "properties": {
      +                      "airline_name": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "aliases": {
      +                        "anyOf": [
      +                          {
      +                            "items": {
      +                              "type": "string"
      +                            },
      +                            "type": "array"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ]
      +                      },
      +                      "audited_at": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "awb_prefix": {
      +                        "anyOf": [
      +                          {
      +                            "items": {
      +                              "type": "string"
      +                            },
      +                            "type": "array"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ]
      +                      },
      +                      "callsign": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "country": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "has_cargo": {
      +                        "type": [
      +                          "boolean",
      +                          "null"
      +                        ]
      +                      },
      +                      "iata_code": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "icao_code": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "slug": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "verified": {
      +                        "type": [
      +                          "boolean",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                {
      +                  "type": "null"
      +                }
      +              ]
      +            }
      +          },
      +          "type": "object"
      +        },
      +        {
      +          "additionalProperties": {},
      +          "type": "object"
      +        }
      +      ]
      +    },
      +    "validity": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "as_of": {
      +          "type": "string"
      +        },
      +        "effective_from": {
      +          "type": "string"
      +        },
      +        "effective_to": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "required": [
      +        "as_of"
      +      ],
      +      "type": "object"
      +    },
      +    "warnings": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "code": {
      +            "type": "string"
      +          },
      +          "details": {
      +            "additionalProperties": {},
      +            "type": "object"
      +          },
      +          "message": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "code",
      +          "message"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "envelope_version",
      +    "ok",
      +    "result",
      +    "confidence",
      +    "_source",
      +    "citation"
      +  ],
      +  "type": "object"
      +}
  9. Changed8 schema fields changedv2.5.0
    • changedInput schema / properties / iata / description
      Previous value: -"Exact IATA code (2 chars, e.g., \"EK\")"New value: +"Exact IATA code (2 alphanumeric chars)"
    • removedInput schema / properties / iata / maxLength
      Removed value: -2
    • removedInput schema / properties / iata / minLength
      Removed value: -2
    • addedInput schema / properties / iata / pattern
      Added value: +"^[A-Za-z0-9]{2}$"
    • changedInput schema / properties / icao / description
      Previous value: -"Exact ICAO code (3 chars, e.g., \"UAE\")"New value: +"Exact ICAO code (3 letters)"
    • removedInput schema / properties / icao / maxLength
      Removed value: -3
    • removedInput schema / properties / icao / minLength
      Removed value: -3
    • addedInput schema / properties / icao / pattern
      Added value: +"^[A-Za-z]{3}$"
  10. Changed7 schema fields changedv2.1.1
    • addedInput schema / properties / country / minLength
      Added value: +2
    • addedInput schema / properties / iata / maxLength
      Added value: +2
    • addedInput schema / properties / iata / minLength
      Added value: +2
    • addedInput schema / properties / icao / maxLength
      Added value: +3
    • addedInput schema / properties / icao / minLength
      Added value: +3
    • addedInput schema / properties / prefix / pattern
      Added value: +"^\\d{3}$"
    • addedInput schema / properties / query / minLength
      Added value: +2
  11. First observedv1.0.0

TDQS

A4.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Adds real context beyond the annotations: a rate limit whose error carries reset_at in UTC, and a provenance caveat telling the agent to confirm operationally critical codes with IATA/ICAO. Annotations already cover read-only/idempotent/non-destructive, so the marginal value here is the rate-limit and data-trust behavior. It omits list-mode pagination behavior and does not explain how the paginated/list mode interacts with the 'ONE parameter' rule.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loads what it finds and the lookup keys, then the parameter rule, then sibling routing, then operational caveats. Sentences are dense but each carries distinct information — no restatement of the title or the schema's property text.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 9-parameter, zero-required tool with an output schema and rich annotations, the description covers modes, alternatives, rate limits, and data trust. The remaining gap is that it never mentions the list-mode modifiers (full, limit, offset) or how pagination behaves, leaving the 'Provide ONE parameter' instruction slightly ambiguous against a schema that permits combining them.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so a 3 would be the floor; the description exceeds it by explaining what `query` actually does (ranked fuzzy across names and codes vs. exact filters) and by defining AWB prefix semantically with a worked example (176 = Emirates). The exclusive-parameter rule is meaning beyond the schema's per-property descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Names a specific verb+resource ('Find airlines') and enumerates the exact lookup keys supported (name, IATA, ICAO, AWB prefix, country), including the record count. It explicitly routes away from two siblings ('Searches carriers, not airports — for airports use airport_lookup'), so an agent can distinguish it without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

States the selection rule among its own parameters ('Provide ONE parameter: query is a ranked fuzzy search; iata / icao / prefix / country are exact filters') and names alternatives with the condition that selects them (airport_lookup for airports, validate for AWB check digits). Both when-to-use and when-not-to-use are present.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.