Spain

Property	Value
Code	`ES`
Currency	`EUR`
Region	Europe, Southern Europe
Name order	Given name first
State	Province, a list of 69
Postcode	Required, checked, like `28013`, and by state
Rules	`GET /v1/countries/ES`

Form

The address form, in English. A field that is not required shows its optional label.

Fields

Field	Label	Required	Autocomplete
`country`	Country (list)	yes	`country`
`first_name`	First name	yes	`given-name`
`last_name`	Last name	yes	`family-name`
`line1`	Address	yes	`address-line1`
`line2`	Apartment, suite, etc.	no	`address-line2`
`postcode`	Postal code	yes	`postal-code`
`city`	City	yes	`address-level2`
`state`	Province (list)	yes	`address-level1`
`phone_number`	Phone number	no	`tel`
`email`	Email	yes	`email`

Postcode

Rule	Value
Required	yes
Pattern	`^[0-9]{5}$`
Example	`28013`
Written as	as typed
Checked by state	52 of 69, below

POST /v1/validate refuses a postcode sent with a state it does not start like, as not_in_state. A state not listed is checked by pattern only. From libaddressinput.

State	Starts with
A Coruña [La Coruña]	`15`
Alacant*	`03`
Albacete	`02`
Almería	`04`
Araba*	`01`
Asturias	`33`
Badajoz	`06`
Barcelona [Barcelona]	`08`
Bizkaia	`48`
Burgos	`09`
Cantabria	`39`
Cantabria	`39`
Castelló*	`12`
Ceuta	`51`
Ciudad Real	`13`
Cuenca	`16`
Cáceres	`10`
Cádiz	`11`
Córdoba	`14`
Gipuzkoa	`20`
Girona [Gerona]	`17`
Granada	`18`
Guadalajara	`19`
Huelva	`21`
Huesca	`22`
Illes Balears [Islas Baleares]	`07`
Illes Balears [Islas Baleares]	`07`
Jaén	`23`
La Rioja	`26`
La Rioja	`26`
Las Palmas	`35`
León	`24`
Lleida [Lérida]	`25`
Lugo [Lugo]	`27`
Madrid	`28`
Melilla	`52`
Murcia	`30`
Málaga	`29`
Nafarroa*	`31`
Ourense [Orense]	`32`
Palencia	`34`
Pontevedra [Pontevedra]	`36`
Salamanca	`37`
Santa Cruz de Tenerife	`38`
Segovia	`40`
Sevilla	`41`
Soria	`26127\|42`
Tarragona [Tarragona]	`43`
Teruel	`44`
Toledo	`45`
Valencia	`46`
Valladolid	`47`
Zamora	`49`
Zaragoza	`50`
Ávila	`05`

Phone

Rule	Value
Calling code	`+34`
National prefix	none
Pattern	`^[0-9]{9}$`
Example	`612 34 56 78`
Written as	`### ## ## ##`

Address format

How an address is written for reading, on an order page, a receipt or a label: address.format in the rules.

CODE

{first_name} {last_name}
{line1}
{line2}
{postcode} {city} {state}
{country}

On an envelope, the city and province are written in capitals.

Example

A real address in Spain, from address.example, written with the format and the state by its name:

CODE

Juan Pérez
Calle de Ruiz de Alarcón, 23
28014 Madrid Madrid
Spain

Province

The form submits the code, which is what an order stores; the name is what the shopper reads, in their language.

Code	Name
`A Coruña [La Coruña]`	A Coruña [La Coruña]
`Alacant*`	Alacant*
`Albacete`	Albacete
`Almería`	Almería
`Andalucía`	Andalucía
`Araba*`	Araba*
`Aragón`	Aragón
`Asturias`	Asturias
`Asturias, Principado de`	Asturias, Principado de
`Badajoz`	Badajoz
`Barcelona [Barcelona]`	Barcelona [Barcelona]
`Bizkaia`	Bizkaia
`Burgos`	Burgos
`Canarias`	Canarias
`Cantabria`	Cantabria
`Cantabria`	Cantabria
`Castelló*`	Castelló*
`Castilla y León`	Castilla y León
`Castilla-La Mancha`	Castilla-La Mancha
`Catalunya [Cataluña]`	Catalunya [Cataluña]
`Ceuta`	Ceuta
`Ciudad Real`	Ciudad Real
`Cuenca`	Cuenca
`Cáceres`	Cáceres
`Cádiz`	Cádiz
`Córdoba`	Córdoba
`Euskal Herria`	Euskal Herria
`Extremadura`	Extremadura
`Galicia [Galicia]`	Galicia [Galicia]
`Gipuzkoa`	Gipuzkoa
`Girona [Gerona]`	Girona [Gerona]
`Granada`	Granada
`Guadalajara`	Guadalajara
`Huelva`	Huelva
`Huesca`	Huesca
`Illes Balears [Islas Baleares]`	Illes Balears [Islas Baleares]
`Illes Balears [Islas Baleares]`	Illes Balears [Islas Baleares]
`Jaén`	Jaén
`La Rioja`	La Rioja
`La Rioja`	La Rioja
`Las Palmas`	Las Palmas
`León`	León
`Lleida [Lérida]`	Lleida [Lérida]
`Lugo [Lugo]`	Lugo [Lugo]
`Madrid`	Madrid
`Madrid, Comunidad de`	Madrid, Comunidad de
`Melilla`	Melilla
`Murcia`	Murcia
`Murcia, Región de`	Murcia, Región de
`Málaga`	Málaga
`Nafarroa*`	Nafarroa*
`Nafarroako Foru Komunitatea*`	Nafarroako Foru Komunitatea*
`Ourense [Orense]`	Ourense [Orense]
`Palencia`	Palencia
`Pontevedra [Pontevedra]`	Pontevedra [Pontevedra]
`Salamanca`	Salamanca
`Santa Cruz de Tenerife`	Santa Cruz de Tenerife
`Segovia`	Segovia
`Sevilla`	Sevilla
`Soria`	Soria
`Tarragona [Tarragona]`	Tarragona [Tarragona]
`Teruel`	Teruel
`Toledo`	Toledo
`Valencia`	Valencia
`Valenciana, Comunidad`	Valenciana, Comunidad
`Valladolid`	Valladolid
`Zamora`	Zamora
`Zaragoza`	Zaragoza
`Ávila`	Ávila

Messages

What the form shows under a field when a value is refused, in English. Every language is on its page under Languages.

Field	Error	Message
`country`	`not_selected`	Select a country
`first_name`	`blank`	Enter a first name
`first_name`	`invalid_characters`	First name can only contain letters, spaces, hyphens and apostrophes
`first_name`	`contains_emoji`	First name can't contain emojis
`first_name`	`too_long`	First name must be 255 characters or fewer
`last_name`	`blank`	Enter a last name
`last_name`	`invalid_characters`	Last name can only contain letters, spaces, hyphens and apostrophes
`last_name`	`contains_emoji`	Last name can't contain emojis
`last_name`	`too_long`	Last name must be 255 characters or fewer
`line1`	`blank`	Enter an address
`line1`	`contains_emoji`	Address can't contain emojis
`line1`	`too_long`	Address must be 255 characters or fewer
`line2`	`blank`	Enter address line 2
`line2`	`contains_emoji`	Address line 2 can't contain emojis
`line2`	`too_long`	Address line 2 must be 255 characters or fewer
`postcode`	`blank`	Enter a postal code
`postcode`	`invalid`	Enter a valid postal code, like 28013
`postcode`	`contains_emoji`	Postal code can't contain emojis
`postcode`	`too_long`	Postal code must be 64 characters or fewer
`city`	`blank`	Enter a city
`city`	`invalid`	Enter a valid city
`city`	`contains_emoji`	City can't contain emojis
`city`	`too_long`	City must be 255 characters or fewer
`state`	`not_selected`	Select a province
`state`	`invalid`	Choose a province from the list
`phone_number`	`blank`	Enter a phone number
`phone_number`	`invalid`	Enter a valid phone number, like 612 34 56 78
`phone_number`	`contains_emoji`	Phone number can't contain emojis
`phone_number`	`too_long`	Phone number must be 24 characters or fewer
`email`	`blank`	Enter an email address
`email`	`invalid`	Enter a valid email, like name@example.com
`email`	`contains_emoji`	Email can't contain emojis
`email`	`too_long`	Email must be 254 characters or fewer