Search
K
ARS — Address Resolution Service

Layer 4 — Reference

Read-only reference data. Cache aggressively — changes only with regulatory updates.

EP-18 — Countries

Returns all countries with SEPA/EEA membership and ISO 3166-1 alpha-2 codes.
30 EEA SEPA countries and 11 non-EEA SEPA countries/territories.
Non-EEA SEPA membership triggers mandatory payer address under EU Reg 2023/1113.
No request body or query parameters. Cache aggressively.

get
https://api-uat.ionova.ai/ars/countries

Headers

X-Request-IDstring(uuid)

Client-supplied correlation ID echoed in response headers for tracing.

Response

application/json

Country list returned

CountriesResponse

countriesarray[object]
Show Child Parameters
get/countries
 
application/json

EP-19 — Country Detail

Returns full country detail including PMPG element usage indicators for all
14 PostalAddress24 structured fields. Returns HTTP 404 if code not found.

get
https://api-uat.ionova.ai/ars/countries/{code}

Path Parameters

codestringrequired

ISO 3166-1 alpha-2 country code (e.g. DE, GB, CH)

Match pattern:^[A-Z]{2}$

Example:DE

Headers

X-Request-IDstring(uuid)

Client-supplied correlation ID echoed in response headers for tracing.

Response

application/json

Country detail returned

CountryDetailResponse

codestring

Match pattern:^[A-Z]{2}$

namestring
sepaMemberboolean
eeaMemberboolean
elementUsageobject

PMPG usage indicators for all 14 PostalAddress24 structured fields. M=Mandatory, E=Expected, O=Optional, C=Conditional, N=Not used.

Show Child Parameters
get/countries/{code}
 
application/json

EP-20 — Schemes

Returns all 11 payment schemes supported by ARS v4.3. No request body. Cache aggressively.

get
https://api-uat.ionova.ai/ars/schemes

Headers

X-Request-IDstring(uuid)

Client-supplied correlation ID echoed in response headers for tracing.

Response

application/json

Scheme list returned

SchemesResponse

schemesarray[object]
Show Child Parameters
get/schemes
 
application/json

EP-21 — Scheme Message Types

Returns message types for the specified scheme with party role XPaths,
PostalAddress24 variants, and mandate flags.
Static mandate flag: true for OCT Inst payer. Context-dependent mandates use EP-16/EP-17.
Returns HTTP 404 if scheme code not recognised.

get
https://api-uat.ionova.ai/ars/schemes/{scheme}/message-types

Path Parameters

schemestringrequired

Payment scheme identifier.

Allowed values:SCTSCT_INSTSDD_CORESDD_B2BOCT_INSTCBPRPLUSCHAPST2EURO1FEDWIREOTHER

Headers

X-Request-IDstring(uuid)

Client-supplied correlation ID echoed in response headers for tracing.

Response

application/json

Scheme message types returned

SchemeMessageTypesResponse

schemestring

Payment scheme identifier.

Allowed values:SCTSCT_INSTSDD_CORESDD_B2BOCT_INSTCBPRPLUSCHAPST2EURO1FEDWIREOTHER

messageTypesarray[object]
Show Child Parameters
get/schemes/{scheme}/message-types
 
application/json