Roadmap
Here's where we're pointing REST Countries next. These are directions we're exploring, not dated commitments. Items move between groups as priorities shift. If one of these matters to you, tell us on support and we'll weigh it accordingly.
A machine-readable OpenAPI description of every endpoint, parameter, and response shape, so you can generate clients, import the API into tools like Postman or Insomnia, and get editor autocomplete without hand-wiring requests.
Additional economic indicators on each country (figures like GDP and GDP per capita), expanding the dataset beyond the geographic and political fields available today.
Structured image assets for current country leaders, including portraits and source metadata where available, so applications can display leader profiles without maintaining their own media lookup pipeline.
An openly available country dataset, carrying on the spirit of what REST Countries offered before. We're still working out the shape of it, but it'll be free to use for non-commercial projects.
An interactive console in your account for sending live requests to any endpoint: pick a key, set parameters, and see the real response without leaving the dashboard or writing a single line of code.
Usage analytics broken out by API key in your dashboard: request volume over time, status-code mix, and top endpoints, so you can see which key is driving traffic and spot anomalies at a glance.
More dedicated regional endpoints beyond the existing EU option, to lower latency for clients outside North America and Europe.
A Model Context Protocol server so AI assistants and agents can query country data directly as a tool, pulling live values from the API without custom integration code.
Thin, typed clients over the REST API so you don't hand-roll HTTP and auth. Currently in early access. Email us to join the beta.
The Node SDK delivered as a simple @rest-countries
library you can pull straight into your project with npm: install,
import, and call endpoints, no HTTP or auth wiring of your own.
Wildcard matching for per-key CORS controls, so a key can allow patterns
like *.example.com without listing each
subdomain individually.
Past values for dynamic fields like population and leaders, so you can query a country as it was on a given date instead of only the current value.
Expose where each property's value came from, so a response can tell you not just a country's population, leaders, or GDP but the source behind it, and how that value has changed over time, including the different source at each change. Most useful for the figures that move often, like Gini coefficient, population, leaders, and economic data.
Point-in-time static snapshots of the full country dataset for accredited academic research and enterprise integrations, licensed separately from the live API. Today the API is the only delivery method.
In-place rotation of a webhook's signing secret with an overlap window, so you can roll a secret without dropping in-flight deliveries.