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

Obtener un país

Datos de un país por su código ISO 3166-1 alpha-2.

Alcance

Cualquier API key válida

Límite de uso

60 solicitudes por minuto

Devuelve los datos de un país por su código ISO 3166-1 alpha-2 (2 letras, sin distinguir mayúsculas).

Parámetros de ruta

code

stringobligatorio

Código ISO 3166-1 alpha-2 del país (CO, MX, US...). No distingue mayúsculas.

Parámetros de consulta

lang

stringopcional

Código ISO-639-1. Devuelve name plano en ese idioma en vez del mapa completo names.

enes

Respuestas

200

Datos del país.

{
  "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

Credenciales inválidas o faltantes.

404

No existe un país con ese código.

{
  "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

Se excedió el límite de solicitudes.

Errores posibles

Códigos que este endpoint puede devolver en error.code. El detalle completo está en el catálogo.

401AUTH_REQUIREDNo se envió un token Bearer y cada llamada lo requiere.401AUTH_INVALID_KEYLa API key no se reconoce: formato equivocado, revocada o vencida.404COUNTRY_NOT_FOUNDNo existe un país con ese código.429RATE_TPS_EXCEEDEDExcediste el cupo de tu organización para este endpoint.

Ver el catálogo completo

Alcance y límites

Parámetros de ruta

Parámetros de consulta

Respuestas

Errores posibles