# REST Countries

**Canonical:** https://apis.io/providers/rest-countries/  
**Website:** https://restcountries.com  
**APIs profiled:** 11

REST Countries is a free, open-source RESTful API that returns rich country reference data — ISO 3166-1 codes (cca2, cca3, ccn3, cioc), common/official and native names, translations, capitals, regions and subregions, continents, currencies, languages, calling codes, top-level domains, timezones, geographic coordinates, borders, area, population, demonyms, flags and coats of arms, postal code formats, Gini index, FIFA code, independence and UN membership status, driving side, and start of week. The canonical hosted instance runs at restcountries.com (v3.1) and the source is community-maintained at github.com/apilayer/restcountries (mirror of gitlab.com/restcountries/restcountries), licensed under MPL-2.0. The hosted API is unauthenticated and free; for production use the project encourages self-hosting from source.

## Kin Score — 46.4 / 100 (developing)

Scored 2026-08-20 under rubric 0.12.0. Trend: flat (+0.0 from 46.4).

| Facet | Score |
|---|---|
| Discoverability | 74.1 |
| Contract Quality | 68.0 |
| Governance | 25.0 |
| Contract Governance | 25.0 |
| Operational Transparency | 52.6 |
| Developer Ergonomics | 21.4 |
| Commercial Clarity | 39.5 |
| Access Clarity | 39.5 |

## Agent readiness — 41.8 (agent-ready)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | derived |
| Reversibility Documented | na |
| MCP Server | no |
| Auth Clarity | yes |
| Idempotency | na |
| Error Semantics | no |
| OpenAPI Examples | verified |
| Rate Limit Signal | documented |
| Event Surface Described | no |
| Agent Skills | no |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | na |

## Access

Free — onboarding: unknown, pricing: free, trial: no (confidence: medium).

## APIs (11)

- **REST Countries All API** — Bulk retrieval of every country in the dataset.
- **REST Countries Alpha API** — Lookup countries by ISO 3166-1 alpha-2, alpha-3, numeric, or CIOC code.
- **REST Countries Capital API** — Lookup countries by capital city.
- **REST Countries Currency API** — Lookup countries by ISO 4217 currency code or currency name.
- **REST Countries Demonym API** — Lookup countries by demonym (citizen designation).
- **REST Countries Independent API** — Lookup countries filtered by ISO 3166-1 independence status.
- **REST Countries Language API** — Lookup countries by ISO 639 language code or language name.
- **REST Countries Name API** — Lookup countries by common or official name.
- **REST Countries Region API** — Lookup countries within a UN geographic region.
- **REST Countries Subregion API** — Lookup countries within a UN geographic subregion.
- **REST Countries Translation API** — Lookup countries by translated name.

## Agentic access (1)

- **Rest Countries Agentic Access** — 12 operations

## Security (2)

- **Rest Countries Authentication** — apiKey/http · 2 schemes
- **Rest Countries Domain Security** — TLSv1.3 · DMARC

## Plans (1)

- **Rest Countries Plans Pricing**

## Tags

Countries, Geocoding, Geography, ISO 3166, Open-Source, Public APIs, Reference Data, Currency, Language, Capitals, Regions, Subregions, Translations

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/rest-countries/). Scores are computed from the provider's own public artifacts under a published rubric.