---
title: "List mandate payments"
method: GET
path: "/v0/mandates/{mandate-id}/payments"
tags: ["Mandates"]
---

# List mandate payments

`GET /v0/mandates/{mandate-id}/payments`

## Request

- Base URL: `https://api.griffin.com`
- URL: `https://api.griffin.com/v0/mandates/{mandate-id}/payments`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/griffin/apis/the-griffin-api/docs/v0/mandates/:mandate-id/payments/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists payments for a direct debit mandate.

## Path parameters

- `mandate-id` string, required

## Query parameters

- `sort` '-created-at' | 'created-at'
- `page[size]` integer
- `page[before]` string, byte
- `page[after]` string, byte
- `include` string[]

## Response `200`

OK

- object: Present only when the request uses the `include` parameter.
  - `payments` object[], required
    - `creditor` union
      - object
        - `account-url` union, required: Link to the bank account resource.
          - string
          - string
        - `creditor-type` 'griffin-bank-account', required
      - object: Creditor specified with bank details
        - `iban` string: An International Bank Account Number.
        - `uk-domestic-sort-code` string: A UK sort code.
        - `bic` string: A BIC.
        - `account-number` string: A UK account number.
        - `account-holder` string: The name of the [account holder](/docs/terms/account-holder).
        - `bank-id-code` 'gbdsc'
        - `bank-id` string: A UK sort code.
        - `creditor-type` 'uk-domestic', required
        - `bban` string: A country-specific Basic Bank Account Number.
        - `account-url` union: Link to the bank account resource.
          - string
          - string
        - `uk-domestic-account-number` string: A UK account number.
        - `other-account-identification` string: Uncategorised account identification
        - `account-number-code` 'bban'
        - `other-institution-identification` string: Uncategorised financial institution identification
    - `rejected-at` string, date-time: ISO 8601 formatted date-time.
    - `latest-submission-url` string: Most recent submission (if any made)
    - `rejected-by-url` string: Link to the user.
    - `payment-direction` 'inbound-payment' | 'outbound-payment', required: Whether the payment is moving money into or out of the account.
    - `created-by-url` string: Link to the user.
    - `created-via` 'api' | 'ui'
    - `created-at` string, date-time, required: ISO 8601 formatted date-time.
    - `payment-url` string, required: Link to the payment resource.
    - `payment-reference` string: Free-text field to help identify and categorise payments.
    - `payment-amount` object, required: Compound value representing both the currency and amount of money being sent.
      - `currency` 'GBP', required
      - `value` string, required: The value as a decimal-formatted string
    - `payment-type` 'credit-transfer' | 'direct-debit', required: Whether the payment is a credit transfer or direct debit.
    - `ultimate-debtor` object
      - `iban` string: An International Bank Account Number.
      - `uk-domestic-sort-code` string: A UK sort code.
      - `bic` string: A BIC.
      - `account-number` string: A UK account number.
      - `account-holder` string: The name of the [account holder](/docs/terms/account-holder).
      - `bank-id-code` 'gbdsc'
      - `bank-id` string: A UK sort code.
      - `bban` string: A country-specific Basic Bank Account Number.
      - `account-url` union: Link to the bank account resource.
        - string
        - string
      - `uk-domestic-account-number` string: A UK account number.
      - `other-account-identification` string: Uncategorised account identification
      - `account-number-code` 'bban'
      - `other-institution-identification` string: Uncategorised financial institution identification
    - `payment-admissions-url` string: Link to the endpoint for listing payment admissions.
    - `payment-submissions-url` string: Link to the endpoint for creating and listing payment submissions.
    - `debtor` object
      - `iban` string: An International Bank Account Number.
      - `uk-domestic-sort-code` string: A UK sort code.
      - `bic` string: A BIC.
      - `account-number` string: A UK account number.
      - `account-holder` string: The name of the [account holder](/docs/terms/account-holder).
      - `bank-id-code` 'gbdsc'
      - `bank-id` string: A UK sort code.
      - `bban` string: A country-specific Basic Bank Account Number.
      - `account-url` union: Link to the bank account resource.
        - string
        - string
      - `uk-domestic-account-number` string: A UK account number.
      - `other-account-identification` string: Uncategorised account identification
      - `account-number-code` 'bban'
      - `other-institution-identification` string: Uncategorised financial institution identification
    - `rejection-reason` string, nullable
    - `mandate-url` union: Link to a direct debit mandate.
      - string
      - string
  - `links` object, required
    - `prev` string, nullable, required
    - `next` string, nullable, required

## Other responses

- `400`: Bad Request
- `401`: Requires an API key to continue
- `404`: Not Found

## Changes

- **2026-09-19** `3e69d9e24ef6`: 1 info
  - api operation id `get-mandates-mandate-id-payments` was added
- **2026-09-11** `94e93f84269b`: 1 info
  - added the new optional `query` request parameter `sort`
- **2026-08-06** `178ed43d543b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/griffin/apis/the-griffin-api/changes/v0/mandates/:mandate-id/payments/get.md)

---

[API](https://skmtc.dev/griffin/apis/the-griffin-api.md) - [All operations](https://skmtc.dev/griffin/apis/the-griffin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/griffin/apis/the-griffin-api/revisions/9e4c303c70a5?raw)