Countries · Portugal

Portugal: how an address is written and what we verify

Every address in the country comes back in the national postal form and is checked against the national address register: street, house number, postcode, coordinates. Here you find how an address is written there, what we check and three before-and-after examples.

Try it on an address API documentation

What an address looks like

House number·after the street (“Hauptstraße 5”)
Postcode·4 + 3 digits; the country prefix in front (D-, F-, CH-) is removed
City·in capitals, in its local name
Country·country line and ISO code, in the reader's language

The Portuguese postcode has seven digits in two groups (“1100-053”) and the second group identifies the stretch of street: without it, the register does not confirm the house number. The house number follows the street; the national register is made of dwellings, so public buildings with no homes may be missing while the commercial streets of the centre are all there.

What we verify

Addresses: the whole country · postcodes: 98% · source data as of 31 Dec 2017, more recent in the municipalities that publish their own register.

Street·exists in the municipality, written in full and in the register's spelling; abbreviations are expanded in the country's language
House number·exists on that street; if the street exists and the number does not, the outcome flags it
Postcode·confirmed or filled in by the register, in the country's format
Coordinates·latitude and longitude of the house number, with the precision declared
Autocomplete·the street completes as you type, from the register; the house number and the postcode come with the selection (API)
WooCommerce · PrestaShop·autocomplete at checkout and order verification with the plugins

Fonte: Instituto Nacional de Estatística, I.P. — Base Nacional de Moradas; Câmaras Municipais de Cascais, Oeiras, Matosinhos e Nordeste (Açores); CIM Alto Tâmega e Barroso; © OpenStreetMap contributors · CC BY 4.0; ODbL

Before and after

Three addresses written the way people write them — abbreviated, without postcode, in lower case — and how they come out: public buildings and streets of the city centre, verified down to the house number.

rua augusta 100, 1100053 lisboa → Rua Augusta 100
1100-053 LISBOA coordinates of the house number
r. de santa catarina, 110, 4000 porto → Rua de Santa Catarina 110
4000-442 PORTO postcode fixed · street written in full · coordinates of the house number
PRAÇA DA REPÚBLICA 8, COIMBRA → Praça da República 8
3000-343 COIMBRA postcode filled in · coordinates of the house number

With the API

The same endpoint as every country: country_code is enough. The response carries the address in postal form, the outcome with the changes, and where the register is in service the coordinates, the municipality code and the district. Everything in the API documentation.

curl -X POST https://www.radaraddress.com/api/v1/contact \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"address":"rua augusta 100","postcode":"1100053","city":"lisboa","country_code":"PT"}'

Frequently asked questions

Do you also verify addresses that are in a file?

Yes. In batch jobs a column with the country is enough, or the country set for the whole file: every row comes back in the country's postal form, with the outcome beside it and, where the register is in service, verified down to the house number.

What happens if an address is not in the register?

We say so. If the street exists and the house number does not, the outcome flags the house number; if the street is not found in the municipality, the address still comes out in the country's postal form, with the warning. We never invent a plausible address in place of the one that is missing.

Where do the data come from?

From the national address register, published as open data by the country's mapping or statistics agency, which we use under the licence it requires: Fonte: Instituto Nacional de Estatística, I.P. — Base Nacional de Moradas; Câmaras Municipais de Cascais, Oeiras, Matosinhos e Nordeste (Açores); CIM Alto Tâmega e Barroso; © OpenStreetMap contributors (CC BY 4.0; ODbL). The register is checked every night and reloaded when the source changes.

The other countries

Italy · Germany · France · Spain · Netherlands · Belgium · Switzerland · Liechtenstein · Czechia · Denmark · Norway · Finland · Austria · Slovenia · Luxembourg · Hungary · Romania · Ireland · Slovakia · Iceland · Croatia · Andorra · Monaco · San Marino · Vatican City · all countries