---
title: "List all direct debit mandates"
method: GET
path: "/v1/mandates"
tags: ["Direct Debits"]
---

# List all direct debit mandates

`GET /v1/mandates`

This endpoint will list all mandates on your Fire account. You will need to enable PERM_BUSINESS_GET_MANDATES to use this endpoint.

## Response `200`

List all direct debit mandates.

- object
  - `total` integer — Number of direct debits found
  - `mandates` Mandate[]
    - `mandateUuid` string — The UUID for the mandate
    - `currency` Currency — The currency.
      - `code` string — The three letter code for the currency.
      - `description` string — The name of the currency
    - `status` 'CREATED' | 'LIVE' | 'REJECT_REQUESTED' | 'REJECT_RECORD_IN_PROGRESS' | 'REJECT_RECORDED' | 'REJECT_FILE_CREATED' | 'REJECT_FILE_SENT' | 'CANCEL_REQUESTED' | 'CANCEL_RECORD_IN_PROGRESS' | 'CANCEL_RECORDED' | 'CANCEL_FILE_CREATED' | 'CANCEL_FILE_SENT' | 'COMPLETE' | 'DORMANT' — The status of the mandate. * 'CREATED' * 'LIVE' * 'REJECT_REQUESTED' * 'REJECT_RECORD_IN_PROGRESS' * 'REJECT_RECORDED' * 'REJECT_FILE_CREATED' * 'REJECT_FILE_SENT' * 'CANCEL_REQUESTED' * 'CANCEL_RECORD_IN_PROGRESS' * 'CANCEL_RECORDED' * 'CANCEL_FILE_CREATED' * 'CANCEL_FILE_SENT' * 'COMPLETE' * 'DORMANT'
    - `originatorReference` string — Set by party who sets up the direct debit.
    - `originatorName` string — The creator of the party who sets up the direct debit.
    - `originatorAlias` string — The name of the alias
    - `originatorLogoUrlSmall` string — Logo url from party who sets up the direct debit.
    - `originatorLogoUrlLarge` string — Logo url from party who sets up the direct debit.
    - `mandateReference` string — the reference of the mandate
    - `alias` string — The name of the alias
    - `targetIcan` integer — Identifier for the fire.com account (assigned by fire.com)
    - `numberOfDirectDebitCollected` integer — The number of direct debits collected
    - `valueOfDirectDebitCollected` integer — The value of direct debits collected
    - `latestDirectDebitAmount` integer — The value of largest direct debit collected
    - `latestDirectDebitDate` string, date-time — The date of latest direct debit collected
    - `fireRejectionReason` 'ACCOUNT_DOES_NOT_ACCEPT_DIRECT_DEBITS' | 'DDIC' | 'ACCOUNT_NOT_FOUND' | 'ACCOUNT_NOT_LIVE' | 'CUSTOMER_NOT_FOUND' | 'BUSINESS_NOT_LIVE' | 'BUSINESS_NOT_FULL' | 'PERSONAL_USER_NOT_LIVE' | 'PERSONAL_USER_NOT_FULL' | 'MANDATE_ALREADY_EXISTS' | 'MANDATE_WITH_DIFERENT_ACCOUNT' | 'NULL_MANDATE_REFERENCE' | 'INVALID_ACCOUNT_CURRENCY' | 'INVALID_MANDATE_REFERENCE' | 'REQUESTED_BY_CUSTOMER_VIA_SUPPORT' | 'CUSTOMER_ACCOUNT_CLOSED' | 'CUSTOMER_DECEASED' | 'ACCOUNT_TRANSFERRED' | 'MANDATE_NOT_FOUND' | 'ACCOUNT_TRANSFERRED_TO_DIFFERENT_ACCOUNT' | 'INVALID_ACCOUNT_TYPE' | 'MANDATE_EXPIRED' | 'MANDATE_CANCELLED' | 'REQUESTED_BY_CUSTOMER' — Rejection reason if transaction is rejected
    - `schemeCancelReason` string — Reason for cancelation
    - `schemeCancelReasonCode` string — The cancelation code returned by the bank indicating an issue with the direct debit. Each ARRUD code represents a rejection reason.
    - `lastUpdated` string, date-time — Date the direct debit was last updated. Milliseconds since the epoch (1970).
    - `dateCreated` string, date-time — Date the direct debit was created. Milliseconds since the epoch (1970).
    - `dateCompleted` string, date-time — Date the direct debit was completed. Milliseconds since the epoch (1970).
    - `dateCancelled` string, date-time — Date the direct debit was canceled. Milliseconds since the epoch (1970).

## Other responses

- `400` — An error has occured. Any 403 errors usually mean your access token is invalid or missing. For other errors, check the validity of your input, and if you are permitted to access this endpoint.
- `401` — An error has occured. Any 403 errors usually mean your access token is invalid or missing. For other errors, check the validity of your input, and if you are permitted to access this endpoint.
- `403` — An error has occured. Any 403 errors usually mean your access token is invalid or missing. For other errors, check the validity of your input, and if you are permitted to access this endpoint.

---

[API](https://skmtc.net/firefinancialservices/apis/fire-financial-services-business-api.md) · [All operations](https://skmtc.net/firefinancialservices/apis/fire-financial-services-business-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firefinancialservices/fire-financial-services-business-api/versions/1d19896d095c/schema)