IGAC Transações imobiliárias

Cada imóvel na Colômbia tem um fólio de matrícula imobiliária no seu cartório de registro, e cada ato sobre ele (uma compra e venda, uma hipoteca, uma penhora, um cancelamento, um loteamento) é uma anotação nesse fólio. O Instituto Geográfico Agustín Codazzi (IGAC) publica essas anotações a partir do registro da Superintendencia de Notariado y Registro: cerca de 31 milhões protocoladas de 2015 a 2023, em 9,8 milhões de fólios de 1.105 municípios, cada uma com o ato, a data de protocolo, a escritura ou ordem em que se apoia, se o imóvel é urbano ou rural e o valor que o ato declara. Leia a história de um fólio pela matrícula, busque os atos de um município por tipo, ano e valor, ou use as estatísticas de preço: por município, ano, zona e ato, quantos atos declararam valor e sua mediana, média, faixa e soma. O registro não nomeia as partes nem traz número predial, então se une a um imóvel pela matrícula, não pelo número predial.

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.

Buscar transações

POST /co/igac-transactions/search/v1 Dataset Uma única busca sobre cada ato registrado, limitada a um município ou um fólio, filtrada por ato, zona, ano e valor.

Campo	Tipo	Notas
`municipality_code`	string	Opcional. Código DANE de cinco dígitos do município, p. ex. `17013` (Aguadas, Caldas) ou `11001` (Bogotá). É obrigatório `municipality_code` ou `registration_number`.
`registration_number`	string	Opcional. A matrícula imobiliária como `<cartório>-<fólio>`, p. ex. `002-8032` ou `50C-123456`; um cartório numérico pode ir sem zeros à esquerda.
`act_code`	integer	Código opcional do ato, p. ex. `125` compraventa, `219` hipoteca abierta, `843` cancelación por voluntad de las partes. 0 traz todos. Por padrão `0`.
`zone`	enum	Opcional: `urban` ou `rural`.
`year_from`	integer	Ano de protocolo inicial opcional, 2015 ou posterior. Por padrão `0`.
`year_to`	integer	Ano de protocolo final opcional, 2023 ou anterior. Por padrão `0`.
`min_value`	number	Valor declarado mínimo opcional, em pesos. Por padrão `0`.
`max_value`	number	Valor declarado máximo opcional, em pesos. Por padrão `0`.
`with_value`	boolean	Opcional: `true` mantém só os atos que declaram valor. Por padrão `false`.
`page`	integer	Número da página, começa em 1. Por padrão `1`.
`per_page`	integer	Resultados por página (1-100). Por padrão `20`.

curl https://api.croma.run/co/igac-transactions/search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "municipality_code": "17013", "act_code": 125, "year_from": 2023 }'

Retorna as_of, os filtros aplicados, total e total_is_exact, page, per_page, total_pages, count e results[], do protocolo mais recente ao mais antigo. Cada anotação traz id, registration_number (a matrícula, <cartório>-<fólio>), registry_office_code, folio_number, annotation_number, municipality_code, municipality, department, zone (urban ou rural), rurality_category, filed_on e filed_year, act_code e act (p. ex. 125 COMPRAVENTA), instrument (a escritura, sentença ou ofício e quem o expediu), value_cop (o valor que o ato declara, null quando não declara), has_value, has_several_values, parties_from, parties_to (quantas partes de cada lado), new_folio, market_activity, folio_status, folio_opened_on e derived_folios[]. Não traz nomes das partes nem número predial.

Numa compra e venda, value_cop é o preço escrito na escritura. É um piso e um sinal de mercado: as escrituras costumam declarar perto do avalúo catastral, abaixo do preço acordado.

Um fólio, ato por ato

POST /co/igac-transactions/folio-history/v1 Dataset Entra uma matrícula, sai cada ato protocolado nela de 2015 a 2023, na ordem do fólio.

Campo	Tipo	Notas
`registration_number`	string	Obrigatório. A matrícula imobiliária como `<cartório>-<fólio>`, p. ex. `002-8032` ou `50C-123456`; um cartório numérico pode ir sem zeros à esquerda.

curl https://api.croma.run/co/igac-transactions/folio-history/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "registration_number": "002-8032" }'

Retorna as_of, registration_number, found, o municipality_code, municipality, department e zone do fólio, count e annotations[] na ordem do fólio. Cada anotação traz id, registration_number (a matrícula, <cartório>-<fólio>), registry_office_code, folio_number, annotation_number, municipality_code, municipality, department, zone (urban ou rural), rurality_category, filed_on e filed_year, act_code e act (p. ex. 125 COMPRAVENTA), instrument (a escritura, sentença ou ofício e quem o expediu), value_cop (o valor que o ato declara, null quando não declara), has_value, has_several_values, parties_from, parties_to (quantas partes de cada lado), new_folio, market_activity, folio_status, folio_opened_on e derived_folios[]. Não traz nomes das partes nem número predial.

Um fólio sem atos protocolados de 2015 a 2023 e um fólio que não existe retornam ambos found: false com HTTP 200. Numa compra e venda, value_cop é o preço escrito na escritura. É um piso e um sinal de mercado: as escrituras costumam declarar perto do avalúo catastral, abaixo do preço acordado.

Preços por município

POST /co/igac-transactions/price-statistics/v1 Dataset A mediana do preço escrito nas escrituras, e os demais valores declarados, por município, ano, zona e ato.

Campo	Tipo	Notas
`municipality_code`	string	Obrigatório. Código DANE de cinco dígitos do município, p. ex. `17013` (Aguadas, Caldas) ou `11001` (Bogotá).
`act_code`	integer	Código opcional do ato, p. ex. `125` compraventa, `219` hipoteca abierta, `843` cancelación por voluntad de las partes. 0 traz todos. Por padrão `0`.
`zone`	enum	Opcional: `urban` ou `rural`.
`year_from`	integer	Ano de protocolo inicial opcional, 2015 ou posterior. Por padrão `0`.
`year_to`	integer	Ano de protocolo final opcional, 2023 ou anterior. Por padrão `0`.

curl https://api.croma.run/co/igac-transactions/price-statistics/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "municipality_code": "17013", "act_code": 125 }'

Retorna as_of, os filtros, count e results[], do ano mais recente ao mais antigo: id, municipality_code, municipality, department, year, zone, act_code, act, transaction_count, median_value_cop, average_value_cop, min_value_cop, max_value_cop e total_value_cop. Só contam os atos que declaram um valor maior que zero.

Numa compra e venda, value_cop é o preço escrito na escritura. É um piso e um sinal de mercado: as escrituras costumam declarar perto do avalúo catastral, abaixo do preço acordado.

Referência completa

Esquemas, todos os campos de resposta e um playground interativo.

Primeiros passos

Tipos de solicitação

Monitores

Países

IGAC Transações imobiliárias

Buscar transações

Um fólio, ato por ato

Preços por município

Referência completa

​Buscar transações

​Um fólio, ato por ato

​Preços por município

Referência completa

Buscar transações

Um fólio, ato por ato

Preços por município