Localities & Regions

Check if a customer's location is covered before they check out. Use the same region and comuna data you see in your panel to validate addresses.

How it works

Chile has 16 regions, each with multiple comunas. When syncing an order, you'll use the locality name in the destination_locality field - the same locations shown in your panel dropdowns.

Region (e.g., "Región Metropolitana")
  └── Locality (e.g., "Santiago")
  └── Locality (e.g., "Providencia")
  └── Locality (e.g., "Las Condes")
  ...

Regions

Regions are the top-level geographic divisions. Each region has:

FieldTypeDescription
idintegerUnique region identifier
namestringRegion name
slugstringURL-friendly identifier
localities_countintegerNumber of comunas in this region

Example Regions

NameSlug
Arica y Parinacotaarica-y-parinacota
Tarapacátarapaca
Antofagastaantofagasta
Atacamaatacama
Coquimbocoquimbo
Valparaísovalparaiso
Metropolitanametropolitana-de-santiago
O'Higginsohiggins
Maulemaule
Ñublenuble
Biobíobiobio
La Araucaníala-araucania
Los Ríoslos-rios
Los Lagoslos-lagos
Aysénaysen
Magallanesmagallanes

Comunas

Comunas (localities) are the delivery areas within each region. Each has:

FieldTypeDescription
idintegerUnique locality identifier
namestringLocality name
slugstringURL-friendly identifier
typestringLocality type
aliasesarrayAlternative names for this locality

Use the locality name when syncing orders

When you sync an order, use the locality name in the destination_locality field:

{
  "destination_address": "Calle Principal 123",
  "destination_locality": "Providencia"
}

Was this page helpful?