Consultá los países habilitados y sus códigos ISO 3166-1 alpha-3 de referencia.

Antes de empezar

1. Usá este endpoint cuando necesites poblar listas de países en formularios o validaciones.
2. Si querés obtener un país puntual, enviá country_id como query parameter.
3. Guardá el código ISO de cada país para usarlo luego en requests que requieran ese identificador.

Cómo consultar países

GET /api/master-tables/countries

Filtrar un país puntual

GET /api/master-tables/countries?country_id=ARG

Query parameters

Qué devuelve este endpoint

La respuesta devuelve un arreglo items. Cada elemento representa un país habilitado.

Respuesta esperada

{
  "items": [
    {
      "country_id": "ARG",
      "country": "Argentina"
    },
    {
      "country_id": "BRA",
      "country": "Brasil"
    },
    {
      "country_id": "USA",
      "country": "Estados Unidos"
    }
  ]
}

Ejemplo de respuesta filtrada

{
  "items": [
    {
      "country_id": "ARG",
      "country": "Argentina"
    }
  ]
}

Cuándo usar este endpoint

Este endpoint es útil cuando necesitás:

• listar países en un formulario
• validar un código ISO antes de enviarlo a otro servicio
• traducir un identificador técnico a una descripción legible

Errores frecuentes

• 404 Value not found: el código enviado no tiene coincidencias en el maestro.
• 422 Validation Error: el query parameter tiene un formato inválido.

Siguiente paso

Si necesitás consultar provincias habilitadas, usá GET /api/master-tables/provinces.