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

# Retorna uno o más listados de asentamientos.

`POST /asentamientos`

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

## Request body

- AsentamientosRequestBulk
  - `asentamientos` 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 asentamientos.

- AsentamientosBulk
  - `resultados` AsentamientosSingle[]
    - `cantidad` integer
    - `total` integer
    - `inicio` integer
    - `parametros` object
    - `asentamientos` Asentamiento[]
      - `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)' | 'Sitio edificado (ST)'
      - `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/asentamientos/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 `asentamientos/items/localidad_censal`
- **2019-04-30** `e7b7d212818a` — 1 info
  - endpoint added
- **2018-10-09** `91b97851e647` — 1 breaking
  - api path removed without deprecation

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