This page documents the T-100 endpoints available through the AirStream API. These endpoints provide analytics derived from the Bureau of Transportation Statistics T-100 dataset, covering airline segment and market operational data. All traffic endpoints are prefixed with /traffic.

Understanding Traffic Data

The T-100 dataset reports airline operational statistics at two levels:

Level Description Example
Segment Individual flight segments as operated, including aircraft and capacity details Delta operating ATL → JFK on a 737-800 with 160 seats
Market Origin-destination city pairs aggregated across aircraft types ATL → JFK totals across all carriers and aircraft

Segment data is richer — it includes aircraft type, configuration, and capacity details (seats). Market data aggregates across those details.

Time Parameters

All endpoints support three time modes.

Single Period

Parameter Type Description
year int The year of the data
month int The month of the data

Multi-Period Range

Parameter Type Description
start_year int The first year of the data (inclusive)
start_month int The first month of the data (inclusive)
end_year int The last year of the data (inclusive)
end_month int The last month of the data (inclusive)

Range queries are limited to 24 months maximum.

Specific Periods (Across Years)

Parameter Type Description
start_year int Start year (inclusive)
end_year int End year (inclusive)
months string Comma-separated months (e.g. 6,12)

Specific-period requests are limited to 24 total months.

Segments

Route 

  GET /traffic/segments/route

Returns aggregated segment metrics for a specific origin-destination pair.

Required Parameters

Plus time parameters.

  • origin (required) — 3-letter IATA airport code
  • destination (required) — 3-letter IATA airport code

Optional Parameters

Parameter Type Description
metrics string Comma-separated segment metrics, default all base
carrier string 2-letter carrier code
region string Region
  • A (Atlantic)
  • D (Domestic)
  • I (International)
  • L (Latin America)
  • P (Pacific)
  • S (System)
carrier_entity string Carrier entity code
aircraft_group int Aircraft group
  • 0 (Piston — 1 Engine / Combined Single Engine)
  • 1 (Piston — 2 Engine)
  • 2 (Piston — 3 or 4 Engine)
  • 3 (Helicopter / STOL)
  • 4 (Turboprop — 1 or 2 Engine)
  • 5 (Turboprop — 4 Engine)
  • 6 (Jet — 2 Engine)
  • 7 (Jet — 3 Engine)
  • 8 (Jet — 4 or 6 Engine)
  • 9 (Miscellaneous / Unattributed)
aircraft_type int Aircraft type code
aircraft_config int Aircraft configuration
  • 1 (Passenger)
  • 2 (Freight)
  • 3 (Combined Passenger and Freight)
distance_group int Distance band
  • 1 (Less Than 500 Miles)
  • 2 (500-999 Miles)
  • 3 (1000-1499 Miles)
  • 4 (1500-1999 Miles)
  • 5 (2000-2499 Miles)
  • 6 (2500-2999 Miles)
  • 7 (3000-3499 Miles)
  • 8 (3500-3999 Miles)
  • 9 (4000-4499 Miles)
  • 10 (4500-4999 Miles)
  • 11 (5000-5499 Miles)
  • 12 (5500-5999 Miles)
  • 13 (6000-6499 Miles)
  • 14 (6500-6999 Miles)
  • 15 (7000-7499 Miles)
  • 16 (7500-7999 Miles)
  • 17 (8000-8499 Miles)
  • 18 (8500-8999 Miles)
  • 19 (9000-9499 Miles)
  • 20 (9500-9999 Miles)
  • 21 (10000-10499 Miles)
  • 22 (10500-10999 Miles)
  • 23 (11000-11499 Miles)
  • 24 (11500-11999 Miles)
  • 25 (12000 Miles or More)
service_class string Service class
  • F (Scheduled Passenger/Cargo)
  • G (Scheduled All Cargo)
  • L (Non-Scheduled Civilian Passenger/Cargo)
  • P (Non-Scheduled Civilian All Cargo)
limit int Max rows returned (default 50, max 100)
limit_results bool Restrict to the most recent 12 months, default false

Example

Aggregated passenger and seat totals for ORD → SEA in June 2003.

  https://api.airstreamdata.com/traffic/segments/route?year=2003&month=6&origin=ORD&destination=SEA&metrics=passengers,seats
  
  {
    "meta": {
        "year": 2003,
        "month": 6,
        "metrics": ["passengers", "seats"],
        "origin": { "iata_code": "ORD", "name": "O'Hare International" },
        "destination": { "iata_code": "SEA", "name": "Seattle-Tacoma International" }
    },
    "result": {
        "passengers": { "value": 3844.0 },
        "seats": { "value": 5000.0 }
    }
}

Segment Breakdown 

  GET /traffic/segments/breakdown

Aggregated segment data grouped by one or more dimensions.

Required Parameters

Parameter Type Description
by string Comma-separated breakdown dimensions to group results by

Plus time parameters.

Optional Parameters

Parameter Type Description
metrics string Comma-separated segment metrics, default all base
carrier string Filter by carrier code
origin string Filter by origin airport
destination string Filter by destination airport
region string Region
  • A (Atlantic)
  • D (Domestic)
  • I (International)
  • L (Latin America)
  • P (Pacific)
  • S (System)
carrier_entity string Filter by carrier entity
aircraft_group int Aircraft group
  • 0 (Piston — 1 Engine / Combined Single Engine)
  • 1 (Piston — 2 Engine)
  • 2 (Piston — 3 or 4 Engine)
  • 3 (Helicopter / STOL)
  • 4 (Turboprop — 1 or 2 Engine)
  • 5 (Turboprop — 4 Engine)
  • 6 (Jet — 2 Engine)
  • 7 (Jet — 3 Engine)
  • 8 (Jet — 4 or 6 Engine)
  • 9 (Miscellaneous / Unattributed)
aircraft_type int Filter by aircraft type
aircraft_config int Aircraft configuration
  • 1 (Passenger)
  • 2 (Freight)
  • 3 (Combined Passenger and Freight)
distance_group int Distance band
  • 1 (Less Than 500 Miles)
  • 2 (500-999 Miles)
  • 3 (1000-1499 Miles)
  • 4 (1500-1999 Miles)
  • 5 (2000-2499 Miles)
  • 6 (2500-2999 Miles)
  • 7 (3000-3499 Miles)
  • 8 (3500-3999 Miles)
  • 9 (4000-4499 Miles)
  • 10 (4500-4999 Miles)
  • 11 (5000-5499 Miles)
  • 12 (5500-5999 Miles)
  • 13 (6000-6499 Miles)
  • 14 (6500-6999 Miles)
  • 15 (7000-7499 Miles)
  • 16 (7500-7999 Miles)
  • 17 (8000-8499 Miles)
  • 18 (8500-8999 Miles)
  • 19 (9000-9499 Miles)
  • 20 (9500-9999 Miles)
  • 21 (10000-10499 Miles)
  • 22 (10500-10999 Miles)
  • 23 (11000-11499 Miles)
  • 24 (11500-11999 Miles)
  • 25 (12000 Miles or More)
service_class string Service class
  • F (Scheduled Passenger/Cargo)
  • G (Scheduled All Cargo)
  • L (Non-Scheduled Civilian Passenger/Cargo)
  • P (Non-Scheduled Civilian All Cargo)
sort_by string Sort column, default first metric (single-period only)
sort_order string asc or desc, default desc (single-period only)
limit int Max results per month in range mode (default 25, max 50)
limit_results bool Restrict to the most recent 12 months, default false

Breakdown Dimensions

All dimensions support both single-period and multi-period queries. A dimension cannot be both a breakdown dimension and a filter in the same query.

Dimension Description
carrier Carrier
origin Origin airport
destination Destination airport
region Region
carrier_entity Carrier entity
aircraft_group Aircraft group
aircraft_type Aircraft type
aircraft_config Aircraft configuration
distance_group Distance band
service_class Service class

Example

The top origin airports by passengers for all segments arriving at ORD in March 2025.

  https://api.airstreamdata.com/traffic/segments/breakdown?year=2025&month=3&by=origin&destination=ORD&metrics=passengers
  
  {
    "meta": {
        "year": 2025,
        "month": 3,
        "breakdown_by": [
            "origin"
        ],
        "metrics": [
            "passengers"
        ],
        "count": 258,
        "sort_by": "passengers",
        "sort_order": "desc",
        "destination": {
            "airport_id": 13930,
            "iata_code": "ORD",
            "name": "Chicago O'Hare International",
            "city": "Chicago, IL",
            "state": "IL",
            "state_fips": "17",
            "country": "US",
            "world_area_code": 41,
            "latitude": 41.979,
            "longitude": -87.904
        }
    },
    "results": [
        {
            "origin": {
                "airport_id": 12953,
                "iata_code": "LGA",
                "name": "LaGuardia",
                "city": "New York, NY",
                "state": "NY",
                "state_fips": "36",
                "country": "US",
                "world_area_code": 22,
                "latitude": 40.777,
                "longitude": -73.872
            },
            "passengers": {
                "value": 99734.0,
                "share": 3.12
            }
        },
        {
            "origin": {
                "airport_id": 12892,
                "iata_code": "LAX",
                "name": "Los Angeles International",
                "city": "Los Angeles, CA",
                "state": "CA",
                "state_fips": "06",
                "country": "US",
                "world_area_code": 91,
                "latitude": 33.942,
                "longitude": -118.408
            },
            "passengers": {
                "value": 94123.0,
                "share": 2.94
            }
        },
    ...
    ]
}

Metrics

All base metrics (indicated in bold) will be returned by default.

Metric Description
passengers Number of passengers
seats Number of available seats
departures_performed Number of departures performed
freight Freight (pounds)
mail Mail (pounds)
distance Route distance (miles)
load_factor Passengers as a ratio of available seats
available_seat_miles Total seat-miles flown (seats × distance)
revenue_passenger_miles Total revenue passenger-miles (passengers × distance)
avg_stage_length Distance-weighted average stage length
departures_completion_rate Ratio of departures performed to departures scheduled
avg_seats_per_departure Average seats per departure performed
avg_passengers_per_departure Average passengers per departure performed

Markets

Route 

  GET /traffic/markets/route

Returns aggregated market metrics for a specific origin-destination pair.

Required Parameters

Plus time parameters.

  • origin (required) — 3-letter IATA airport code
  • destination (required) — 3-letter IATA airport code

Optional Parameters

Parameter Type Description
metrics string Comma-separated market metrics, default all base
carrier string 2-letter carrier code
region string Region
  • A (Atlantic)
  • D (Domestic)
  • I (International)
  • L (Latin America)
  • P (Pacific)
  • S (System)
carrier_entity string Carrier entity code
distance_group int Distance band
  • 1 (Less Than 500 Miles)
  • 2 (500-999 Miles)
  • 3 (1000-1499 Miles)
  • 4 (1500-1999 Miles)
  • 5 (2000-2499 Miles)
  • 6 (2500-2999 Miles)
  • 7 (3000-3499 Miles)
  • 8 (3500-3999 Miles)
  • 9 (4000-4499 Miles)
  • 10 (4500-4999 Miles)
  • 11 (5000-5499 Miles)
  • 12 (5500-5999 Miles)
  • 13 (6000-6499 Miles)
  • 14 (6500-6999 Miles)
  • 15 (7000-7499 Miles)
  • 16 (7500-7999 Miles)
  • 17 (8000-8499 Miles)
  • 18 (8500-8999 Miles)
  • 19 (9000-9499 Miles)
  • 20 (9500-9999 Miles)
  • 21 (10000-10499 Miles)
  • 22 (10500-10999 Miles)
  • 23 (11000-11499 Miles)
  • 24 (11500-11999 Miles)
  • 25 (12000 Miles or More)
service_class string Service class
  • F (Scheduled Passenger/Cargo)
  • G (Scheduled All Cargo)
  • L (Non-Scheduled Civilian Passenger/Cargo)
  • P (Non-Scheduled Civilian All Cargo)
limit int Max rows returned (default 50, max 100)
limit_results bool Restrict to the most recent 12 months, default false

Example

Aggregated passenger and freight totals for LAX → JFK in February 2025.

  https://api.airstreamdata.com/traffic/markets/route?year=2025&month=2&origin=LAX&destination=JFK&metrics=passengers,freight
  
  {
    "meta": {
        "year": 2025,
        "month": 2,
        "metrics": ["passengers", "freight"],
        "origin": { "iata_code": "LAX", "name": "Los Angeles International" },
        "destination": { "iata_code": "JFK", "name": "John F. Kennedy International" }
    },
    "result": {
        "passengers": { "value": 74022.0 },
        "freight": { "value": 3542145.0 }
    }
}

Market Breakdown 

  GET /traffic/markets/breakdown

Aggregated market data grouped by one or more dimensions.

Required Parameters

Parameter Type Description
by string Comma-separated breakdown dimensions to group results by

Plus time parameters.

Optional Parameters

Parameter Type Description
metrics string Comma-separated market metrics, default all base
carrier string Filter by carrier code
origin string Filter by origin airport
destination string Filter by destination airport
region string Region
  • A (Atlantic)
  • D (Domestic)
  • I (International)
  • L (Latin America)
  • P (Pacific)
  • S (System)
carrier_entity string Filter by carrier entity
distance_group int Distance band
  • 1 (Less Than 500 Miles)
  • 2 (500-999 Miles)
  • 3 (1000-1499 Miles)
  • 4 (1500-1999 Miles)
  • 5 (2000-2499 Miles)
  • 6 (2500-2999 Miles)
  • 7 (3000-3499 Miles)
  • 8 (3500-3999 Miles)
  • 9 (4000-4499 Miles)
  • 10 (4500-4999 Miles)
  • 11 (5000-5499 Miles)
  • 12 (5500-5999 Miles)
  • 13 (6000-6499 Miles)
  • 14 (6500-6999 Miles)
  • 15 (7000-7499 Miles)
  • 16 (7500-7999 Miles)
  • 17 (8000-8499 Miles)
  • 18 (8500-8999 Miles)
  • 19 (9000-9499 Miles)
  • 20 (9500-9999 Miles)
  • 21 (10000-10499 Miles)
  • 22 (10500-10999 Miles)
  • 23 (11000-11499 Miles)
  • 24 (11500-11999 Miles)
  • 25 (12000 Miles or More)
service_class string Service class
  • F (Scheduled Passenger/Cargo)
  • G (Scheduled All Cargo)
  • L (Non-Scheduled Civilian Passenger/Cargo)
  • P (Non-Scheduled Civilian All Cargo)
sort_by string Sort column, default first metric (single-period only)
sort_order string asc or desc, default desc (single-period only)
limit int Max results per month in range mode (default 25, max 50)
limit_results bool Restrict to the most recent 12 months, default false

Breakdown Dimensions

All dimensions support both single-period and multi-period queries. A dimension cannot be both a breakdown dimension and a filter in the same query.

Dimension Description
carrier Carrier
origin Origin airport
destination Destination airport
region Region
carrier_entity Carrier entity
distance_group Distance band
service_class Service class

Example

The breakdown of passengers by carrier on flights into DFW in April 2025.

  https://api.airstreamdata.com/traffic/markets/breakdown?year=2025&month=4&by=carrier&destination=DFW&metrics=passengers
  
  {
    "meta": {
        "year": 2025,
        "month": 4,
        "breakdown_by": [
            "carrier"
        ],
        "metrics": [
            "passengers"
        ],
        "count": 50,
        "sort_by": "passengers",
        "sort_order": "desc",
        "destination": {
            "airport_id": 11298,
            "iata_code": "DFW",
            "name": "Dallas/Fort Worth International",
            "city": "Dallas/Fort Worth, TX",
            "state": "TX",
            "state_fips": "48",
            "country": "US",
            "world_area_code": 74,
            "latitude": 32.896,
            "longitude": -97.037
        }
    },
    "results": [
        {
            "carrier": {
                "carrier_code": "AA",
                "carrier_name": "American Airlines Inc.",
                "airline_id": 19805
            },
            "passengers": {
                "value": 2151117.0,
                "share": 66.39
            }
        },
        {
            "carrier": {
                "carrier_code": "MQ",
                "carrier_name": "Envoy Air",
                "airline_id": 20398
            },
            "passengers": {
                "value": 344845.0,
                "share": 10.64
            }
        },
        {
            "carrier": {
                "carrier_code": "OO",
                "carrier_name": "SkyWest Airlines Inc.",
                "airline_id": 20304
            },
            "passengers": {
                "value": 117611.0,
                "share": 3.63
            }
        },
        {
            "carrier": {
                "carrier_code": "F9",
                "carrier_name": "Frontier Airlines Inc.",
                "airline_id": 20436
            },
            "passengers": {
                "value": 112620.0,
                "share": 3.48
            }
        },
        {
            "carrier": {
                "carrier_code": "DL",
                "carrier_name": "Delta Air Lines Inc.",
                "airline_id": 19790
            },
            "passengers": {
                "value": 111300.0,
                "share": 3.44
            }
        },
    ...
    ]
}

Metrics

All base metrics (indicated in bold) will be returned by default.

Metric Description
passengers Number of passengers
freight Freight (pounds)
mail Mail (pounds)
distance Route distance (miles)

Constraints

  • A dimension cannot be both a breakdown (by) and a filter in the same query.
  • Aircraft-related dimensions and filters (aircraft_group, aircraft_type, aircraft_config) are available on segment endpoints only, not market endpoints.
  • Range and specific-period queries are limited to 24 months total.
  • limit defaults and caps: single-period default 50 (max 100); multi-period default 25 (max 50). In range mode, limit applies per month.
  • limit_results=true restricts to the most recent 12 months.
  • sort_by and sort_order apply only in single-period mode. Range mode always ranks by the first requested metric descending.