GET/api/v6/tools/countries/{code}

Get a country

One country by its ISO 3166-1 alpha-2 code.

Scope

Any valid API key

Usage limit

60 requests per minute

Returns one country by its ISO 3166-1 alpha-2 code (2 letters, case-insensitive).

Path parameters

code

stringrequired

ISO 3166-1 alpha-2 country code (CO, MX, US...). Case-insensitive.

Query parameters

lang

stringoptional

ISO-639-1 locale. Returns a flat name in that locale instead of the full names map.

enes

Responses

200

Country data.

{
  "success": true,
  "data": {
    "code": "CO",
    "code3": "COL",
    "callingCode": "57",
    "mcc": "732",
    "flag": "https://flagcdn.com/co.svg",
    "name": "Colombia"
  },
  "meta": {
    "requestId": "b9b1704baffab21150213c02fd853975",
    "timestamp": "2026-05-23T02:00:00+00:00",
    "responseTimeMs": 2.1
  }
}

401

Invalid or missing credentials.

404

No country exists with that code.

{
  "success": false,
  "error": {
    "code": "COUNTRY_NOT_FOUND",
    "type": "https://developers.hablame.co/docs/v6/errors/country-not-found",
    "message": "No country was found with the supplied code. Use the ISO 3166-1 alpha-2 form (e.g. `CO`, `US`).",
    "details": []
  },
  "meta": {
    "requestId": "b9b1704baffab21150213c02fd853975",
    "timestamp": "2026-05-23T02:00:00+00:00",
    "responseTimeMs": 1.4
  }
}

429

Request limit exceeded.

Possible errors

Codes this endpoint can return in error.code. The full detail lives in the catalog.

401AUTH_REQUIREDNo Bearer token was sent, and every call requires one.401AUTH_INVALID_KEYThe API key is not recognized: wrong format, revoked or expired.404COUNTRY_NOT_FOUNDNo country exists with that code.429RATE_TPS_EXCEEDEDYou exceeded your organization quota for this endpoint.

See the full catalog

Scope and limits

Path parameters

Query parameters

Responses

Possible errors