Consultá las provincias habilitadas y sus códigos ISO de referencia.

Antes de empezar

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

Cómo consultar provincias

GET /api/master-tables/provinces

Filtrar una provincia puntual

GET /api/master-tables/provinces?province_id=AR-B

Query parameters

Qué devuelve este endpoint

La respuesta devuelve un arreglo items. Cada elemento representa una provincia habilitada.

Respuesta esperada

{
  "items": [
    {
      "province_id": "AR-B",
      "province": "Buenos Aires",
      "country": "Argentina",
      "country_id": "ARG"
    },
    {
      "province_id": "AR-C",
      "province": "Ciudad Autónoma Buenos Aires",
      "country": "Argentina",
      "country_id": "ARG"
    },
    {
      "province_id": "AR-X",
      "province": "Córdoba",
      "country": "Argentina",
      "country_id": "ARG"
    }
  ]
}

Ejemplo de respuesta filtrada

{
  "items": [
    {
      "province_id": "AR-B",
      "province": "Buenos Aires",
      "country": "Argentina",
      "country_id": "ARG"
    }
  ]
}

Cuándo usar este endpoint

Este endpoint es útil cuando necesitás:

• listar provincias en un formulario
• validar un código ISO antes de enviarlo a otro servicio
• relacionar provincias con su país correspondiente
• 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 localidades habilitadas, usá GET /api/master-tables/locations.