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

# Retorna uno o más listados de localidades.

`POST /localidades`

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

## Request body

- LocalidadesRequestBulk
  - `localidades` object[], required
    - `id` string
    - `nombre` string
    - `provincia` string
    - `departamento` string
    - `municipio` string
    - `localidad_censal` string
    - `orden` 'id' | 'nombre'
    - `aplanar` true
    - `campos` string
    - `max` integer
    - `inicio` integer
    - `exacto` true

## Response `200`

Listados de localidades.

- LocalidadesBulk
  - `resultados` LocalidadesSingle[]
    - `cantidad` integer
    - `total` integer
    - `inicio` integer
    - `parametros` object
    - `localidades` Localidad[]
      - `departamento` DepartamentoSubEntidad
        - `id` string
        - `nombre` string
      - `id` string
      - `nombre` string
      - `provincia` ProvinciaSubEntidad
        - `id` string
        - `nombre` string
      - `municipio` MunicipioSubEntidad
        - `id` string
        - `nombre` string
      - `localidad_censal` LocalidadCensalSubEntidad
        - `id` string
        - `nombre` string
      - `categoria` 'Entidad (E)' | 'Componente de localidad compuesta (LC)' | 'Localidad simple (LS)' | 'Localidad simple con entidad (LSE)' | 'Componente de localidad compuesta con entidad (LCE)'
      - `centroide` object
        - `lat` number
        - `lon` number

## Other responses

- `400` — Error al procesar las consultas.

## Changes

- **2019-05-21** `302974186784` — 1 info
  - added the optional property `resultados/items/localidades/items/localidad_censal` to the response with the `200` status
- **2019-05-15** `7f745d434f27` — 1 info
  - added the optional property `resultados/items/parametros` to the response with the `200` status
- **2019-05-07** `146d44aa3ed2` — 1 info
  - added the new optional request property `localidades/items/localidad_censal`
- **2019-04-29** `56fe18bb9fac` — 2 warning
  - added the new `Componente de localidad compuesta con entidad (LCE)` enum value to the `resultados/items/localidades/items/categoria` response property for the response status `200`
  - added the new `Localidad simple con entidad (LSE)` enum value to the `resultados/items/localidades/items/categoria` response property for the response status `200`
- **2019-01-24** `7c4885f7ee17` — 1 warning, 1 info
  - removed the optional property `resultados/items/localidades/items/tipo` from the response with the `200` status
  - added the optional property `resultados/items/localidades/items/categoria` to the response with the `200` status

[Full history](https://skmtc.dev/datosgobar/apis/georef-ar-api/changes/localidades/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)