GET/api/v6/tools/countries

Listar países

Catálogo completo de países con código ISO, código telefónico y MCC.

Alcance

Cualquier API key válida

Límite de uso

60 solicitudes por minuto

Devuelve el catálogo completo de países que la API conoce, con su código ISO, código telefónico, MCC móvil y nombres en inglés y español. Úsalo para renderizar selectores de país, autodetectar el país a partir de un prefijo o resolver MCCs.

El catálogo cambia raras veces. La respuesta incluye Cache-Control: public, max-age=3600 para que tu cliente y cualquier CDN intermedio amortigüen el tráfico.

Idiomas

Los nombres se ofrecen solo en inglés (en) y español (es). Cualquier otro valor de lang cae a inglés.

Parámetros de consulta

lang

stringopcional

Código ISO-639-1. Cuando se especifica, cada país devuelve name plano en ese idioma en vez del mapa completo names.

enes

callingCode

stringopcional

Filtra países por código telefónico E.164 (por ejemplo 57 para Colombia). Acepta un + inicial opcional.

search

stringopcional

Búsqueda por subcadena, sin distinguir mayúsculas, sobre el nombre del país en el idioma solicitado. Mínimo 2 caracteres.

Respuestas

200

Catálogo de países.

{
  "success": true,
  "data": [
    {
      "code": "CO",
      "code3": "COL",
      "callingCode": "57",
      "mcc": "732",
      "flag": "https://flagcdn.com/co.svg",
      "names": { "en": "Colombia", "es": "Colombia" }
    },
    {
      "code": "MX",
      "code3": "MEX",
      "callingCode": "52",
      "mcc": "334",
      "flag": "https://flagcdn.com/mx.svg",
      "names": { "en": "Mexico", "es": "México" }
    }
  ],
  "meta": {
    "requestId": "b9b1704baffab21150213c02fd853975",
    "timestamp": "2026-05-23T02:00:00+00:00",
    "responseTimeMs": 4.12
  }
}

401

Credenciales inválidas o faltantes.

429

Se excedió el límite de solicitudes.

503

Servicio temporalmente no disponible.

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.429RATE_TPS_EXCEEDEDExcediste el cupo de tu organización para este endpoint.429RATE_DDOS_EXCEEDEDVolumen inusualmente alto desde tu IP de origen.503SERVICE_UNAVAILABLE503 genérico: un servicio del que dependemos no responde.

Ver el catálogo completo

Alcance y límites

Idiomas

Parámetros de consulta

Respuestas

Errores posibles