All units (dwellings, shops, garages, storage) of a finca
Returns every unit of a finca, up to 200 per page, ordered by reference. Follow nextCursor while truncated is true. Common territory (ES): pass the 14-character finca reference. Served from our copy of the Catastro (dataSource: clone); when the copy lacks the finca, or has fewer dwellings than the building declares, it is read live from the Catastro (dataSource: catastro). A finca that is a single property (a hotel, a detached house) is returned as one unit with its 20-character reference, and its building elements go in construcciones. Basque Country (PV) and Navarra (NA): pass the foral reference of any unit of the building (Bizkaia: Número Fijo, e.g. N0714723L; Araba: 20-character CODETI; Gipuzkoa: Referen+N.Fijo+D, 15 characters; Navarra: 20-character reference starting with 31) or the finca key returned in refCatastral (municipio-polígono-parcela, e.g. 020-3-657 in Bizkaia, 59-0002-183 in Araba, 201-04-2651 in Navarra; in Gipuzkoa municipio+Referen). Units come from our copy of each foral cadastre (dataSource: clone, dataDate = publication of the source, attribution = the Diputación Foral or the Gobierno de Navarra). The foral open data carry no participation coefficient, so participacion is absent; Navarra and Araba carry stair, floor and door, Bizkaia floor and door, Gipuzkoa floor and door. A foral parcel without units (rústica, solar) is returned as one whole-property unit. Foral references and municipio-polígono-parcela keys are detected without country: a reference the detected foral copy does not hold is looked up in the other one (Navarra or the Basque Country). Gipuzkoa finca keys need country=PV. Costs one quota unit per unit served in the page (minimum 1), and the page is cut to what the quota and the prepaid balance still cover; a 304 on refresh is free. A per-finca cap is a per-contract condition agreed with specific customers, not part of any plan: organisations that have one pay at most that cap per finca and quota period across all its pages; see the X-Quota-Finca-Cap* headers. Requires an organisation API key or a signed-in user.
Request
- Base URL: https://api.parcelgps.com
- URL: https://api.parcelgps.com/api/catastro/{refcat14}/units
- Auth: API key in header X-API-Key
Path parameters
ES: 14-character finca reference (a 20-character one is cut to 14). PV and NA: the foral reference of any unit of the finca, or the finca key (refCatastral of a previous answer).
Query parameters
nextCursor of the previous page: the last unit reference served (20 characters in ES and NA, the foral unit reference in PV).
ES (default) for common territory, PV for Álava/Araba, Bizkaia and Gipuzkoa, NA for Navarra. Optional for foral references that are detected by their shape (all but Araba).
Headers
ETag of a previous response. When nothing changed the answer is 304 with no body and costs no quota.
Response
One page of units.
Example response
{
"data": {
"unidades": [
{
"uso": "Residencial"
}
]
}
}Changes
No recorded changes to this operation across all 1 revision of this API.