---
title: "MandatePartyAddressResponse"
url: "https://dev.ionova.ai/apis/ars-address-resolution-service-4/versions/fdd2c316-7f84-4f04-8bb7-64e9bf97893b/schemas/MandatePartyAddressResponse"
---

> Full API specification: https://dev.ionova.ai/apis/ars-address-resolution-service-4/versions/fdd2c316-7f84-4f04-8bb7-64e9bf97893b.md

# MandatePartyAddressResponse

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: ARS — Address Resolution Service
  version: 4.3.1
servers:
  - url: https://api-uat.ionova.ai/ars
    description: UAT (test data only)
components:
  schemas:
    PartyRole:
      type: string
      description: >
        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-05).
        - **__1 variant** (debtor, creditor):
          Max 3 AddressLines. FULLY_UNSTRUCTURED is permitted until SR2026 cutover (2026-11-22T02:30:00Z) for INBOUND;
          banned OUTBOUND post-cutover.
      enum:
        - debtor
        - creditor
        - ultimate_debtor
        - ultimate_creditor
        - initiating_party
    MandatePartyAddressResponse:
      type: object
      xml:
        name: MandatePartyAddressResponse
      properties:
        partyRole:
          $ref: "#/components/schemas/PartyRole"
        addressMandatory:
          type: boolean
          description: TRUE if address is legally required for this transaction context.
        reason:
          type: string
          description: Plain-English explanation of mandate determination.
        ruleSource:
          type: string
          description: Regulatory reference (e.g. EU Regulation 2023/1113 Art 4, OCT Inst
            Rulebook §3.2).
```