# The v3 API is deprecated

restcountries.com deprecated /v3* without giving a shutdown date yet.

The provider has deprecated the /v3* endpoints without a shutdown date. Affected calls will fail. Earlier iterations v1 through v4 were public iterations and have been deprecated in favor of later stable releases.

## What to use instead

Move v3 and v3.1 calls to the v5 service, such as /countries/v5/names.common/{name}, passing an API key in an Authorization Bearer header. The move requires more than changing an identifier, as field names changed in v5 and accessing v5 requires choosing an account tier to obtain an API key.

v5 needs an account and an API key (free tier, paid plans above it).

- API: restcountries.com (restcountries.com)
- Kind: Version retirement
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `/v3*`
- Source: [Announcement](https://restcountries.com/docs)
- Verified: October 27, 2026, against restcountries.com's own pages
- Page: https://www.okapi.bot/providers/restcountries-com/breaking-changes/the-v3-api-is-deprecated/

## restcountries.com's words

> The Countries API is currently at v5 , the first version we consider long-term stable ; versions v1 – v4 were public iterations and have been deprecated.

Okapi finds the calls this change hits in your repo and opens the pull request with the fix: https://github.com/apps/okapi-agent