---
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.

---

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