Address structure
Addresses are used in originating and receiving accounts. They include the following attributes.
| Attribute | Description |
|---|---|
| building_number string | The building / street number. |
| street_name string | The street name. |
| postal_code string | The postal / zip code. |
| region_state string | The region or state. |
| city string | The city. |
| country string | The ISO 3166 alpha-2 country code. For instance: GB, FR, or US. |
| line_1 string | Line 1 (unstructured). |
| line_2 string | Line 2 (unstructured). |
Structured vs. unstructured address
For SEPA payments, with the introduction of the European Payment Council's 2023 rulebooks, financial institutions must use structured addresses from November 23, 2025-onwards
The key differences between unstructured addresses and structured addresses are the following.
Unstructured address
An unstructured address contains a country (usually in the form of an ISO-3166 country code) and up to two address lines.
In Numeral, it means using the country, and line_1 / line_2 properties. Address lines can contain anything relevant that identifies an address, hence the name "unstructured".
Structured address
A structured address must include a country and city as well as split street name and building number.
In Numeral, it means filling the country and city properties as well as optionally filling other properties like building_number, street_name, region_state, and postal_code, except the line_1 and line_2 unstructured properties.