Free plan — no credit card required

Countries REST API

Access structured data for 250+ countries — names, ISO codes, capitals, regions, flags, timezones, languages, and currencies in one endpoint.

Start Free Trial View API Docs

Free plan forever. First 14 days: full access to all features.

Try it in seconds

One GET request. Structured JSON back. No parsing gymnastics required.

GET api.apogeoapi.com/v1/countries/AR

# Request
curl https://api.apogeoapi.com/v1/countries/AR \
  -H "X-API-Key: your_api_key"

# Response
{
  "iso2": "AR",
  "iso3": "ARG",
  "name": "Argentina",
  "capital": "Buenos Aires",
  "region": "Americas",
  "subregion": "South America",
  "population": 45195774,
  "flag_url": "https://flagcdn.com/ar.svg",
  "currencies": [{ "code": "ARS", "name": "Argentine Peso" }],
  "languages": [{ "name": "Spanish" }]
}

Returns full country object · Add ?fields= to select specific fields

Available fields

Every country response includes the following fields.

Field	Type	Description
`iso2`	string	2-letter ISO 3166-1 alpha-2 country code (e.g. AR)
`iso3`	string	3-letter ISO 3166-1 alpha-3 country code (e.g. ARG)
`name`	string	Official country name in English
`capital`	string	Name of the capital city
`region`	string	Broad region (Americas, Europe, Asia, Africa, Oceania)
`subregion`	string	Sub-regional classification (e.g. South America)
`population`	number	Estimated population count
`flag_url`	string	SVG flag URL from flagcdn.com
`currencies`	array	List of currency objects with code and name
`languages`	array	List of language objects with name
`timezones`	array	IANA timezone identifiers for the country

Why use ApogeoAPI for countries data?

Built for developers who need reliable geographic data without operational overhead.

250+ Countries

Complete coverage of every recognized sovereign state and territory, including ISO codes, flags, and administrative data.

Always Updated

Flags, populations, currencies, and administrative boundaries are continuously maintained to reflect current data.

One API for Everything

Countries, cities, exchange rates, and IP geolocation — one subscription, one API key, one HTTP client integration.

Start building with the Countries API

Free plan forever. No credit card required. Up and running in under 5 minutes.

Start Free Trial — No credit card required

Frequently asked questions

Is the countries API free?

Yes. The Free plan includes countries and states with 1,000 requests per month — no credit card required. Every new account also gets a 14-day trial with full access to all premium features including cities, IP geolocation, and live exchange rates.

How often is country data updated?

Country data is continuously maintained. Flags, populations, currencies, and administrative data are updated regularly to reflect current information.

Can I filter countries by region?

Yes. Use GET /v1/countries?region=Europe to filter by region. Supported values: Africa, Americas, Asia, Europe, Oceania.