> ## Documentation Index
> Fetch the complete documentation index at: https://flags.robskan.nl/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Make your first request in a minute.

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

## List countries

```bash theme={null}
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

```bash theme={null}
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.

```bash theme={null}
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.

```bash theme={null}
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](/docs/pagination), [field projection](/docs/fields), or open the [playground](/docs/api).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.