---
title: "Airline Lookup"
method: GET
path: "/api/airlines"
tags: ["Reference Data"]
---

# Airline Lookup

`GET /api/airlines`

## Request

- Base URL: `https://www.freightutils.com`
- URL: `https://www.freightutils.com/api/airlines`
- Auth: none declared

Search for cargo airlines by name, IATA code, ICAO code, AWB prefix, or country. Provide one search parameter.

## Query parameters

- `q` string
- `iata` string
- `icao` string
- `prefix` string
- `country` string
- `view` 'summary'
- `offset` integer
- `limit` integer

## Response `200`

Matching airline records.

- AirlinesResponse
  - `count` integer, required: Number of matching results.
  - `results` Airline[], required
    - `slug` string, required: URL-friendly airline identifier.
    - `airline_name` string, required: Full airline name.
    - `iata_code` string, required: 2-character IATA airline designator.
    - `icao_code` string, required: 3-character ICAO airline designator.
    - `awb_prefix` string[], required: 3-digit Air Waybill prefix number(s).
    - `callsign` string, required: Radio telephony callsign.
    - `country` string, required: Country of registration.
    - `has_cargo` boolean, required: Whether the airline operates cargo services.
    - `aliases` string[], nullable: Alternative names (e.g. cargo division name).
    - `status` 'active_verified' | 'historical' | 'unverified': Per-record verification status. active_verified: every served identifier confirmed against carrier-published pages (ICAO/callsign via FAA JO 7340.2), cited in field_provenance. historical: ceased operating, codes kept as fact. unverified: audited, not cleared. Absent = never audited.
    - `status_checked_at` string, date: ISO date the verification status was last established. Absent when `status` is absent.
    - `data_note` string: Plain-language caveat about this record's evidence, when one applies (e.g. why it is held at unverified).
    - `field_provenance` object: Per-FIELD source citations — the evidence active_verified rests on. Keys are field names (iata_code, icao_code, awb_prefix, callsign, operating_status); values are the sources confirming that field. Aggregators score zero and never appear.
    - `sources` object[]: Record-level union of the per-field citations.
      - `url` string, uri, required
      - `accessed_at` string, date, required
    - `verified` boolean: DEPRECATED — computed mirror of status==='active_verified', kept for one release. ABSENT (not false) on never-audited records, because false would assert a check that never happened. Read status instead.
  - `_source` SourceEnvelope: Additive provenance citation for the dataset or method behind this response, from FreightUtils' single provenance source of truth. Shapes: reference, methodology (calculators), or reference with provenance_status:'pending-verification'. Fields appear only when a real value exists.
    - `type` 'reference' | 'methodology', required
    - `authority` string
    - `dataset` string
    - `source_url` string
    - `data_vintage` string
    - `licence` string
    - `retrieved_via` string
    - `standard` string
    - `reference` string
    - `computed_by` string
    - `provenance_status` 'pending-verification'
    - `dataset_edition` string: Edition this response is served from (editioned reference datasets only), e.g. 'UN/LOCODE 2025-1'.
    - `authority_current_edition` string: The authority's current in-force edition at the last check. Differs from dataset_edition only when the served data lags the authority.
    - `checked_at` string: YYYY-MM-DD of the last served-vs-authority edition comparison (on-demand checker, staleness-guarded).

## Other responses

- `400`: Invalid or missing parameters.

---

[API](https://skmtc.dev/freightutils/apis/freightutils-api.md) · [All operations](https://skmtc.dev/freightutils/apis/freightutils-api/llms.txt) · [OpenAPI document](https://skmtc.dev/freightutils/apis/freightutils-api/revisions/6607bb3cea90?raw)