Get SEPA Mandate by ID

GET 
/mandates/:mandateId

Retrieve a specific mandate by its ID

Request

Path Parameters

mandateId stringrequired

Mandate ID

Header Parameters

Content-Type stringrequired

Must be application/json

Accept-Language stringrequired

Must be be en-US

Origin stringrequired

The origin of the request

User-Agent stringrequired

The client making the request

Responses

200

Successful response

application/json

Schema

Schema

items object

idstring<uuid>required

Unique identifier of the mandate.

Possible values: <= 36 characters

objectstringrequired

Object type.

Possible values: [MANDATE]

createdAtstring<date-time>required

Mandate creation timestamp.

statusstringrequired

Current status of the mandate.

Possible values: [CREATED, ACTIVE]

mandateSchemestringrequired

Indicates the SEPA mandate scheme.

Possible values: [SEPA_CORE, SEPA_B2B]

mandateReferencestringrequired

Unique reference of the mandate.

Possible values: <= 70 characters

referenceInstructions objectnullable

generatedReferencebooleannullable

True if mandateReference was generated.

mandatePrefixstringnullable

Prefix used to generate the mandateReference.

Possible values: <= 50 characters

debtorNamestringnullable

Name of the debtor.

Possible values: <= 140 characters

debtorAddress objectnullable

addressLine1stringnullable

Street name and house number.

Possible values: <= 70 characters

numberstringnullable

House number.

Possible values: <= 10 characters

postCodestringnullable

Postal code.

Possible values: <= 20 characters

citystringnullable

City.

Possible values: <= 70 characters

countryCodestringnullable

Country code (ISO 3166-1 alpha-2).

Possible values: <= 2 characters

debtorBank objectnullable

ibanstringnullable

Debtor IBAN.

Possible values: <= 34 characters

bankNamestringnullable

Debtor bank name.

Possible values: <= 70 characters

bicstringnullable

Debtor BIC.

Possible values: <= 11 characters

creditorNamestringrequired

Creditor name.

Possible values: <= 140 characters

creditorIdentifierstringrequired

SEPA creditor ID.

Possible values: <= 35 characters

creditorAddress objectrequired

addressLine1stringnullable

Street name and house number.

Possible values: <= 70 characters

numberstringnullable

House number.

Possible values: <= 10 characters

postCodestringnullable

Postal code.

Possible values: <= 20 characters

citystringnullable

City.

Possible values: <= 70 characters

countryCodestringnullable

Country code (ISO 3166-1 alpha-2).

Possible values: <= 2 characters

account objectnullable

customerAccountIdstringnullable

Customer account identifier.

Possible values: <= 255 characters

billingAddress object

addressLine1stringrequired

Street name.

Possible values: <= 60 characters

Example: Max-Planck-Straße

addressLine2string

Apartment, suite, unit, building, floor or other secondary address information.

Possible values: <= 60 characters

addressLine3string

Specific delivery instructions, department names, or additional floor information.

Possible values: <= 60 characters

citystringrequired

The city or localitly of the address.

Possible values: <= 50 characters

Example: Berlin

countryCodestringrequired

ISO-3 code of the address country (e.g., DEU for Germany).

Possible values: >= 3 characters and <= 3 characters

Example: DEU

numberstring

The house or building number corresponding to the street address.

Possible values: <= 10 characters

Example: 30

postCodestringrequired

The postal or ZIP code of the address.

Possible values: <= 10 characters

Example: 14473

statestring

3-letter code of the address state. Mandatory when countryCode corresponds to Canada or USA.

Possible values: <= 3 characters

isBusinessUserbooleannullable

Whether the mandate belongs to a business user.

businessConsumer objectnullable

companyNamestringnullable

Company name.

Possible values: <= 140 characters

companyTypestringnullable

Legal form or type of the company.

Possible values: <= 70 characters

emailAddressstringnullable

Contact email.

Possible values: <= 254 characters

taxIdstringnullable

Business tax ID.

Possible values: <= 20 characters

culturestringnullable

Regional culture or locale setting.

Possible values: <= 10 characters

consumer objectnullable

firstNamestringnullable

Possible values: <= 50 characters

lastNamestringnullable

Possible values: <= 50 characters

middleNamestringnullable

Possible values: <= 50 characters

emailAddressstringnullable

Possible values: <= 254 characters

dateOfBirthstring<date>nullable

genderstringnullable

mobilePhonestringnullable

homePhonestringnullable

workPhonestringnullable

titlestringnullable

culturestringnullable

Possible values: <= 10 characters

taxIdstringnullable

Possible values: <= 20 characters

activation objectnullable

mandateSignedLocationstringnullable

City or place of mandate signature.

Possible values: <= 255 characters

mandateDateOfSignaturestring<date>nullable

Date when mandate was signed.

mandateAcceptancestringnullable

Method of mandate acceptance.

Possible values: [ONLINE, OFFLINE]

additionalData object[]nullable

Array [

namestringrequired

Metadata key.

Possible values: <= 100 characters

valuestringrequired

Metadata value.

Possible values: <= 512 characters

]

versionTagstringnullable

Mandate version tag.

Possible values: <= 10 characters

versionCreatedAtstring<date-time>nullable

Timestamp of mandate version creation.

Example (auto)

{
  "items": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "object": "MANDATE",
    "createdAt": "2024-07-29T15:51:28.071Z",
    "status": "CREATED",
    "mandateScheme": "SEPA_CORE",
    "mandateReference": "string",
    "referenceInstructions": {
      "generatedReference": true,
      "mandatePrefix": "string"
    },
    "debtorName": "string",
    "debtorAddress": {
      "addressLine1": "string",
      "number": "string",
      "postCode": "string",
      "city": "string",
      "countryCode": "string"
    },
    "debtorBank": {
      "iban": "string",
      "bankName": "string",
      "bic": "string"
    },
    "creditorName": "string",
    "creditorIdentifier": "string",
    "creditorAddress": {
      "addressLine1": "string",
      "number": "string",
      "postCode": "string",
      "city": "string",
      "countryCode": "string"
    },
    "account": {
      "customerAccountId": "string",
      "billingAddress": {
        "addressLine1": "Max-Planck-Straße",
        "addressLine2": "string",
        "addressLine3": "string",
        "city": "Berlin",
        "countryCode": "DEU",
        "number": 30,
        "postCode": 14473,
        "state": "string"
      },
      "isBusinessUser": true,
      "businessConsumer": {
        "companyName": "string",
        "companyType": "string",
        "emailAddress": "string",
        "taxId": "string",
        "culture": "string"
      },
      "consumer": {
        "firstName": "string",
        "lastName": "string",
        "middleName": "string",
        "emailAddress": "string",
        "dateOfBirth": "2024-07-29",
        "gender": "string",
        "mobilePhone": "string",
        "homePhone": "string",
        "workPhone": "string",
        "title": "string",
        "culture": "string",
        "taxId": "string"
      }
    },
    "activation": {
      "mandateSignedLocation": "string",
      "mandateDateOfSignature": "2024-07-29",
      "mandateAcceptance": "ONLINE"
    },
    "additionalData": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "versionTag": "string",
    "versionCreatedAt": "2024-07-29T15:51:28.071Z"
  }
}

SEPA B2B

Get SEPA B2B mandate by ID

{
  "id": "md_7c1c304e-72bf-2b57-2570-148879f6da20",
  "object": "MANDATE",
  "createdAt": "2023-03-02T14:25:59.078Z",
  "versionTag": "0001",
  "versionCreatedAt": "2023-03-02T14:25:59.078Z",
  "mandateScheme": "SEPA_B2B",
  "mandateReference": "SEPA-20230906-ABC123",
  "status": "ACTIVE",
  "referenceInstructions": {
    "mandatePrefix": "SEPA-20230906"
  },
  "debtorName": "John Doe",
  "debtorAddress": {
    "city": "Berlin",
    "countryCode": "DE",
    "number": "123",
    "addressLine1": "Main Street",
    "postCode": "12345"
  },
  "debtorBank": {
    "iban": "DE89370400440532013000",
    "bankName": "Example Bank",
    "bic": "EXBKDE81XXX"
  },
  "creditorName": "ABC Corporation",
  "creditorIdentifier": "DE98ZZZ09999999999",
  "creditorAddress": {
    "city": "Munich",
    "countryCode": "DE",
    "number": "456",
    "addressLine1": "Leopoldstr.",
    "postCode": "80807"
  },
  "activation": {
    "mandateSignedLocation": "Berlin",
    "mandateDateOfSignature": "2023-09-06",
    "mandateAcceptance": "ONLINE",
    "storedPaymentOptionReference": "8ac7a4a266c593040166d4b7d08e2201"
  },
  "account": {
    "customerAccountId": "CUST-12345",
    "billingAddress": {
      "city": "Berlin",
      "countryCode": "DE",
      "number": "123",
      "addressLine1": "Main Street",
      "postCode": "12345"
    },
    "isBusinessUser": true,
    "businessConsumer": {
      "companyName": "ABC Corporation",
      "companyType": "Limited Liability Company",
      "emailAddress": "contact@abccorp.com",
      "taxId": "DE987654321",
      "culture": "en_US"
    }
  },
  "additionalData": [
    {
      "name": "jpmcoid",
      "value": "12345"
    }
  ]
}

SEPA Core

Get SEPA CORE mandate by ID

{
  "id": "c3f1e61e-3643-4b5d-b338-4dac91036112",
  "object": "MANDATE",
  "createdAt": "2025-04-01T13:41:00.990Z",
  "status": "CREATED",
  "mandateScheme": "SEPA_CORE",
  "referenceInstructions": {
    "mandatePrefix": "TEST25"
  },
  "debtorName": "Debtor T",
  "debtorAddress": {
    "city": "Berlin",
    "countryCode": "DE",
    "number": "123",
    "addressLine1": "Main Street",
    "postCode": "12345"
  },
  "debtorBank": {
    "iban": "DE89370400440532013000",
    "bankName": "Example Bank",
    "bic": "EXBKDE81XXX"
  },
  "account": {
    "customerAccountId": "CUST-5AR-00002",
    "billingAddress": {
      "city": "Berlin",
      "countryCode": "DE",
      "number": "123",
      "addressLine1": "Main Street",
      "postCode": "12345"
    },
    "isBusinessUser": false,
    "consumer": {
      "emailAddress": "CUST-5AR-00002@abccorp.com",
      "dateOfBirth": "2001-12-12",
      "firstName": "Debtor",
      "lastName": "T",
      "culture": "en_US",
      "middleName": "Str",
      "title": "T",
      "gender": "male",
      "mobilePhone": "012345678",
      "homePhone": "012345678",
      "workPhone": "012345678",
      "taxId": "DE12345678"
    }
  },
  "creditorName": "MPS",
  "creditorIdentifier": "IT123456789",
  "creditorAddress": {
    "number": "35",
    "addressLine1": "Via Puglia",
    "postCode": "10156",
    "city": "Torino",
    "countryCode": "IT"
  },
  "additionalData": [
    {
      "name": "jpmcoid",
      "value": "12345"
    }
  ],
  "mandateReference": "TEST25-FPYVTW8JB8GU38DTDPPBVLB1WJH7",
  "versionTag": "0001",
  "versionCreatedAt": "2025-04-01T13:41:00.990Z"
}

400

Bad Request

info

For error handling, please refer to this section.

application/json

Schema

Schema

errorstring
errorDetails object
contextobject
gatewayDescriptionstring
paymentProviderDescriptionstring
message object
oneOf
• string
• string[]
string

Example (auto)

{
  "error": "string",
  "errorDetails": {
    "context": {},
    "gatewayDescription": "string",
    "paymentProviderDescription": "string"
  },
  "message": "string"
}

Example

{
  "traceId": "00-1234567890abcdef0123456789abcdef-0123456789abcdef-00",
  "errors": [
    {
      "message": "Value out of bounds. Value must be between 1 and 100",
      "code": "value_out_of_bounds",
      "property": "someField",
      "context": {
        "minimum": 1,
        "maximum": 100
      }
    }
  ]
}

401

Unauthenticated

info

For error handling, please refer to this section.

application/json

Schema

Schema

errorstring
errorDetails object
contextobject
gatewayDescriptionstring
paymentProviderDescriptionstring
message object
oneOf
• string
• string[]
string

Example (auto)

{
  "error": "string",
  "errorDetails": {
    "context": {},
    "gatewayDescription": "string",
    "paymentProviderDescription": "string"
  },
  "message": "string"
}

Example

{
  "traceId": "00-1234567890abcdef0123456789abcdef-0123456789abcdef-00",
  "errors": [
    {
      "message": "You are not authenticated to perform this request.",
      "code": "unauthorized"
    }
  ]
}

403

Forbidden

info

For error handling, please refer to this section.

application/json

Schema

Schema

errorstring
errorDetails object
contextobject
gatewayDescriptionstring
paymentProviderDescriptionstring
message object
oneOf
• string
• string[]
string

Example (auto)

{
  "error": "string",
  "errorDetails": {
    "context": {},
    "gatewayDescription": "string",
    "paymentProviderDescription": "string"
  },
  "message": "string"
}

Example

{
  "traceId": "00-1234567890abcdef0123456789abcdef-0123456789abcdef-00",
  "errors": [
    {
      "message": "You do not have permissions to perform this request.",
      "code": "forbidden"
    }
  ]
}

404

Not Found

info

For error handling, please refer to this section.

application/json

Schema

Schema

errorstring
errorDetails object
contextobject
gatewayDescriptionstring
paymentProviderDescriptionstring
message object
oneOf
• string
• string[]
string

Example (auto)

{
  "error": "string",
  "errorDetails": {
    "context": {},
    "gatewayDescription": "string",
    "paymentProviderDescription": "string"
  },
  "message": "string"
}

Example

{
  "traceId": "00-1234567890abcdef0123456789abcdef-0123456789abcdef-00",
  "errors": [
    {
      "message": "Resource not found.",
      "code": "not_found"
    }
  ]
}

500

Internal Server Error

info

For error handling, please refer to this section.

application/json

Schema

Schema

errorstring
errorDetails object
contextobject
gatewayDescriptionstring
paymentProviderDescriptionstring
message object
oneOf
• string
• string[]
string

Example (auto)

{
  "error": "string",
  "errorDetails": {
    "context": {},
    "gatewayDescription": "string",
    "paymentProviderDescription": "string"
  },
  "message": "string"
}

Example

{
  "traceId": "00-1234567890abcdef0123456789abcdef-0123456789abcdef-00",
  "errors": [
    {
      "message": "Internal server error."
    }
  ]
}