---
title: "SEPA mandate object"
url: "https://help.internetx.com/en/api/core-sepa-mandate-object/"
lang: "en"
section: "API reference — API reference (XML/JSON)"
breadcrumb: "API documentation (JSON/XML) > Objects"
updated: "2023-09-25"
---

# SEPA mandate object

## Description

The _SEPA Mandate_ object represents the SEPA mandate of a customer.

## Structure

| **Keyword JSON** | **Keyword XML** | **Occurs** | **Type** | **Format** | **Description** |
| --- | --- | --- | --- | --- | --- |
| created | created | 1 | string | date-time | Date on which the SEPA mandate was created. |
| updated | updated | 1 | string | date-time | Date on which the SEPA mandate was updated. |
| document | document | 1 | object | [Document](/de/api/core-objekt-document/) | SEPA mandate as PDF document |
| reference | reference | 1 | string |  | The SEPA mandate reference |
| confirmSignature | confirm\_signature | 0 -1 | string | date-time | Date on which the SEPA mandate was confirmed. |
| confirmIP | confirm\_ip | 0 -1 | string |  | IP via which the SEPA mandate was confirmed. |
| confirmUseragent | confirm\_useragent | 0 -1 | string |  | User Agent with which the SEPA mandate was confirmed. |
| confirmChecked | confirm\_checked | 0 -1 | boolean |  | Flag indicating whether the confirmation data has been checked.<br>• false = confirmation data was not checked<br>• true = confirmation data has been checked<br>Default value = false<br>For XML, 0 (false) and 1 (true) can also be used. |
| expire | expire | 1 | string |  | Expiration date of the SEPA mandate |
| histories | history | 0 - n | object | SEPAMandate | List of previous SEPA mandates |
| status | status | 1 | enum | [SEPAStatus](/en/api/core-sepa-status-enum/) | SEPA mandate status |
| accountHolder | bank\_account\_holder | 1 | string |  | Owner of the bank account to which the SEPA mandate applies. |
| iban | bank\_iban | 1 | string |  | IBAN of the account to which the SEPA mandate appli |
| bic | bank\_bic | 1 | string |  | BIC of the account for which the SEPA mandate applies. |
|  | customer | 1 | object | [BasicCustomer](/en/api/core-basic-customer-object/) | The customer to whom the SEPA mandate belongs. |
|  | message\_sent | 0 -1 | string | date-time | Date on which the notification for a new SEPA mandate was sent. |
|  | creditor\_identifier | 1 | string |  | Creditor reference |
|  | bank\_name | 1 | string |  | Name of the bank for which the SEPA mandate applies. |
|  | confirm\_signature\_city | 0 - 1 | string |  | Place where the SEPA mandate was confirmed |
|  | confirm\_date | 0 - 1 | string | date-time | Date on which the SEP mandate was confirmed |