> ## 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.
# UPRA Precios de la tierra rural
> El precio comercial de la tierra rural agropecuaria en Colombia por hectárea, zona por zona: unas 179.000 zonas en 18 departamentos de los estudios de mercado de tierras de la UPRA, consultables por municipio y precio o bajo un punto.
La Unidad de Planificación Rural Agropecuaria (UPRA), la unidad de planificación del Ministerio de Agricultura, mapea cuánto vale la tierra agropecuaria en Colombia: departamento por departamento, traza zonas y le da a cada una un rango de precio comercial en pesos por hectárea, a partir de entrevistas en campo, estudios de mercado y ofertas. Esta fuente guarda ese mapa completo, unas 179.000 zonas, cada una con su rango, el año del estudio, su condición en el mercado de tierras, su área y su polígono.
El mapa cubre 18 departamentos, total o parcialmente: Antioquia, Arauca, Atlántico, Bolívar, Boyacá, Casanare, Cauca, Cesar, Córdoba, Cundinamarca, Huila, La Guajira, Meta, Nariño, Quindío, Sucre, Tolima y Vichada, cada uno con el año de su estudio (2015 a 2023).
Busca las zonas de un municipio o departamento por precio, o da una coordenada y obtén la zona que la cubre.
## Buscar zonas
`POST /co/upra/land-prices-search/v1` Dataset
Las zonas de precio de un municipio o departamento, de la más cara a la más barata, filtradas por precio por hectárea.
| Campo | Tipo | Notas |
| - | - | - |
| `municipality_code` | string | Código DANE opcional de cinco dígitos del municipio, p. ej. `73001` (Ibagué). Se requiere `municipality_code` o `department_code`. |
| `department_code` | string | Código DANE opcional de dos dígitos del departamento, p. ej. `73` (Tolima) o `50` (Meta). |
| `min_price_per_hectare` | number | Opcional: zonas cuyo rango empieza en este precio o más, en pesos por hectárea. Por defecto `0`. |
| `max_price_per_hectare` | number | Opcional: zonas cuyo rango termina en este precio o menos, en pesos por hectárea. Por defecto `0`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50); cada resultado trae su geometría. Por defecto `20`. |
```bash theme={"dark"}
curl https://api.croma.run/co/upra/land-prices-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "municipality_code": "73001" }'
```
Devuelve `as_of`, los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`. Cada zona incluye `id`, `department_code`, `department`, `municipality_code`, `municipality`, `valuation_year` (el año del estudio del departamento), `price_status` (`priced`; `excluded` para tierra por fuera del mercado de tierras agropecuarias; `no_information`), `price_range` (la etiqueta de la UPRA, en millones de pesos por hectárea), `exclusion` (por qué una zona excluida está fuera del mercado, p. ej. `Zonas urbanas`, `Resguardos indígenas constituidos`, `Parques Nacionales Naturales`), `price_code`, `min_price_cop_per_ha` y `max_price_cop_per_ha` (el rango en pesos por hectárea; el rango más alto no tiene tope), `market_category` (`Incluida` o `Condicionada`), `area_ha`, `latitude`, `longitude` y `geometry` (GeoJSON en WGS84), o `geometry_url` cuando el polígono es demasiado grande para ir en línea.
La UPRA traza estos rangos a escala 1:100.000 a partir de estudios de mercado y entrevistas. Describen el mercado de tierras rurales de una zona; la UPRA advierte que no son el avalúo de un predio ni una base gravable, y dejan por fuera la tierra con uso residencial, industrial o comercial.
## La zona en un punto
`POST /co/upra/land-price-by-point/v1` Entra una coordenada, sale el precio por hectárea de la zona rural que la cubre.
| Campo | Tipo | Notas |
| - | - | - |
| `latitude` | number | **Obligatorio.** Latitud en grados decimales (WGS84). |
| `longitude` | number | **Obligatorio.** Longitud en grados decimales (WGS84), negativa en Colombia. |
```bash theme={"dark"}
curl https://api.croma.run/co/upra/land-price-by-point/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "latitude": 4.3, "longitude": -75 }'
```
Devuelve `found`, `latitude`, `longitude` y `zone`, null cuando ninguna cubre el punto. Cada zona incluye `id`, `department_code`, `department`, `municipality_code`, `municipality`, `valuation_year` (el año del estudio del departamento), `price_status` (`priced`; `excluded` para tierra por fuera del mercado de tierras agropecuarias; `no_information`), `price_range` (la etiqueta de la UPRA, en millones de pesos por hectárea), `exclusion` (por qué una zona excluida está fuera del mercado, p. ej. `Zonas urbanas`, `Resguardos indígenas constituidos`, `Parques Nacionales Naturales`), `price_code`, `min_price_cop_per_ha` y `max_price_cop_per_ha` (el rango en pesos por hectárea; el rango más alto no tiene tope), `market_category` (`Incluida` o `Condicionada`), `area_ha`, `latitude`, `longitude` y `geometry` (GeoJSON en WGS84), o `geometry_url` cuando el polígono es demasiado grande para ir en línea.
La UPRA traza estos rangos a escala 1:100.000 a partir de estudios de mercado y entrevistas. Describen el mercado de tierras rurales de una zona; la UPRA advierte que no son el avalúo de un predio ni una base gravable, y dejan por fuera la tierra con uso residencial, industrial o comercial. El mapa cubre 18 departamentos, total o parcialmente: Antioquia, Arauca, Atlántico, Bolívar, Boyacá, Casanare, Cauca, Cesar, Córdoba, Cundinamarca, Huila, La Guajira, Meta, Nariño, Quindío, Sucre, Tolima y Vichada, cada uno con el año de su estudio (2015 a 2023).
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.