ARS — Address Resolution Service

Statistics

object

Processing statistics block returned on all endpoints.

processingTimeMsinteger

Total processing time in milliseconds.

totalRecordsinteger

Total number of records submitted.

processedRecordsinteger

Number of records successfully processed.

acceptedCountinteger
rejectedCountinteger
warningRecordsinteger

Records that produced one or more WARNING reasons but were not rejected.

failedRecordsinteger

Records that failed with an unrecoverable ERROR (distinct from rejectedCount which counts business-rule rejects).

Example

RTransactionContext

object

R-transaction exemption assessment result.

exemptionApplicableboolean

TRUE if original predates SR2026 cutover and exemption applies; FALSE if postdates; null if originalExecutionDatetime not provided.

cutoverDatetimestring(date-time)

Always 2026-11-15T02:30:00Z — the SR2026 cutover reference datetime.

Example:2026-11-15T02:30:00Z

originalIsPreCutoverboolean

TRUE if the original payment execution datetime predates the SR2026 cutover.

Example

AddressResult

object

Full address processing result object (used in EP-01 and all Layer 1 responses).

partyRolestring

ISO 20022 party role. Determines the PostalAddress24 XSD variant:

  • __2 variant (ultimate_debtor, ultimate_creditor, initiating_party):
    TownName AND Country are MANDATORY. FULLY_UNSTRUCTURED is NEVER permitted (REG-005).
  • __1 variant (debtor, creditor):
    Max 3 AddressLines. FULLY_UNSTRUCTURED is permitted until SR2026 cutover (2026-11-15T02:30:00Z) for INBOUND;
    banned OUTBOUND post-cutover.

Allowed values:debtorcreditorultimate_debtorultimate_creditorinitiating_party

inputFormatstring

Format detected in the submitted address.

Allowed values:FULLY_STRUCTUREDHYBRIDFULLY_UNSTRUCTURED

outputFormatstring

Format of the processed output address.

Allowed values:FULLY_STRUCTUREDHYBRIDFULLY_UNSTRUCTURED

statusstring

Outcome of AutoCorrect processing for an address.

Allowed values:VALIDATEDREPAIREDPARTIALLY_REPAIREDNOT_REPAIRED

outputobject

Processed PostalAddress24 output.

Show Child Parameters
verificationobject

Postal DB verification result.

Show Child Parameters
extractedIdentifiersobject

Identifiers extracted from AddressLine (R-04 entity extraction).

Show Child Parameters
detectedNameInAddressstring

Party name text found embedded within address lines (R-05 PMPG non-duplication).

confidenceobject

Overall confidence score (0.0–1.0) and per-field confidence scores.

Show Child Parameters
canonicalobject

Canonical normalised address and SHA-256 fingerprint. Present when include contains canonical.

Show Child Parameters
rTransactionExemptboolean

TRUE if this address is exempt from SR2026 enforcement under EPC §8.3.

reasonsarray[object]

Structured reason code. Prefix indicates category (each family drawn from
the internal rules registry — clients should not depend on the exact
numeric value):
Customer-facing regulatory / processing families:
FMT = format-validation, FLD = field-required, REG = regulatory,
CNV = conversion, ENT = entity, VRF = verification.
Diagnostic / algorithmic families (INFO-severity only):
RFT = reformatting, INF = informational, DCT = dictionary match,
POS = positional-rule, SYN = syntax-rule, VLD = validation,
ENR = enrichment, ADP = adaptive-parser, DIC = dictionary lookup,
GLC = geo-location, PHN = phonetic, SPL = spell-correction,
VAL = validation-diagnostic.
All codes use the strict PREFIX-NNN (3-digit) format.

Show Child Parameters
Example

MessageAddressResult

partyRolestring

ISO 20022 party role. Determines the PostalAddress24 XSD variant:

  • __2 variant (ultimate_debtor, ultimate_creditor, initiating_party):
    TownName AND Country are MANDATORY. FULLY_UNSTRUCTURED is NEVER permitted (REG-005).
  • __1 variant (debtor, creditor):
    Max 3 AddressLines. FULLY_UNSTRUCTURED is permitted until SR2026 cutover (2026-11-15T02:30:00Z) for INBOUND;
    banned OUTBOUND post-cutover.

Allowed values:debtorcreditorultimate_debtorultimate_creditorinitiating_party

inputFormatstring

Format detected in the submitted address.

Allowed values:FULLY_STRUCTUREDHYBRIDFULLY_UNSTRUCTURED

outputFormatstring

Format of the processed output address.

Allowed values:FULLY_STRUCTUREDHYBRIDFULLY_UNSTRUCTURED

statusstring

Outcome of AutoCorrect processing for an address.

Allowed values:VALIDATEDREPAIREDPARTIALLY_REPAIREDNOT_REPAIRED

outputobject

Processed PostalAddress24 output.

Show Child Parameters
verificationobject

Postal DB verification result.

Show Child Parameters
extractedIdentifiersobject

Identifiers extracted from AddressLine (R-04 entity extraction).

Show Child Parameters
detectedNameInAddressstring

Party name text found embedded within address lines (R-05 PMPG non-duplication).

confidenceobject

Overall confidence score (0.0–1.0) and per-field confidence scores.

Show Child Parameters
canonicalobject

Canonical normalised address and SHA-256 fingerprint. Present when include contains canonical.

Show Child Parameters
rTransactionExemptboolean

TRUE if this address is exempt from SR2026 enforcement under EPC §8.3.

reasonsarray[object]

Structured reason code. Prefix indicates category (each family drawn from
the internal rules registry — clients should not depend on the exact
numeric value):
Customer-facing regulatory / processing families:
FMT = format-validation, FLD = field-required, REG = regulatory,
CNV = conversion, ENT = entity, VRF = verification.
Diagnostic / algorithmic families (INFO-severity only):
RFT = reformatting, INF = informational, DCT = dictionary match,
POS = positional-rule, SYN = syntax-rule, VLD = validation,
ENR = enrichment, ADP = adaptive-parser, DIC = dictionary lookup,
GLC = geo-location, PHN = phonetic, SPL = spell-correction,
VAL = validation-diagnostic.
All codes use the strict PREFIX-NNN (3-digit) format.

Show Child Parameters
xpathstring

XPath location of this party address within the ISO 20022 message.

postalAddressVariantstring

PostalAddress24 XSD variant (__1 = debtor/creditor, __2 = ultimate/initiating).

Allowed values:__1__2

iAdrIdstring

System-assigned per-address ID (format A0000000123). Stable within an org — safe to correlate against GET /audit/ars/addresses/{iAdrId}.

Example:A0000000123

referencestring

User-supplied per-address reference (correlation ID for the caller’s own systems).

batchReferencestring

Batch-level reference — same value across every iAdrId in the same submission.

Example

ErrorResponse

object

Standard error envelope returned on 4xx and 5xx responses.

codeinteger

HTTP status code.

messagestring

Human-readable error description.

requestIdstring

Correlation ID for support.

Example