Skip to main content
Most country routes return a JSON array (0–5 items per request). GET /v1/current is the exception: it returns a single country object. Use field projection unless you need the full object.

​
List countries

Responses include at most five countries. Add offset=5 (or page=1) for the next slice. See pagination and endpoints.

​
Look up one country

​
Caller’s country (geo)

On production (Vercel), GET /v1/current uses edge geo headers. Locally you may get 404 without a geo header.

​
Wikidata enrichment

Build-time Wikidata data lives under enrichment (economics, development, government, optional company, computed metrics). Stable ids wikidataId and unRegionalGroup are top-level. Use dot paths to avoid downloading translations and maps.

​
Download a flag

Follow redirects (-L). The CDN hides ISO codes behind hashed filenames.

​
Next

See filter routes, field projection, or OpenAPI.