LayoverGuard Airline Codes

Commercial passenger airline code lookup for JavaScript and TypeScript.

This repository contains a curated dataset of commercial passenger airline codes and a zero-dependency JavaScript/TypeScript package for looking up airline names by IATA code.

Package

npm install @layoverguard/airline-codes

Usage

import { getAirlineNameByIata } from "@layoverguard/airline-codes";

getAirlineNameByIata("JU");
// "Air Serbia"

You can also access the raw list and lookup map:

import {
  airlines,
  airlinesByIata,
  getAirlineByIata,
  hasAirlineIataCode,
} from "@layoverguard/airline-codes";

airlinesByIata["JU"];
// "Air Serbia"

getAirlineByIata("JU");
// { iataCode: "JU", name: "Air Serbia" }

hasAirlineIataCode("JU");
// true

Dataset scope

This package focuses on commercial passenger airlines commonly used in travel, booking, and flight lookup applications.

It is not intended to be a complete registry of every historical, cargo, private, military, or non-commercial aviation code.

The canonical dataset lives in:

data/airlines.json

Current v1 data shape:

type Airline = {
  iataCode: string;
  name: string;
};

Future versions may add optional fields such as icaoCode.

Repository structure

data/
  airlines.json

packages/
  js/
    src/
      index.ts
    package.json
    tsconfig.json

Development

Install dependencies:

npm install

Run checks:

npm run check
npm run test
npm run build

Versioning

This package uses semantic versioning.

• Patch releases include airline data corrections, missing airline additions, typo fixes, and documentation updates.
• Minor releases include new lookup functions, new optional fields, or larger dataset improvements.
• Major releases include breaking API changes or breaking changes to the data shape.

While the package is under 1.0.0, minor versions may include breaking changes as the API stabilizes.

Contributing

Contributions are welcome for public airline data corrections and documentation improvements.

Good contributions include:

• adding a missing commercial passenger airline
• fixing an airline name typo
• correcting an incorrect IATA code
• improving documentation
• improving tests or package utilities

When submitting data corrections, please include a public source where possible.

If a pull request changes airline data, package behavior, or exported APIs, please add a changeset:

npm run changeset

Most airline data updates should use a patch release.

License

MIT