---
title: "Get a list of direct debit mandates"
method: GET
path: "/api/v2/direct-debit/mandates"
tags: ["Direct Debit Mandates"]
---

# Get a list of direct debit mandates

`GET /api/v2/direct-debit/mandates`

## Response `200`

Successful operation

- DirectDebitMandatesV2 — List of mandates
  - `mandates` DirectDebitMandateV2[]
    - `uid` string, uuid
    - `reference` string
    - `status` 'CANCELLED' | 'LIVE' | 'PENDING_CAS'
    - `source` 'ELECTRONIC' | 'PAPER'
    - `created` string, date-time
    - `cancelled` string, date-time
    - `nextDate` string, date
    - `lastDate` string, date
    - `originatorName` string
    - `originatorUid` string, uuid
    - `merchantUid` string, uuid
    - `lastPayment` LastPayment, nullable — Last direct debit payment
      - `lastDate` string, date
      - `lastAmount` CurrencyAndAmount — Representation of money
        - `currency` string, required — ISO-4217 3 character currency code
        - `minorUnits` integer, required — Amount in the minor units of the given currency; eg pence in GBP, cents in EUR
    - `accountUid` string, uuid
    - `categoryUid` string, uuid

## Other responses

- `4xx` — Client error. See [API status codes](#api-status-codes-1) for more details.
- `5xx` — Server error. See [API status codes](#api-status-codes-1) for more details.

---

[API](https://skmtc.net/starlingbank/apis/starling-bank-api.md) · [All operations](https://skmtc.net/starlingbank/apis/starling-bank-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/starlingbank/starling-bank-api/revisions/fa1a72b9ecec/schema)