ISO 3166 · DE-BY · 92,000+ CITIES

Geographic data

Select a country to load its subdivisions — states, provinces, departments — then a subdivision to load its cities. Every option in these selects arrives from the live API. Free, no key required.

INPUT · COUNTRY → SUBDIVISION → CITY

0 countries available

0 subdivisions available

0 cities available

RESULT · CURRENT SELECTION

No selections made yet

TELEMETRY · ROUND TRIP

  • Countries: —ms
  • Subdivisions: —ms
  • Cities: —ms

CACHE CONTRACT

  • Cache headers: 1 year, immutable
  • ETags: enabled
  • CDN-friendly responses
GET /api/v1/countries Free · no key 
// Free endpoint — no API key needed
const res = await fetch('https://matrixapi.dev/api/v1/countries');
const { countries } = await res.json();

// Subdivisions when country changes
const subs = await fetch(`https://matrixapi.dev/api/v1/countries/${iso2}/subdivisions`);

// Cities when subdivision changes
const cities = await fetch(`https://matrixapi.dev/api/v1/cities?country=${iso2}&state=${subdivCode}`);