> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Datos abiertos de Bogotá

> Estratos socioeconómicos de Bogotá: el estrato de cada unidad predial de la ciudad, unos tres millones de CHIP, por lote, manzana y sector, de la Secretaría Distrital de Planeación.

Bogotá publica los conjuntos de datos de sus entidades en su portal de datos
abiertos, Datos Abiertos Bogotá. El primero aquí es la estratificación
socioeconómica: el estrato que la Secretaría Distrital de Planeación asigna a cada
unidad predial de la ciudad, de `1` a `6`, que fija las tarifas de los servicios
públicos y los subsidios que recibe un hogar, y que bancos y aseguradoras leen como
señal del nivel socioeconómico de un hogar.

Cada unidad se identifica por su CHIP, el identificador del catastro, y trae los
códigos de su lote, manzana y sector catastral, así que el estrato se cruza con
cualquier otro registro del mismo predio o manzana. Consulte un CHIP, todas las
unidades de un lote o una manzana, o todas las de un estrato en un sector, cada una
en una sola llamada rápida.

> [!NOTE]
>
> La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](https://docs.usecroma.com/es/datasets.md).

## Estrato por CHIP

`POST /co/bogota-datos/stratum/v1` [Dataset](https://docs.usecroma.com/es/datasets.md)

Devuelve el estrato de una unidad predial.

| Campo | Tipo | Notas |
| - | - | - |
| `chip` | string | **Obligatorio.** El CHIP de la unidad, p. ej. `AAA0087JAUZ`. Mayúsculas o minúsculas da igual. |

```bash theme={"dark"}
curl https://api.croma.run/co/bogota-datos/stratum/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "chip": "AAA0087JAUZ" }'
```

Devuelve `as_of`, `found`, `chip`, `unit` y `release` (ver abajo).

## Buscar unidades

`POST /co/bogota-datos/strata-search/v1` [Dataset](https://docs.usecroma.com/es/datasets.md)

Lista unidades prediales con su estrato, por lote, manzana, sector o estrato.
Combine los filtros, p. ej. un sector y un estrato.

| Campo | Tipo | Notas |
| - | - | - |
| `lot_code` | string | Opcional. Código catastral del lote, de doce dígitos, p. ej. `008104037039`: todas las unidades del lote. |
| `block_code` | string | Opcional. Código de manzana, de nueve dígitos, p. ej. `008104037`: los primeros nueve del código de lote. |
| `sector_code` | string | Opcional. Sector catastral, de seis dígitos, p. ej. `008104`: los primeros seis del código de lote. |
| `stratum` | enum | Opcional. `1` a `6`, o `0` para las unidades sin estrato. |
| `page` | integer | Opcional. Página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-100. Por defecto `20`. |

```bash theme={"dark"}
curl https://api.croma.run/co/bogota-datos/strata-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "lot_code": "008104037039" }'
```

Devuelve `as_of`, los filtros aplicados, `total`, `total_is_exact`, `page`,
`per_page`, `total_pages`, `count`, `units[]` (ordenadas por CHIP) y `release` (ver abajo).

## Respuesta

Cada respuesta incluye `as_of`: qué tan actualizados están los datos, y `release`: el archivo de donde vienen.

### `units[]` y `unit`

| Campo | Notas |
| - | - |
| `chip` | El CHIP de la unidad predial, el identificador catastral de Bogotá: un apartamento, casa, parqueadero o depósito. |
| `lot_code` | Código catastral del lote, de doce dígitos: sector (6), manzana (3) y lote (3). Todas las unidades de un edificio lo comparten. |
| `block_code` | Código de la manzana, de nueve dígitos: los primeros nueve del código de lote. |
| `sector_code` | Sector catastral, de seis dígitos: los primeros seis del código de lote. |
| `stratum` | Estrato socioeconómico, de `1` (el más bajo) a `6` (el más alto). `0` significa que la unidad no tiene estrato: la ciudad no estratifica los predios sin vivienda (comercio, dotacionales, parqueaderos y usos similares). |

### `release`

`published_at` (cuándo la Secretaría Distrital de Planeación publicó el archivo por última vez), `units` (cuántas unidades trae), `document_url` (la copia de Croma, idéntica byte a byte, del archivo publicado, un CSV comprimido) y `source_document_url` (el archivo en la fuente).

El CHIP y el código de lote son los mismos identificadores que usa el catastro de Bogotá, así que una unidad encontrada aquí se cruza con cualquier otro conjunto de datos que use CHIP, lote, manzana o sector.

> [card] [Referencia completa](https://docs.usecroma.com/es/api-reference/overview.md)
>
> Esquemas, todos los campos de respuesta y un playground interactivo.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.