# Countries API

> Read-only countries JSON API and flag CDN at flags.robskan.nl (docs).

- [Introduction](https://docs.reqi.dev/index.md): Read-only countries JSON API and flag CDN.
- [Quickstart](https://docs.reqi.dev/quickstart.md): Make your first request in a minute.
- [Base URLs](https://docs.reqi.dev/base-url.md): API, CDN, health, and machine-readable docs.
- [Pagination](https://docs.reqi.dev/pagination.md): limit, offset, page, random, and seed headers.
- [Field projection](https://docs.reqi.dev/fields.md): Comma-separated fields, dot paths, and fields=*.
- [Errors](https://docs.reqi.dev/errors.md): JSON error envelope for 400 and 404.
- [API playground](https://docs.reqi.dev/api.md): Try endpoints in the browser against the live API.
- [Flag CDN](https://docs.reqi.dev/flags.md): PNG/SVG redirects to opaque hashed filenames.
- [Country object](https://docs.reqi.dev/schema.md): Fields returned on each country record.
- [LLMs](https://docs.reqi.dev/llms.md): How agents should read /llms.txt and OpenAPI.
- [Sources and licenses](https://docs.reqi.dev/data.md): mledoze, Wikidata enrichment, UN groups map, and flag-icons.

## OpenAPI Specs

- [openapi.min](https://gist.githubusercontent.com/Robskan/d42b771f956aa6733647d7dd99a92064/raw/openapi.min.json)


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