{"slug":"restcountries-com","name":"restcountries.com","host":"restcountries.com","site":"https://restcountries.com","category":"data","docsUrl":null,"sources":[{"kind":"archive","url":"https://restcountries.com/docs"}],"url":"https://www.okapi.bot/providers/restcountries-com/","json":"https://www.okapi.bot/api/v1/providers/restcountries-com.json","breakingChanges":[{"slug":"the-v2-api-is-deprecated","api":"restcountries-com","title":"The v2 API is deprecated","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["/v2/*"],"method":null,"path":"/v2/*","source":{"url":"https://restcountries.com/docs","kind":"archive"},"quote":"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.","migration":"Call https://api.restcountries.com/countries/v5 (for example /countries/v5/names.common/{name}) with an API key in an Authorization: Bearer header; field names changed in v5.","migrationChange":null,"needsDecision":"v5 needs an account and an API key (free tier, paid plans above it).","text":{"summary":"The provider deprecated the v2 API without a shutdown date. This deprecation affects all /v2/* requests, which will eventually fail. The provider stated that earlier versions were public iterations and have been deprecated in favor of v5.","migration":"Migrate your calls to api.restcountries.com/countries/v5, such as /countries/v5/names.common/{name}. The move requires more than changing an address, as field names changed in v5 and you must choose an account plan to obtain an API key for the Authorization Bearer header.","by":"writer"},"publishedAt":"2026-10-26T16:26:50.711Z","updatedAt":"2026-10-27T00:37:18.419Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/restcountries-com/breaking-changes/the-v2-api-is-deprecated/"},{"slug":"the-v3-api-is-deprecated","api":"restcountries-com","title":"The v3 API is deprecated","kind":"version_retirement","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["/v3*"],"method":null,"path":"/v3*","source":{"url":"https://restcountries.com/docs","kind":"archive"},"quote":"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.","migration":"Move v3 and v3.1 calls to https://api.restcountries.com/countries/v5 (for example /countries/v5/names.common/{name}) with an API key in an Authorization: Bearer header; field names changed in v5.","migrationChange":null,"needsDecision":"v5 needs an account and an API key (free tier, paid plans above it).","text":{"summary":"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.","migration":"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.","by":"writer"},"publishedAt":"2026-10-26T16:26:50.711Z","updatedAt":"2026-10-27T00:37:17.841Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/restcountries-com/breaking-changes/the-v3-api-is-deprecated/"}]}