Country.io website screenshot

Country.io

Country.io is a small open data project that publishes a set of static JSON files mapping ISO 3166-1 alpha-2 country codes to common reference data: country names, capital cities, ISO 3166-1 alpha-3 codes, continent codes, international telephone dialing prefixes, and ISO 4217 currency codes. The files are commonly consumed as a lightweight country-data dataset for forms, country pickers, and analytics enrichment.

Country.io publishes 6 APIs on the APIs.io network, including Capitals API, Continents API, Currency API, and 3 more. Tagged areas include Capitals, Continents, Countries, Currencies, and Currency Codes.

The Country.io catalog on APIs.io includes 1 Spectral governance ruleset.

🌐 Visit website 📡 Source on GitHub
33.6/100 thin ▬ flat Agent 28/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemium
6 APIs
CapitalsContinentsCountriesCurrenciesCurrency CodesDialing CodesGeographyISO 3166JSONOpen DataPhone CodesReference Data

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 33.6/100 · thin
Contract Quality 12.7 / 25
Developer Ergonomics 0.0 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 4.1 / 13
Governance 3.8 / 12
Discoverability 7.4 / 10
Agent readiness — 28/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 0 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 7 / 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/country-io: 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 6

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

Country.io Capitals API

Capital cities by ISO2 code.

Country.io Continents API

Continent codes by ISO2 country code.

Country.io Currency API

Currency codes by ISO2 country code.

Country.io ISO3 API

ISO 3166-1 alpha-3 codes by ISO2 country code.

Country.io Names API

Country names by ISO2 code.

Country.io Phone API

International dialing codes by ISO2 country code.

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Country.io Data API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Country Io Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Country Io Rate Limits

5 limits

RATE LIMITS

FinOps 1

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

Country Io Finops

FINOPS

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Country.io API Rules

7 rules · 6 errors 1 warnings

SPECTRAL

Security Posture 1

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

Country Io Domain Security

TLSv1.3

SECURITY

Agentic Access 1

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

Country Io Agentic Access

6 operations

6 operations · 0 acting

AGENTIC

Resources

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Design & Contract 1

Pagination, idempotency, versioning, errors, and events

Vocabulary
Vocabulary

Access & Security 1

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity

Operate 1

Status, limits, changes, and where to get help

Contact
Contact

Company 1

The organization behind the API

Website
Website

Other 3

Properties that don't map to a standard resource type

Data
Data
 Countries
Countries
 Rankings
Rankings

Source (apis.yml)

apis.yml Raw ↑ 
aid: country-io
name: Country.io
kind: company
description: 'Country.io is a small open data project that publishes a set of static JSON files mapping ISO 3166-1 alpha-2
  country codes to common reference data: country names, capital cities, ISO 3166-1 alpha-3 codes, continent codes, international
  telephone dialing prefixes, and ISO 4217 currency codes. The files are commonly consumed as a lightweight country-data dataset
  for forms, country pickers, and analytics enrichment.'
url: https://raw.githubusercontent.com/api-evangelist/country-io/refs/heads/main/apis.yml
accessModel:
  pricing: freemium
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Freemium
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/country-io.png
type: Index
access: Public
position: Provider
tags:
- Capitals
- Continents
- Countries
- Currencies
- Currency Codes
- Dialing Codes
- Geography
- ISO 3166
- JSON
- Open Data
- Phone Codes
- Reference Data
created: '2025-02-21'
modified: '2026-05-19'
specificationVersion: '0.20'
apis:
- aid: country-io:country-io-capitals-api
  name: Country.io Capitals API
  description: Capital cities by ISO2 code.
  humanURL: https://country.io/data/
  baseURL: https://country.io
  tags:
  - Capitals
  properties:
  - type: OpenAPI
    url: openapi/country-io-capitals-api-openapi.yml
  - type: Documentation
    url: https://country.io/data/
  - type: Rules
    url: rules/country-io-data-rules.yml
  - type: Capabilities
    url: capabilities/country-io-data-capabilities.yml
- aid: country-io:country-io-continents-api
  name: Country.io Continents API
  description: Continent codes by ISO2 country code.
  humanURL: https://country.io/data/
  baseURL: https://country.io
  tags:
  - Continents
  properties:
  - type: OpenAPI
    url: openapi/country-io-continents-api-openapi.yml
  - type: Documentation
    url: https://country.io/data/
  - type: Rules
    url: rules/country-io-data-rules.yml
  - type: Capabilities
    url: capabilities/country-io-data-capabilities.yml
- aid: country-io:country-io-currency-api
  name: Country.io Currency API
  description: Currency codes by ISO2 country code.
  humanURL: https://country.io/data/
  baseURL: https://country.io
  tags:
  - Currency
  properties:
  - type: OpenAPI
    url: openapi/country-io-currency-api-openapi.yml
  - type: Documentation
    url: https://country.io/data/
  - type: Rules
    url: rules/country-io-data-rules.yml
  - type: Capabilities
    url: capabilities/country-io-data-capabilities.yml
- aid: country-io:country-io-iso3-api
  name: Country.io ISO3 API
  description: ISO 3166-1 alpha-3 codes by ISO2 country code.
  humanURL: https://country.io/data/
  baseURL: https://country.io
  tags:
  - ISO3
  properties:
  - type: OpenAPI
    url: openapi/country-io-iso3-api-openapi.yml
  - type: Documentation
    url: https://country.io/data/
  - type: Rules
    url: rules/country-io-data-rules.yml
  - type: Capabilities
    url: capabilities/country-io-data-capabilities.yml
- aid: country-io:country-io-names-api
  name: Country.io Names API
  description: Country names by ISO2 code.
  humanURL: https://country.io/data/
  baseURL: https://country.io
  tags:
  - Names
  properties:
  - type: OpenAPI
    url: openapi/country-io-names-api-openapi.yml
  - type: Documentation
    url: https://country.io/data/
  - type: Rules
    url: rules/country-io-data-rules.yml
  - type: Capabilities
    url: capabilities/country-io-data-capabilities.yml
- aid: country-io:country-io-phone-api
  name: Country.io Phone API
  description: International dialing codes by ISO2 country code.
  humanURL: https://country.io/data/
  baseURL: https://country.io
  tags:
  - Phone
  properties:
  - type: OpenAPI
    url: openapi/country-io-phone-api-openapi.yml
  - type: Documentation
    url: https://country.io/data/
  - type: Rules
    url: rules/country-io-data-rules.yml
  - type: Capabilities
    url: capabilities/country-io-data-capabilities.yml
common:
- type: AgenticAccess
  url: agentic-access/country-io-agentic-access.yml
- type: DomainSecurity
  url: security/country-io-domain-security.yml
- type: Website
  url: https://country.io/
- type: Data
  url: https://country.io/data/
- type: Countries
  url: https://country.io/countries/
- type: Rankings
  url: https://country.io/rankings/
- type: Contact
  url: https://country.io/contact/
- type: Vocabulary
  url: vocabulary/country-io-vocabulary.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com