Address

Represents a physical place in structured form: street, number, building or unit, city, administrative subdivisions (state, region, province, etc.), postal/ZIP code, link to the country (countryId / countryCode), optional label (label), free-form lines (lines), a preformatted string (formatted), and optional coordinates. It can be reused by many entities (locations, customers, suppliers, pickup points) without duplicating Location or Country semantics.

Full JSON example

{
  "id": "addr_9Qw2Rt5Yu8Za1",
  "channel": "demoipaas",
  "createdAt": "2026-01-12T10:00:00+00:00",
  "updatedAt": "2026-01-12T10:00:00+00:00",
  "label": "Ingresso carico/scarico",
  "lines": [
    "Via Fulvio Testi 121",
    "Civico magazzino — cancello B"
  ],
  "street": "Via Fulvio Testi",
  "streetNumber": "121",
  "building": null,
  "unit": "Cancello B",
  "city": "Milano",
  "adminAreaLevel1": "Lombardia",
  "adminAreaLevel2": "MI",
  "postalCode": "20092",
  "countryId": "country_IT",
  "countryCode": "IT",
  "formatted": "Via Fulvio Testi 121, Cancello B, 20092 Milano (MI), Italy",
  "latitude": 45.5161,
  "longitude": 9.1883,
  "validatedAt": "2026-01-12T09:55:00+00:00"
}

Remarkable notes

• adminAreaLevel1 / adminAreaLevel2 are generic: e.g. region and province code in Italy; map per destination country conventions.
• lines captures details that are not always normalizable (gate, buzzer, courier notes); it does not replace structured fields when the connector requires them.
• validatedAt reflects optional geocoding or validation; use null when the address is unverified.