Fincas

Address to parcel in Spain and 25 other European countries, with ranked candidates

Turns a postal address into cadastral parcels, ranked by confianza (0 to 1).

  • Spain (default, country=ES): geocodes against CartoCiudad (Instituto Geográfico Nacional) and returns the building entrances (portales) that match, each with its 14-character cadastral reference. Does not depend on the Catastro being up. Candidates in the Basque Country (pais: PV) and Navarra (pais: NA) carry the foral reference.
  • Other countries (country=FR, IT, DE, AT, NL, BE, PL, CH, CZ, DK, NO, FI, EE, LV, LT, SI, SK, BG, GR, CY, LU, LI, IS, IE, UK, PT): the address is geocoded with the official national address register where there is a free one (France: Base Adresse Nationale; Netherlands: PDOK Locatieserver; Switzerland: swisstopo; Poland: GUGiK; Czechia: RÚIAN; Estonia: In-ADS; Denmark: Dataforsyningen; Flanders: Digitaal Vlaanderen) and with OpenStreetMap (Photon, Nominatim as backup) elsewhere. The parcel under each address point comes from that country's official cadastre, the same source as /search/coordinates. In Italy streets and waters (STRADA…, ACQUA…) are never returned. Sweden and Croatia answer 422: their sources have no parcels at urban addresses.

Outside Spain confianza combines the geocoder score with whether the house number, the municipality (or postcode) and the street match: 0.75 or more means the number and the municipality match; when the geocoder only knows the street, coincideNumero is false and the parcel is one on that street. Use the reference with GET /api/catastro/{refcat} for the outline and area.

Costs 1 quota unit when it returns candidates; 404 (nothing found), 422 and 304 are free.

get/api/search/address/candidates

Request

  • Base URL: https://api.parcelgps.com
  • URL: https://api.parcelgps.com/api/search/address/candidates
  • Auth: API key in header X-API-Key

Query parameters

country'ES' | 'FR' | 'IT' | 'DE' | 'AT' | 'NL' | 'BE' | 'PL' | 'CH' | 'CZ' | 'DK' | 'NO' | 'FI' | 'EE' | 'LV' | 'LT' | 'SI' | 'SK' | 'BG' | 'GR' | 'CY' | 'LU' | 'LI' | 'IS' | 'IE' | 'UK' | 'PT'

Country of the address. ES (default) also returns Basque Country and Navarra entrances. A country without address search (SE, HR, or one that is not covered) answers 422 CNV_COVERAGE with data.supportedCountries.

qstring

Free-text address: street and number, then municipality (and optionally postcode). Required unless street is given. Examples: Calle Gran Vía 31, Madrid, 8 boulevard du Port, Amiens, Via Toledo 256, Napoli, Damrak 1, 1012 LG Amsterdam, Floriańska 15, 31-019 Kraków, Unter den Linden 77, 10117 Berlin.

streetstring

Street with its type, when the address is structured.

numberinteger

House number. Overrides the number found in q.

municipalitystring

Municipality. Overrides the one found in q.

postcodestring

Postcode in the country's own format: five digits in Spain, France, Italy, Germany, Finland, Estonia; four in Austria, Belgium, Switzerland, Denmark, Norway, Slovenia, Bulgaria, Cyprus, Liechtenstein, Luxembourg (L-1660 accepted) and Latvia (LV-1012 accepted); 1012 LG in the Netherlands, 31-019 in Poland, 2510-191 in Portugal, 110 00 in Czechia, Slovakia and Greece, UK postcodes and Irish Eircodes. A postcode in another format answers 400.

limitinteger

Maximum candidates returned.

Headers

If-None-Matchstring

ETag of a previous response. When nothing changed the answer is 304 with no body and costs no quota.

Response

Candidates ordered by confidence (best first).

successtrue required

Changes

No recorded changes to this operation across all 1 revision of this API.