---
title: "Retrieve an open banking mandate"
method: GET
path: "/open-banking/mandates/{mandate_id}"
tags: ["Variable Recurring Payments"]
---

# Retrieve an open banking mandate

`GET /open-banking/mandates/{mandate_id}`

Returns an open banking mandate using the unique `mandate_id`. This identifier can be found via the `mandate_active` webhook or Hosted Checkout redirect after a customer authenticates their open banking connection.

## Path parameters

- `mandate_id` string, required

## Headers

- `Company-Id` string, uuid
- `Mid` string, uuid

## Response `200`

OK

- object
  - `id` string — The unique ID assigned to the open banking mandate.
  - `company_id` string — Unique ID assigned by Acquired.com for your company.
  - `bank_id` string — The unique ID associated with the bank the mandate has been created against.
  - `type` 'SWEEPING' | 'VISA_A2A' | 'COMMERCIAL' — The type of mandate that has been created.
  - `debtor` object
    - `customer_id` string, uuid — The unique ID of the customer associated with this mandate.
    - `account_number` string — The account number for the bank account the mandate is associated with to debit.
    - `sort_code` string — The sort code for the bank account the mandate is associated with to debit.
    - `account_name` string — The account name for the bank account the mandate is associated with to debit.
  - `creditor` object
    - `account_number` string — The account number for the bank account the mandate is associated with to credit.
    - `sort_code` string — The sort code for the bank account the mandate is associated with to credit.
    - `account_name` string — The account name for the bank account the mandate is associated with to credit.
  - `currency` string — The currency allowed for payments taken against this mandate.
  - `periodic_limit` object
    - `per_payment` object
      - `maximum_amount` number — The maximum amount of funds that can be taken in a single payment.
    - `day` object
      - `maximum_amount` number — The maximum amount of funds that can be taken in a single day period aligned with the alignment field.
      - `alignment` 'CALENDAR' | 'CONSENT' — The alignment to identify whether the day is aligned by the calendar date-time, or by the date-time of mandate authorization.
    - `week` object
      - `maximum_amount` number — The maximum amount of funds that can be taken in a single week period aligned with the alignment field.
      - `alignment` 'CALENDAR' | 'CONSENT' — The alignment to identify whether the week is aligned by the calendar date-time, or by the date-time of mandate authorization.
    - `fortnight` object
      - `maximum_amount` number — The maximum amount of funds that can be taken in a single fortnight period aligned with the alignment field.
      - `amount` number — The maximum amount of funds that can be taken in a single fortnight period aligned with the alignment field.
      - `alignment` 'CONSENT' — Fortnight alignments must always be aligned with the date-time of consent, as there is no clear start time for a fortnight on the calendar.
    - `month` object
      - `maximum_amount` number — The maximum amount of funds that can be taken in a single month period aligned with the alignment field.
      - `alignment` 'CALENDAR' | 'CONSENT' — The alignment to identify whether the month is aligned by the calendar date-time, or by the date-time of mandate authorization.
    - `half_year` object
      - `maximum_amount` number — The maximum amount of funds that can be taken in a single 6-month period aligned with the alignment field.
      - `alignment` 'CALENDAR' | 'CONSENT' — The alignment to identify whether the 6 month period is aligned by the calendar date-time, or by the date-time of mandate authorization.
    - `year` object
      - `maximum_amount` number — The maximum amount of funds that can be taken in a single year period aligned with the alignment field.
      - `alignment` 'CALENDAR' | 'CONSENT' — The alignment to identify whether the year is aligned by the calendar date-time, or by the date-time of mandate authorization.
  - `term` object
    - `start_date` string, date-time — The date which the mandate is active from.
    - `end_date` string, date-time — The date which the mandate is active until.
  - `status` string — The current status of the mandate.
  - `reference` string — The reference to be used for payments made against this mandate.
  - `created_at` string, date-time — The time the mandate was created in UTC.

## Other responses

- `400`
- `401`
- `403`
- `500`

---

[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)