REST · JSON · IMMUTABLE CACHE

Structured data for the physical world.

Countries, subdivisions, and cities. Airports with IATA and ICAO codes. The NHTSA vehicle catalog. Live local events across the US. One REST API, built to be cached.

Get a free API key Read the docs

Geographic and currency data need no key at all.

GET /api/v1/countries/de 200 · public, immutable 
{
  "name": "Germany",
  "iso2": "DE",
  "iso3": "DEU",
  "capital": "Berlin",
  "currency": "EUR",
  "region": "Europe",
  "subdivisions": 16,
  "coordinates": [51.16, 10.45]
}
countries
250
subdivisions
5,134
cities
92,000+
airports
67,000+
live events
10,000+

DATA LAYERS

Five datasets, one consistent API.

51.16°N 10.45°E · DE

Geography

250 countries with ISO codes, currencies, and languages. 5,134 subdivisions and 92,000+ cities with coordinates — browsable by code or by human-readable name.

/api/v1/countries/{code}

Free · no key Try the geo demo

ISO 4217

Currencies

Currency codes, names, and symbols, cross-referenced with every country that uses them.

/api/v1/currencies/{code}

Free · no key Read the docs

33.94°N 118.41°W · LAX

Airports

67,000+ airports, heliports, and seaplane bases with IATA/ICAO codes, elevation, and coordinates. Radius search included.

/api/v1/airports/iata/{code}

API key Open the airport map

NHTSA · VPIC

Vehicles

Every make, model, and model year in the NHTSA catalog — cars, trucks, MPVs, and motorcycles, filterable by year, type, and country of origin.

/api/v1/vehicles/{year}/{make}

API key Try the vehicle picker

39.41°N 77.41°W · US

Local events

10,000+ upcoming community events across the US, refreshed continuously from local sources — searchable by location, date, category, and keyword.

/api/v1/events?lat={lat}&lng={lng}

API key Read the docs

PLATFORM

  • Cache-friendly by design. Free geographic and currency endpoints send 1-year immutable cache headers; keyed endpoints cache privately. Every response is also memoized server-side, so identical calls never recompute.
  • Fair limits. 120 requests per minute per key — plenty when responses cache this hard.
  • Machine-readable. Full OpenAPI 3.1 spec for codegen and tooling.

QUICKSTART

First call in under a minute.

  1. 01

    Create an account

    Sign up and your key is issued instantly — it's on your dashboard, prefixed mx_live_.

  2. 02

    Send the header

    Pass the key as X-API-Key on vehicles, airports, and events. Geo and currencies work without it.

    curl https://matrixapi.dev/api/v1/vehicles \
  -H "X-API-Key: mx_live_…"

  3. 03

    Cache the answer

    Free endpoints respond with public, immutable — put a CDN in front and most calls never reach us. Keyed endpoints cache privately, and every response is memoized on our side either way.

Put the world in your app.

Start with the free geographic endpoints, add a key when you need vehicles, airports, or events.

Get a free API key Check API status