> ## 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 Transacciones inmobiliarias > Cada acto registrado en un folio de matrícula inmobiliaria en Colombia de 2015 a 2023, unos 31 millones: compraventas, hipotecas, embargos y cancelaciones, con el valor que declara cada acto, y la mediana del valor declarado por municipio, año y acto. Cada inmueble en Colombia tiene un folio de matrícula inmobiliaria en su oficina de registro, y cada acto sobre él (una compraventa, una hipoteca, un embargo, una cancelación, un loteo) es una anotación en ese folio. El Instituto Geográfico Agustín Codazzi (IGAC) publica esas anotaciones a partir del registro de la Superintendencia de Notariado y Registro: unos 31 millones radicadas de 2015 a 2023, sobre 9,8 millones de folios en 1.105 municipios, cada una con el acto, la fecha de radicación, la escritura u orden en que se apoya, si el predio es urbano o rural y el valor que declara el acto. Lee la historia de un folio por su matrícula, busca los actos de un municipio por tipo, año y valor, o toma las estadísticas de precio: por municipio, año, zona y acto, cuántos actos declararon valor y su mediana, promedio, rango y suma. El registro no nombra intervinientes ni trae número predial, así que se une a un predio por la matrícula, no por el número predial. 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](/es/datasets). ## Buscar transacciones `POST /co/igac-transactions/search/v1` Dataset Una sola búsqueda sobre cada acto registrado, acotada a un municipio o un folio, filtrada por acto, zona, año y valor. | Campo | Tipo | Notas | | - | - | - | | `municipality_code` | string | Opcional. Código DANE de cinco dígitos del municipio, p. ej. `17013` (Aguadas, Caldas) o `11001` (Bogotá). Se requiere `municipality_code` o `registration_number`. | | `registration_number` | string | Opcional. La matrícula inmobiliaria como `-`, p. ej. `002-8032` o `50C-123456`; una oficina numérica puede ir sin ceros a la izquierda. | | `act_code` | integer | Código opcional del acto, p. ej. `125` compraventa, `219` hipoteca abierta, `843` cancelación por voluntad de las partes. 0 trae todos. Por defecto `0`. | | `zone` | enum | Opcional: `urban` o `rural`. | | `year_from` | integer | Año de radicación inicial opcional, 2015 o posterior. Por defecto `0`. | | `year_to` | integer | Año de radicación final opcional, 2023 o anterior. Por defecto `0`. | | `min_value` | number | Valor declarado mínimo opcional, en pesos. Por defecto `0`. | | `max_value` | number | Valor declarado máximo opcional, en pesos. Por defecto `0`. | | `with_value` | boolean | Opcional: `true` deja solo los actos que declaran valor. Por defecto `false`. | | `page` | integer | Número de página, empieza en 1. Por defecto `1`. | | `per_page` | integer | Resultados por página (1-100). Por defecto `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 }' ``` Devuelve `as_of`, los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`, de la radicación más reciente a la más antigua. Cada anotación incluye `id`, `registration_number` (la matrícula, `-`), `registry_office_code`, `folio_number`, `annotation_number`, `municipality_code`, `municipality`, `department`, `zone` (`urban` o `rural`), `rurality_category`, `filed_on` y `filed_year`, `act_code` y `act` (p. ej. `125` COMPRAVENTA), `instrument` (la escritura, sentencia u oficio y quién lo expidió), `value_cop` (el valor que declara el acto, null si no declara), `has_value`, `has_several_values`, `parties_from`, `parties_to` (cuántos intervinientes de cada lado), `new_folio`, `market_activity`, `folio_status`, `folio_opened_on` y `derived_folios[]`. No trae nombres de los intervinientes ni número predial. En una compraventa, `value_cop` es el precio escrito en la escritura. Es un piso y una señal de mercado: las escrituras suelen declarar cerca del avalúo catastral, por debajo del precio pactado. ## Un folio, acto por acto `POST /co/igac-transactions/folio-history/v1` Dataset Entra una matrícula, sale cada acto radicado en ella de 2015 a 2023, en el orden del folio. | Campo | Tipo | Notas | | - | - | - | | `registration_number` | string | **Obligatorio.** La matrícula inmobiliaria como `-`, p. ej. `002-8032` o `50C-123456`; una oficina numérica puede ir sin ceros a la izquierda. | ```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" }' ``` Devuelve `as_of`, `registration_number`, `found`, el `municipality_code`, `municipality`, `department` y `zone` del folio, `count` y `annotations[]` en el orden del folio. Cada anotación incluye `id`, `registration_number` (la matrícula, `-`), `registry_office_code`, `folio_number`, `annotation_number`, `municipality_code`, `municipality`, `department`, `zone` (`urban` o `rural`), `rurality_category`, `filed_on` y `filed_year`, `act_code` y `act` (p. ej. `125` COMPRAVENTA), `instrument` (la escritura, sentencia u oficio y quién lo expidió), `value_cop` (el valor que declara el acto, null si no declara), `has_value`, `has_several_values`, `parties_from`, `parties_to` (cuántos intervinientes de cada lado), `new_folio`, `market_activity`, `folio_status`, `folio_opened_on` y `derived_folios[]`. No trae nombres de los intervinientes ni número predial. Un folio sin actos radicados de 2015 a 2023 y un folio que no existe devuelven ambos `found: false` con HTTP 200. En una compraventa, `value_cop` es el precio escrito en la escritura. Es un piso y una señal de mercado: las escrituras suelen declarar cerca del avalúo catastral, por debajo del precio pactado. ## Precios por municipio `POST /co/igac-transactions/price-statistics/v1` Dataset La mediana del precio escrito en las escrituras, y los demás valores declarados, por municipio, año, zona y acto. | Campo | Tipo | Notas | | - | - | - | | `municipality_code` | string | **Obligatorio.** Código DANE de cinco dígitos del municipio, p. ej. `17013` (Aguadas, Caldas) o `11001` (Bogotá). | | `act_code` | integer | Código opcional del acto, p. ej. `125` compraventa, `219` hipoteca abierta, `843` cancelación por voluntad de las partes. 0 trae todos. Por defecto `0`. | | `zone` | enum | Opcional: `urban` o `rural`. | | `year_from` | integer | Año de radicación inicial opcional, 2015 o posterior. Por defecto `0`. | | `year_to` | integer | Año de radicación final opcional, 2023 o anterior. Por defecto `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 }' ``` Devuelve `as_of`, los filtros, `count` y `results[]`, del año más reciente al más antiguo: `id`, `municipality_code`, `municipality`, `department`, `year`, `zone`, `act_code`, `act`, `transaction_count`, `median_value_cop`, `average_value_cop`, `min_value_cop`, `max_value_cop` y `total_value_cop`. Solo cuentan los actos que declaran un valor mayor que cero. En una compraventa, `value_cop` es el precio escrito en la escritura. Es un piso y una señal de mercado: las escrituras suelen declarar cerca del avalúo catastral, por debajo del precio pactado. 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.