---
title: "List Payment Instrument Mandates"
method: GET
path: "/accounts/{account_id}/payment_instrument_mandates"
tags: ["Payment Instrument Mandates"]
---

# List Payment Instrument Mandates

`GET /accounts/{account_id}/payment_instrument_mandates`

## Request

- Base URL: `https://sandbox.api.lemon.markets/v1`
- URL: `https://sandbox.api.lemon.markets/v1/accounts/{account_id}/payment_instrument_mandates`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/docs/accounts/:account_id/payment_instrument_mandates/get.ts> (a function with typed inputs; its response is checked against the schema)

<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.

## Path parameters

- `account_id` string, required

## Query parameters

- `status` union
  - '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>
  - '*'
- `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>
- `mandate_reference` string
- `cursor` string
- `limit` integer

## Headers

- `LMG-Data-Privacy-Access-Principal` string, required
- `LMG-Data-Privacy-Access-Justification` string, required

## Response `200`

Successful Response

- EncodedPaginatedCollectionResponsePaymentInstrumentMandateResponse
  - `data` PaymentInstrumentMandateResponse[], required: The elements of the response.
    - `id` string, required: An identifier for the payment instrument mandate.
    - `type` 'sepa_direct_debit', required: 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>
    - `mandate_reference` string, required: The unique mandate reference, assigned by lemon.markets.
    - `debtor` PaymentInstrumentMandateDebtorResponse, required: The customer's bank account that the mandate authorizes collections from.
      - `iban` string, required
      - `bic` string: Omitted when not available.
      - `account_holder_name` string, required
    - `creditor` PaymentInstrumentMandateCreditorResponse, required: lemon.markets as the collecting party, as it must be presented to the customer.
      - `identifier` string, required: The SEPA Creditor Identifier.
      - `name` string, required
      - `address` PaymentInstrumentMandateCreditorAddressResponse, required
        - `line_1` string, required
        - `line_2` string: Omitted when not available.
        - `postal_code` string, required
        - `city` string, required
        - `country` string, required: An ISO 3166-1 alpha-2 country code.
    - `sca` PaymentInstrumentMandateScaResponse: The Strong Customer Authentication configuration of the mandate. Only present while the mandate has status <code>created</code>.
      - `required` boolean, required: Whether confirming the mandate requires a signed challenge.
      - `challenge` string: The challenge the customer signs with a registered authenticator. Only present when <code>required</code> is <code>true</code>.
    - `history` StatusChangePaymentInstrumentMandateStatus[], required: The status changes of the mandate, newest first. The current status is the first entry.
      - `status` 'canceled' | 'confirmed' | 'created' | 'rejected', required: 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>
      - `timestamp` string, date-time, required: The timestamp of the event. It represents the point in time at which the payment instrument mandate was updated.
  - `pagination` EncodedPaginationResponse, required: Information about accessing elements beyond the ones that were returned.
    - `next_cursor` string: When fetching long lists of elements, you can use our pagination feature to fetch batches of data. If a response contains the property `pagination.next_cursor`, you can pass its value via the query item `cursor` to generate the request for the next batch of data.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `422`: Unprocessable Entity
- `5XX`: Server Error

## Changes

- **2026-11-03** `1f1df208c0e4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/changes/accounts/:account_id/payment_instrument_mandates/get.md)

---

[API](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api.md) - [All operations](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/revisions/1f1df208c0e4?raw)