← Everything we make

Reference · $0.007

Country Reference

Give it an ISO code, a country name, an official name or a dialling code, and it returns the canonical record. Perfect for agents handling country data typed by people, in any format.

Specification

Route
GET /country/resolve/{input}
Input
ISO-2, ISO-3, a common or official name, or a +dialling code. Falls back to a substring match.
Price
$0.007 per call on the PowaHub listing.

What it returns

  • iso2, iso3the canonical ISO codes
  • name, official_nameshort form and full official form
  • capitalcapital city
  • region, subregionUN region groupings
  • calling_codesinternational dialling prefixes

Live response

{
  "status": "success",
  "status_code": 200,
  "errors": [],
  "data": {
    "country": {
      "iso2": "DE",
      "iso3": "DEU",
      "name": "Germany",
      "official_name": "Federal Republic of Germany",
      "capital": "Berlin",
      "region": "Europe",
      "subregion": "Western Europe",
      "calling_codes": ["+49"]
    }
  },
  "meta": {
    "source": "https://raw.githubusercontent.com/mledoze/countries/master/countries.json",
    "generated_at": "2026-10-01T04:00:05.910159+00:00",
    "record_count": 250
  }
}

Captured from the live service at each release · 2026-10-14 10:02 UTC

Measured

Records held
250
Read from meta.record_count at build.

Provenance

Upstream
The mledoze/countries open dataset.
Licence
Open Database License (ODbL) v1.0
Refresh
Rebuilt quarterly, 04:00 UTC on 1 January, April, July and October.
Rebuilt
QuarterlyFrom the refresh schedule that actually runs.

Contains information from mledoze/countries, made available under the Open Database License (ODbL) v1.0

Good to know

  • Built for normalising and displaying country data, whatever form the input arrives in.
  • Resolves partial names too, returning the closest match.

Where to buy

Endpoint
api.powahub.ai/CertainData/country-lookup/{input}
Available on
PowaHub.