# REST Countries Countries API

**Canonical:** https://apis.io/apis/rest-countries/rest-countries-countries-api/  
**Provider:** REST Countries — https://apis.io/providers/rest-countries/  
**Base URL:** https://restcountries.com/v3.1  
**Documentation:** https://restcountries.com

REST Countries Countries API is one of 12 APIs that [REST Countries](https://apis.io/providers/rest-countries/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Countries. The published artifact set on APIs.io includes an OpenAPI specification.

Country lookup and search endpoints

## Operations (4)

| Method | Path | Summary |
|---|---|---|
| GET | `/` | List all countries |
| GET | `/{aggregate}` | Search within a named property aggregate |
| GET | `/{property}/{value}` | Exact-match lookup by property value |
| GET | `/{property}` | Substring search within a single property |

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/rest-countries/refs/heads/main/openapi/rest-countries-countries-api-openapi.yml

## Other REST Countries APIs (11)

- [REST Countries All API](https://apis.io/apis/rest-countries/rest-countries-all-api/)
- [REST Countries Alpha API](https://apis.io/apis/rest-countries/rest-countries-alpha-api/)
- [REST Countries Capital API](https://apis.io/apis/rest-countries/rest-countries-capital-api/)
- [REST Countries Currency API](https://apis.io/apis/rest-countries/rest-countries-currency-api/)
- [REST Countries Demonym API](https://apis.io/apis/rest-countries/rest-countries-demonym-api/)
- [REST Countries Independent API](https://apis.io/apis/rest-countries/rest-countries-independent-api/)
- [REST Countries Language API](https://apis.io/apis/rest-countries/rest-countries-language-api/)
- [REST Countries Name API](https://apis.io/apis/rest-countries/rest-countries-name-api/)
- [REST Countries Region API](https://apis.io/apis/rest-countries/rest-countries-region-api/)
- [REST Countries Subregion API](https://apis.io/apis/rest-countries/rest-countries-subregion-api/)
- [REST Countries Translation API](https://apis.io/apis/rest-countries/rest-countries-translation-api/)

## Tags

Countries

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/rest-countries/rest-countries-countries-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/rest-countries/.