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

# Dados abertos de Bogotá

> Estratos socioeconômicos de Bogotá: o estrato de cada unidade imobiliária da cidade, cerca de três milhões de CHIPs, por lote, quadra e setor, da Secretaría Distrital de Planeación.

Bogotá publica os conjuntos de dados de seus órgãos em seu portal de dados abertos,
Datos Abiertos Bogotá. O primeiro aqui é a estratificação socioeconômica: o estrato
que a Secretaría Distrital de Planeación atribui a cada unidade imobiliária da
cidade, de `1` a `6`, que define as tarifas dos serviços públicos e os subsídios que
um domicílio recebe, e que bancos e seguradoras leem como sinal do nível
socioeconômico de um domicílio.

Cada unidade é identificada por seu CHIP, o identificador do cadastro, e traz os
códigos de seu lote, quadra e setor cadastral, então o estrato se cruza com qualquer
outro registro do mesmo imóvel ou quadra. Consulte um CHIP, todas as unidades de um
lote ou de uma quadra, ou todas as de um estrato em um setor, cada uma em uma única
chamada rápida.

> [!NOTE]
>
> A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](https://docs.usecroma.com/pt/datasets.md).

## Estrato por CHIP

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

Retorna o estrato de uma unidade imobiliária.

| Campo | Tipo | Notas |
| - | - | - |
| `chip` | string | **Obrigatório.** O CHIP da unidade, p. ex. `AAA0087JAUZ`. Maiúsculas ou minúsculas tanto faz. |

```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" }'
```

Retorna `as_of`, `found`, `chip`, `unit` e `release` (ver abaixo).

## Buscar unidades

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

Lista unidades imobiliárias com seu estrato, por lote, quadra, setor ou estrato.
Combine os filtros, p. ex. um setor e um estrato.

| Campo | Tipo | Notas |
| - | - | - |
| `lot_code` | string | Opcional. Código cadastral do lote, de doze dígitos, p. ex. `008104037039`: todas as unidades do lote. |
| `block_code` | string | Opcional. Código da quadra, de nove dígitos, p. ex. `008104037`: os nove primeiros do código do lote. |
| `sector_code` | string | Opcional. Setor cadastral, de seis dígitos, p. ex. `008104`: os seis primeiros do código do lote. |
| `stratum` | enum | Opcional. `1` a `6`, ou `0` para as unidades sem estrato. |
| `page` | integer | Opcional. Página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-100. Por padrão `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" }'
```

Retorna `as_of`, os filtros aplicados, `total`, `total_is_exact`, `page`,
`per_page`, `total_pages`, `count`, `units[]` (ordenadas por CHIP) e `release` (ver abaixo).

## Resposta

Cada resposta traz `as_of`: o quão atuais são os dados, e `release`: o arquivo de onde vêm.

### `units[]` e `unit`

| Campo | Notas |
| - | - |
| `chip` | O CHIP da unidade imobiliária, o identificador cadastral de Bogotá: um apartamento, casa, vaga de garagem ou depósito. |
| `lot_code` | Código cadastral do lote, de doze dígitos: setor (6), quadra (3) e lote (3). Todas as unidades de um edifício o compartilham. |
| `block_code` | Código da quadra (manzana), de nove dígitos: os nove primeiros do código do lote. |
| `sector_code` | Setor cadastral, de seis dígitos: os seis primeiros do código do lote. |
| `stratum` | Estrato socioeconômico, de `1` (o mais baixo) a `6` (o mais alto). `0` significa que a unidade não tem estrato: a cidade não estratifica imóveis sem moradia (comércio, institucionais, garagens e usos semelhantes). |

### `release`

`published_at` (quando a Secretaría Distrital de Planeación publicou o arquivo pela última vez), `units` (quantas unidades traz), `document_url` (a cópia da Croma, idêntica byte a byte, do arquivo publicado, um CSV compactado) e `source_document_url` (o arquivo na fonte).

O CHIP e o código do lote são os mesmos identificadores que o cadastro de Bogotá usa, então uma unidade encontrada aqui se cruza com qualquer outro conjunto de dados que use CHIP, lote, quadra ou setor.

> [card] [Referência completa](https://docs.usecroma.com/pt/api-reference/overview.md)
>
> Esquemas, todos os campos de resposta e um playground interativo.


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