---
title: "Retorna un listado de asentamientos."
method: GET
path: "/asentamientos"
tags: ["Recursos"]
---

# Retorna un listado de asentamientos.

`GET /asentamientos`

Permite realizar búsquedas sobre el listado de asentamientos BAHRA.

## Query parameters

- `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
- `formato` 'json' | 'csv' | 'geojson' | 'xml'

## Response `200`

Listado de asentamientos.

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

## Changes

- **2019-05-21** `302974186784` — 1 info
  - added the optional property `asentamientos/items/localidad_censal` to the response with the `200` status
- **2019-05-15** `7f745d434f27` — 1 info
  - added the optional property `parametros` to the response with the `200` status
- **2019-05-07** `146d44aa3ed2` — 1 info
  - added the new optional `query` request parameter `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/get.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)