---
title: "Retrieve a mandate"
method: GET
path: "/mandates/{mandate_id}"
tags: ["Direct Debit"]
---

# Retrieve a mandate

`GET /mandates/{mandate_id}`

Utilize this endpoint to retrieve information associated with a specific mandate. Just add the necessary mandate_id to your request, and we will return the relevant data.

## Path parameters

- `mandate_id` string, uuid, required

## Query parameters

- `filter` string

## Response `200`

OK

- object
  - `mandate_id` string, uuid — Unique identifier assigned by Acquired.com for the mandate record.
  - `status` 'pending' | 'active' | 'rejected' | 'cancelled' — The current status of the mandate.
  - `mandate_type` 'direct_debit' — The type of mandate that is being created.
  - `reference` string — The internal reference assigned to the mandate.
  - `bacs_reference` string — The Bacs reference assigned to the mandate by the scheme, as shown on the payer's bank statement. Returned as an empty string if not yet available.
  - `payer_detail` object
    - `account_name` string — The name on the bank account.
    - `account_number_ending` string — The account number for the account.
  - `detail` object
    - `scheme` 'bacs' — The scheme associated to the transaction.
    - `report` 'AUDDIS' | 'ADDACS' — Each of these statuses represent a specific stage or notification within the Bacs system.
    - `reason_code` '1' | '2' | '3' | '5' | '6' | '7' | 'B' | 'C' | 'F' | 'G' | 'H' | 'I' | 'K' | 'L' | 'M' | 'N' | 'O' | 'P' | 'Q' | '0' | 'D' | 'E' | 'R' — The specific reason code carries details explaining the content of the notification on the report.
    - `reason_description` 'Instruction cancelled' | 'Payer deceased' | 'Account transferred' | 'No account' | 'No instruction' | 'DDI amount not zero' | 'Account closed' | 'Account transferred to a different branch of the bank/building society' | 'Invalid account type' | 'Bank will not accept Direct Debits on account' | 'Instruction has expired' | 'Payer reference is not unique' | 'Instruction cancelled by paying bank' | 'Incorrect payer's account details' | 'Transaction code/user status incompatible' | 'Transaction disallowed at payer's branch' | 'Invalid reference' | 'Payer's name not present' | 'Service user's name blank' | 'Instruction cancelled-refer to payer' | 'Instruction cancelled by payer' | 'Advance notice disputed' | 'Instruction amended' | 'Instruction reinstated' — Provides a description for the relating reason code.
    - `rejected_date` string, date-time — The date and time the mandate record was rejected.
  - `created` string, date-time — The date and time that the mandate was created.
  - `last_updated` string, date-time — The date and time that the mandate was last updated.
  - `links` object[]
    - `rel` 'customer'
    - `href` string — Link to the resource which should be appended to base URL.

## Other responses

- `400` — An error occurred
- `401` — An error occurred
- `500` — Internal Server error

---

[API](https://skmtc.dev/acquired/apis/acquired-api.md) · [All operations](https://skmtc.dev/acquired/apis/acquired-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/acquired/acquired-api/revisions/7ae178a046f2/schema)