/countries

List countries

Reference facts for every country: capitals, population, area, currencies, official languages and national anthem. Ordered by ISO code. Fetch a country's leaders with `/members?country={code}`. Facts are structured values only. A field is omitted when no current value is established — for example, a country with no single official language at the national level has no `officialLanguages`.

Parameters

name	type	required	description
pagequery	integerdefault 1	—	Page number for pagination
limitquery	integerdefault 250	—	Results per page (1–1000)

Example

curl

curl "https://civiclens.io/api/v1/countries?limit=5"

200 response

{
  "data": [
    {
      "code": "ad",
      "name": "Andorra",
      "lastUpdated": "2026-09-24T19:28:56.830Z",
      "capitals": [
        "Andorra la Vella"
      ],
      "population": 89752,
      "populationYear": 2026,
      "areaKm2": 468,
      "currencies": [
        {
          "code": "EUR",
          "name": "euro"
        }
      ],
      "officialLanguages": [
        "Catalan"
      ],
      "anthems": [
        "El gran Carlemany"
      ]
    },
    {
      "code": "ae",
      "name": "United Arab Emirates",
      "lastUpdated": "2026-09-24T19:28:56.830Z",
      "capitals": [
        "Abu Dhabi"
      ],
      "population": 9890400,
      "populationYear": 2020,
      "areaKm2": 83600,
      "currencies": [
        {
          "code": "AED",
          "name": "United Arab Emirates dirham"
        }
      ],
      "officialLanguages": [
        "Arabic"
      ],
      "anthems": [
        "Ishy Bilady"
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 5,
    "total": 203,
    "hasMore": true
  },
  "meta": {
    "lastUpdated": "2026-10-31T03:18:41.546Z"
  }
}

A live response, trimmed to the first records. sourceUrl values are shown redacted in documentation; the API returns the full value.

Responses

200Countries

400Bad request - invalid parameters

500Internal server error

Try it

PlaygroundLive responses from the real API

endpoint

query

curl

curl "https://civiclens.io/api/v1/countries?limit=5"