REST Countries website screenshot

REST Countries

Free REST API providing comprehensive data about world countries including name, capital, currencies, languages, flags, population, and geographic information. Covers 250+ countries and dependencies with 80+ fields per country, updated from 35+ authoritative sources.

REST Countries publishes 1 API on the APIs.io network: Countries API. Tagged areas include Countries, Geography, World Data, Flags, and Currencies.

The REST Countries catalog on APIs.io includes 2 JSON-LD contexts and 1 Spectral governance ruleset.

REST Countries’ developer surface includes authentication, documentation, pricing, and 8 more developer resources.

🌐 Visit website 📡 Source on GitHub
53.8/100 developing ▬ flat Agent 31/100 agent aware Full breakdown ↓
scored 2026-08-05 · rubric v0.9.1
AccessFreemiumSelf serve⚡ Free to try
1 APIs
CountriesGeographyWorld DataFlagsCurrenciesLanguagesPopulation

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-05 · rubric v0.9.1
Composite quality — 53.8/100 · developing
Contract Quality 19.2 / 25
Developer Ergonomics 3.9 / 20
Commercial Clarity 10.0 / 20
Operational Transparency 6.8 / 13
Governance 7.0 / 12
Discoverability 6.9 / 10
Agent readiness — 31/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/restcountries: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 1

Individual APIs this provider publishes, each with its own machine-readable definition.

REST Countries Countries API

Country lookup and search endpoints

Pricing Plans 1

Published pricing tiers and plan structures.

Restcountries Plans Pricing

5 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Restcountries Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Restcountries Finops

FINOPS

Semantic Vocabularies 2

JSON-LD contexts and semantic vocabularies used across these APIs.

Restcountries Api Context

0 classes · 0 properties

JSON-LD

Restcountries Context

2 classes · 64 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

REST Countries API Rules

5 rules · 4 warnings 1 info

SPECTRAL

JSON Schema 3

Standalone JSON Schema definitions for this provider's data models.

CountriesListResponse

1 properties

JSON SCHEMA

Country

29 properties

JSON SCHEMA

ErrorResponse

1 properties

JSON SCHEMA

Examples 4

Example request and response payloads for these APIs.

Error 401 Unauthorized

1 fields

EXAMPLE

List All Countries Response

1 fields

EXAMPLE

Lookup By Alpha2 Code Response

1 fields

EXAMPLE

Search By Name Response

1 fields

EXAMPLE

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Restcountries Authentication

apiKey/http · 2 schemes

SECURITY

Restcountries Domain Security

TLSv1.3 · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Restcountries Agentic Access

4 operations

4 operations · 0 acting

AGENTIC

Resources

Documentation 1

Reference material describing how the API behaves

Documentation
Documentation

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrg
GitHubOrg

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity
 Authentication
Authentication

Operate 2

Status, limits, changes, and where to get help

StatusPage
StatusPage
 RateLimits
RateLimits

Commercial 3

Pricing, plans, and the legal terms of use

Pricing
Pricing
 Plans
Plans
 FinOps
FinOps

Company 1

The organization behind the API

Website
Website

Source (apis.yml)

apis.yml Raw ↑ 
aid: restcountries
name: REST Countries
description: Free REST API providing comprehensive data about world countries including name, capital, currencies, languages,
  flags, population, and geographic information. Covers 250+ countries and dependencies with 80+ fields per country, updated
  from 35+ authoritative sources.
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/restcountries.png
url: https://raw.githubusercontent.com/api-evangelist/restcountries/refs/heads/main/apis.yml
created: '2026-06-13'
modified: '2026-06-13'
specificationVersion: '0.19'
type: Index
tags:
- Countries
- Geography
- World Data
- Flags
- Currencies
- Languages
- Population
apis:
- aid: restcountries:restcountries-countries-api
  name: REST Countries Countries API
  description: Country lookup and search endpoints
  humanURL: https://restcountries.com
  baseURL: https://api.restcountries.com/countries/v5
  tags:
  - Countries
  properties:
  - type: OpenAPI
    url: openapi/restcountries-countries-api-openapi.yml
  - type: Documentation
    url: https://restcountries.com/docs
  - type: JSONSchema
    url: json-schema/country.json
  - type: JSONSchema
    url: json-schema/countries-list-response.json
  - type: JSONSchema
    url: json-schema/error-response.json
  - type: JSONLDContext
    url: json-ld/restcountries-context.jsonld
  - type: JSONLD
    url: json-ld/restcountries-api.jsonld
  - type: Vocabulary
    url: vocabulary/restcountries-vocabulary.yml
  - type: Plans
    url: plans/restcountries-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/restcountries-rate-limits.yml
  - type: FinOps
    url: finops/restcountries-finops.yml
  - type: StatusPage
    url: https://status.restcountries.com
common:
- type: AgenticAccess
  url: agentic-access/restcountries-agentic-access.yml
- type: DomainSecurity
  url: security/restcountries-domain-security.yml
- type: Authentication
  url: authentication/restcountries-authentication.yml
- type: Website
  url: https://restcountries.com
- type: Documentation
  url: https://restcountries.com/docs
- type: GitHubOrg
  url: https://github.com/apilayer/restcountries
- type: Pricing
  url: https://restcountries.com/plans
- type: StatusPage
  url: https://status.restcountries.com
- type: Plans
  url: plans/restcountries-plans-pricing.yml
- type: RateLimits
  url: rate-limits/restcountries-rate-limits.yml
- type: FinOps
  url: finops/restcountries-finops.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com