LElemon
Payment Instrument Mandates

List Payment Instrument Mandates

Changed on

<strong>Preview:</strong> This endpoint is a preview API and may change without a deprecation period.

Lists the payment instrument mandates of the customer account, newest first. <code>canceled</code> and <code>rejected</code> mandates remain listed as history. Filters can be combined.

get/accounts/{account_id}/payment_instrument_mandates

Request

Path parameters

account_idstring required

An account identifier.

Query parameters

'canceled' | 'confirmed' | 'created' | 'rejected'

A category representing the status of a payment instrument mandate:

<ul> <li><code>canceled</code>: The mandate was canceled by the customer and can no longer be used. <li><code>confirmed</code>: The mandate was confirmed and can be used for collections. <li><code>created</code>: The mandate was created and awaits confirmation. <li><code>rejected</code>: lemon.markets decided that the mandate cannot be confirmed or can no longer be used. </ul>
OR
'*'

Only return mandates whose current status is the given one. Set to <code>*</code> to return mandates of every status, the same as omitting this parameter.

type'sepa_direct_debit'

A category representing the payment method of a payment instrument mandate:

<ul> <li><code>sepa_direct_debit</code>: A SEPA Direct Debit (Core) mandate for recurrent collections. </ul>

Only return mandates of the given payment method.

mandate_referencestring

Only return the mandate with the given mandate reference. The comparison ignores case.

cursorstring

A pagination cursor. When you receive a paginated response containing the property pagination.next_cursor, you can pass its value here to get the next page of results for your query. A cursor will include filter parameters, so there is not need to specify both the cursor and any other filter parameter.

limitinteger

In order to customize the number of elements returned, you can provide a limit here. The service will not return more elements than specified.

Headers

LMG-Data-Privacy-Access-Principalstring required
LMG-Data-Privacy-Access-Justificationstring required

Response

Successful Response

Example response

{
  "data": [
    {
      "id": "pinst_mand_f3a42ba00cb84618a549d975662c90b3",
      "mandate_reference": "LM0A1B2C3D4E5F6G7H8J9K",
      "debtor": {
        "iban": "DE02120300000000202051",
        "bic": "BYLADEM1001",
        "account_holder_name": "Erika Mustermann"
      },
      "creditor": {
        "identifier": "DE98ZZZ09999999999",
        "name": "lemon.markets brokerage GmbH",
        "address": {
          "line_1": "Prinzessinnenstrasse 19-20",
          "postal_code": "10969",
          "city": "Berlin",
          "country": "DE"
        }
      },
      "sca": {
        "challenge": "K7_yR-7ZpTqgeWQ4-bx7Kg=="
      },
      "history": [
        {
          "timestamp": "2026-10-19T09:15:00.123456+00:00"
        }
      ]
    }
  ],
  "pagination": {
    "next_cursor": "<opaque-data>"
  }
}

Changes