Quickstart - Countries API

All successful country endpoints return a JSON array. Use field projection unless you need the full object.

List countries

curl "https://flags.robskan.nl/v1?fields=name,cca2,population,capital,currencies,flags"

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

Look up one country

curl "https://flags.robskan.nl/v1/alpha/nl?fields=name,cca2,flags"

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.

curl "https://flags.robskan.nl/v1/alpha/nl?fields=wikidataId,unRegionalGroup,enrichment.government,enrichment.computed"

Download a flag

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

curl -L "https://cdn.flags.robskan.nl/get/nl" -o nl.png
curl -L "https://cdn.flags.robskan.nl/get/svg/us" -o us.svg

Next

See pagination, field projection, or open the playground.