How an address is written in Spain
An address in Spain is written in this order: street name and house number, then postal code (five digits), town or city and region on one line, with the town or city and the region in capitals. The strongest check here is the postal code itself: GeoNames' postal code list (31 October 2026), with 11,150 postal codes for Spain, current codes only.
The order the lines go in
The parts are named rather than filled in: Spaw does not know an address in Spain and will not invent one. This block is produced by the same function that rewrites a real address, so the line order, the capitals Spain asks for and any text its operator prints on every envelope are the checker's own behaviour rather than a second description of it.
Organisation Street name 12 Flat or unit Postal code TOWN OR CITY REGION
No recipient line: nothing in the response is about a person, so the name the envelope carries is not part of what is checked.
| field | called here | required | capitals |
|---|---|---|---|
| organization | Organisation | optional | — |
| addressLine1 | Street name | required | — |
| addressLine2 | Flat or unit | optional | — |
| locality | Town or city | required | yes |
| administrativeArea | Region | required | yes |
| postalCode | Postal code | required | — |
In Spain the house number follows the street name, and that is the side it is written back on when the checker rewrites an address. The postal code is written before the town.
Can Spaw tell whether an address in Spain exists?
No. No address register is installed for Spain, so exists answers null: not evaluated, never no. An address can be perfectly formed and still not exist, and nothing here will pretend to know which.
A postcode directory answers a different question. The postal code is settled separately by GeoNames' postal code list, which is recorded as complete: one it does not hold answers postcode_not_found.
Further reading: How to read an address-existence answer.
Check an address in Spain
The same lookup the API runs, with Spain already selected.
Live demo
POST /demo/address · no key needed
Response
Look up any address to see the full API response, straight from the live service. The country decides which format it is read against.
The postal code
Postal codes in Spain are five digits.
pattern \d{5}
A postcode list from a multi-country source is installed for Spain, so a postal code here is not only checked for shape but looked up: 11,150 postal codes from GeoNames' postal code list, version 2026-10-31. It lists current codes only, so a retired code is not told apart from one it does not hold.
What Spain calls an address that is not a front door
A PO box, a private mailbox and the other kinds of delivery point below are told apart by the words written on the address, never by a list of whose box is whose. The rows marked as the operator's own words are taken from the addressing guide of the postal operator in Spain; the others are international spellings, not the operator's own. All of them are what the checker reads, and because an entry is carried for Spain, an address here with none of them answers street.
| address_type | written as |
|---|---|
| private_mailbox Private mailbox at a mail-receiving agency | PMBinternational spellings the checker also reads |
| po_box Post-office box | APARTADO DE CORREOS, APARTADO POSTAL; APARTADO, APDO (only at the start of a line, with a number)the operator's own words |
| general_delivery Held at the counter for collection | LISTA DE CORREOSthe operator's own words |
The anchored spellings are the conservative half of this: those words are ordinary language elsewhere in an address, so they only count when they open the line and carry a number after them.
What can be checked for an address in Spain
Read from the datasets this server holds right now, not written into the page. For most countries the answer is the written form and the postcode shape and nothing beyond them — in particular not the row people assume is always there.
| check | for ES | what the answer means |
|---|---|---|
| Written form | yes | The address is split into the country's own parts and rewritten in the order above. A missing required part is named in one typed reason rather than a general failure. |
| postal code pattern | yes | Checked against the pattern the table carries for Spain. A value that does not match answers invalid_postal_code. |
| postal code exists | yes | 11,150 postal codes from GeoNames' postal code list. It lists current codes only, so a retired code is not told apart from one it does not hold. |
| Kind of delivery point | yes | The operator's own box words are carried for Spain, so an address with no marker answers street rather than unknown. |
| Street exists | no | No register is installed for Spain, so a street is neither confirmed nor denied: match_level answers null. |
| Building exists | no | No address register is installed for Spain, so exists answers null: not evaluated, never no. Absence is not evidence here. |
| Companies at the address | no | No open company register is installed for Spain, so companies_registered answers null and no mail-drop conclusion is drawn from a count. |
| Known mailbox branch | no | No operator branch list covers Spain, so is_mail_drop is never set from one here. |
| Post actually arrives | no | Not from this page, and not from open data in any country: whether post is delivered, and the vacant, residential and agency flags that go with it, are the postal service's own licensed product. Those fields answer deliverability_checked: false rather than a guess. |
Null means not evaluated, never no.
Other countries
Sources
- Google's Address Data Service · address-formats 2026-09-05© Google LLC, CC BY 4.0 (Google Address Data Service); initial import via commerceguys/addressing (MIT)
- The postal operators' addressing guides · address-rules 2026-09-17
- GeoNames' postal code list · geonames-postal-codes 2026-10-31Postal codes, places and centroids from GeoNames (geonames.org), CC BY 4.0.
Data synced on 2026-10-31: the newest version among the datasets listed above.
More free tools
All free toolsNeed this at scale?
The Spaw API runs the same check with batch and bulk endpoints, monitored address lists, your own suppression list and outcome reporting — 100 free credits a month, no card required.