Spain

Spain Autonomous Community Codes

When dealing with addresses or locations in Spain, our API uses the following autonomous community codes. These codes are based on the ISO 3166-2:ES standard for Spain's autonomous communities and cities.

CodeName (Spanish)Name (Regional)Name (English)Type
ES-ANAndalucía-AndalusiaAutonomous Community
ES-ARAragón-AragonAutonomous Community
ES-ASPrincipado de Asturias-Principality of AsturiasAutonomous Community
ES-CNCanarias-Canary IslandsAutonomous Community
ES-CBCantabria-CantabriaAutonomous Community
ES-CLCastilla y León-Castile and LeónAutonomous Community
ES-CMCastilla-La Mancha-Castile-La ManchaAutonomous Community
ES-CTCataluñaCatalunya (ca)CataloniaAutonomous Community
ES-CECeuta-CeutaAutonomous City
ES-EXExtremadura-ExtremaduraAutonomous Community
ES-GAGaliciaGalicia (gl)GaliciaAutonomous Community
ES-IBIslas BalearesIlles Balears (ca)Balearic IslandsAutonomous Community
ES-RILa Rioja-La RiojaAutonomous Community
ES-MDComunidad de Madrid-Community of MadridAutonomous Community
ES-MLMelilla-MelillaAutonomous City
ES-MCRegión de Murcia-Region of MurciaAutonomous Community
ES-NCComunidad Foral de NavarraNafarroako Foru Komunitatea (eu)Chartered Community of NavarreAutonomous Community
ES-PVPaís VascoEuskadi (eu)Basque CountryAutonomous Community
ES-VCComunidad ValencianaValència (ca)Valencian CommunityAutonomous Community

Usage Notes

  • Spain is divided into:
    • 17 Autonomous Communities (Comunidades Autónomas)
    • 2 Autonomous Cities (Ciudades Autónomas) in North Africa
  • All codes follow the format 'ES-' followed by two letters
  • Several regions have co-official languages:
    • Catalonia (ES-CT): Catalan
    • Galicia (ES-GA): Galician
    • Balearic Islands (ES-IB): Catalan
    • Valencian Community (ES-VC): Valencian/Catalan
    • Basque Country (ES-PV): Basque
    • Navarre (ES-NC): Basque (in certain zones)
  • Notable regions:
    • Madrid (ES-MD) contains the capital city Madrid
    • Ceuta (ES-CE) and Melilla (ES-ML) are Spanish territories in North Africa
  • When specifying locations in Spain in your API requests, please use these exact codes for the autonomous community or city