> ## 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. # IGAC Transações imobiliárias > Cada ato registrado num fólio de matrícula imobiliária na Colômbia de 2015 a 2023, cerca de 31 milhões: compras e vendas, hipotecas, penhoras e cancelamentos, com o valor que cada ato declara, e a mediana do valor declarado por município, ano e ato. 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](/pt/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 `-`, 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`. | ```bash theme={"dark"} 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, `-`), `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 `-`, p. ex. `002-8032` ou `50C-123456`; um cartório numérico pode ir sem zeros à esquerda. | ```bash theme={"dark"} 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, `-`), `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`. | ```bash theme={"dark"} 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. 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.