Originating and receiving accounts’ addresses are usually composed of 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). |
For SEPA payments, with the introduction of the European Payment Council’s 2023 Rulebooks, financial institutions should start to comply with what are called 'structured addresses'. From November 23, 2025 onward, financial institutions will only be able to use structured addresses. Here are the main differences between unstructured and structured addresses:
Unstructured addresses
Unstructured addresses contain 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 addresses
Structured addresses don’t use address lines but leverage specific address blocks that convey precise information about the address (hence the name ‘structured’). On top of the mandatory existing country property, they have to contain a city, but can also include a wide variety of additional information like a building number, street name, zip code, postal code, department, sub-department, or country sub-division.
In Numeral, it means filling the country and city properties, as well as optionally filling other properties like building_number, street_name, region_state, postal_code, except the line_1 and line_2 unstructured properties.