Address

Address structure

Addresses are used in originating and receiving accounts. They include the following attributes.

AttributeDescription
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.