---
title: "Get a transaction history for a direct debit"
method: GET
path: "/api/v2/direct-debit/mandates/{mandateUid}/payments"
tags: ["Direct Debit Mandates"]
---

# Get a transaction history for a direct debit

`GET /api/v2/direct-debit/mandates/{mandateUid}/payments`

## Request

- Base URL: `https://api.starlingbank.com`
- URL: `https://api.starlingbank.com/api/v2/direct-debit/mandates/{mandateUid}/payments`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/starlingbank/apis/starling-bank-api/docs/api/v2/direct-debit/mandates/:mandateUid/payments/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `mandateUid` string, uuid, required

## Query parameters

- `since` string, date, required

## Response `200`

Successful operation

- DirectDebitPaymentsResponse: Transaction history for a direct debit
  - `directDebitPayments` DirectDebitPayment[], required: List of processed direct debit mandate payments
    - `paymentAmount` 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
    - `createdAt` string, date-time: Date when direct debit payment was created

## 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.dev/starlingbank/apis/starling-bank-api.md) - [All operations](https://skmtc.dev/starlingbank/apis/starling-bank-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starlingbank/apis/starling-bank-api/revisions/7c5075cfbe63?raw)