---
title: "UPRA Rural Land Price by Point"
method: POST
path: "/co/upra/land-price-by-point/v1"
tags: ["Colombia", "UPRA Rural Land Prices"]
---

# UPRA Rural Land Price by Point

`POST /co/upra/land-price-by-point/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/co/upra/land-price-by-point/v1`
- Auth: HTTP bearer

Find the commercial price range of rural agricultural land at a point in Colombia (`latitude`, `longitude`, WGS84) from UPRA's land-market map: the zone that covers the point, with its price range in pesos per hectare, the year of the study, its market category, area and polygon. Land outside the market (urban zones, indigenous reserves, parks, páramos) comes back as a zone with `price_status: excluded` and the reason; `found: false` outside the 18 departments UPRA has studied and where no zone covers the point. Not an appraisal of any one property.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `latitude` number, required: Latitude of the point, decimal degrees (WGS84), within Colombia.
  - `longitude` number, required: Longitude of the point, decimal degrees (WGS84), within Colombia.

## Response `200`

Successful response

- UpraLandPriceByPointResponse
  - `data` UpraLandPriceByPointData, required
    - `found` boolean, required: False when no UPRA zone covers the point: most of the country outside the 18 departments studied. Land outside the market (urban, reserves, parks) is a zone with `price_status: excluded`.
    - `latitude` number, required
    - `longitude` number, required
    - `zone` object, nullable, required
      - `id` string, required: `<department_code>-<valuation_year>-<number>`, e.g. `73-2017-1520`.
      - `department_code` string, required: Two-digit DANE code of the department.
      - `department` string, nullable, required
      - `municipality_code` string, nullable, required: Five-digit DANE code of the municipality.
      - `municipality` string, nullable, required
      - `valuation_year` number, nullable, required: The year UPRA's price study for the department refers to (vigencia).
      - `price_status` 'priced' | 'excluded' | 'no_information', required: `priced` when the zone carries a price range; `excluded` when the land is outside the agricultural land market (`exclusion` says why); `no_information` when UPRA has no price for it.
      - `price_range` string, nullable, required: The range as UPRA labels it, in millions of pesos per hectare, e.g. `Mayor que 5 - hasta 8`; null unless priced.
      - `exclusion` string, nullable, required: Why the zone is outside the land market, as UPRA names it, e.g. `Zonas urbanas`, `Resguardos indígenas constituidos`, `Parques Nacionales Naturales`; null unless excluded.
      - `price_code` string, nullable, required: UPRA's code for the range or the exclusion, e.g. `2.2.1`, `E-3`, `SI`.
      - `min_price_cop_per_ha` number, nullable, required: The range's lower bound in pesos per hectare (0 for `Menor a 1`); null without a range.
      - `max_price_cop_per_ha` number, nullable, required: The range's upper bound in pesos per hectare; null for the open top range or without a range.
      - `market_category` string, nullable, required: The zone's standing in UPRA's land-market frontier: `Incluida` or `Condicionada`.
      - `area_ha` number, nullable, required: The zone's area in hectares.
      - `latitude` number, nullable, required: Centre of the zone's bounding box.
      - `longitude` number, nullable, required
      - `geometry` object, nullable, required: The zone as GeoJSON in WGS84, as UPRA draws it at 1:100,000.
        - `type` string, required: `Polygon` or `MultiPolygon`.
        - `coordinates` unknown, required
      - `geometry_url` string, nullable, required: Set when the geometry is too large to carry inline: the same GeoJSON geometry, kept by us, and `geometry` is null.

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)