---
title: "Retorna uno o más listados de municipios."
method: POST
path: "/municipios"
tags: ["Recursos"]
---

# Retorna uno o más listados de municipios.

`POST /municipios`

Permite realizar varias búsquedas sobre el listado de municipios en simultáneo.

## Request body

- MunicipiosRequestBulk
  - `municipios` object[], required
    - `id` string
    - `nombre` string
    - `provincia` string
    - `interseccion` string
    - `orden` 'id' | 'nombre'
    - `aplanar` true
    - `campos` string
    - `max` integer
    - `inicio` integer
    - `exacto` true

## Response `200`

Listados de municipios.

- MunicipiosBulk
  - `resultados` MunicipiosSingle[]
    - `cantidad` integer
    - `total` integer
    - `inicio` integer
    - `parametros` object
    - `municipios` Municipio[]
      - `id` string
      - `nombre` string
      - `nombre_completo` string
      - `provincia` ProvinciaSubEntidad
        - `id` string
        - `nombre` string
      - `centroide` object
        - `lat` number
        - `lon` number
      - `categoria` string

## Other responses

- `400` — Error al procesar las consultas.

## Changes

- **2019-05-15** `7f745d434f27` — 1 info
  - added the optional property `resultados/items/parametros` to the response with the `200` status
- **2019-01-24** `7c4885f7ee17` — 2 info
  - added the optional property `resultados/items/municipios/items/categoria` to the response with the `200` status
  - added the optional property `resultados/items/municipios/items/nombre_completo` to the response with the `200` status
- **2018-10-11** `681881d2e961` — 1 info
  - added the new optional request property `municipios/items/interseccion`
- **2018-10-09** `91b97851e647` — 4 warning
  - removed the request property `municipios/items/interseccion`
  - removed the optional property `resultados/items/municipios/items/categoria` from the response with the `200` status
  - removed the optional property `resultados/items/municipios/items/nombre_completo` from the response with the `200` status
  - removed the optional property `resultados/items/parametros` from the response with the `200` status

[Change history](https://skmtc.dev/datosgobar/apis/georef-ar-api/changes/municipios/post.md)

---

[API](https://skmtc.dev/datosgobar/apis/georef-ar-api.md) · [All operations](https://skmtc.dev/datosgobar/apis/georef-ar-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/datosgobar/georef-ar-api/revisions/a0c3d492ec8b/schema)
