---
title: "Get Mandates based on search criteria."
method: GET
path: "/mandates"
tags: ["Direct Debits"]
---

# Get Mandates based on search criteria.

`GET /mandates`

If trying to find one or several particular mandates, then you can narrow down your search by using the filters available here. These include the mandate id, either the submitted or created date range, the account name on the mandate, etc...

## Query parameters

- `id` string[] — Id(s) of Mandate(s) to fetch.
- `accountId` string[] — Id(s) of account to fetch Mandates for.
- `q` string — Query parameter. ID, name or reference of mandate to search for
- `fromCreatedDate` string — Mandates created on or after this date.
- `toCreatedDate` string — Mandates created on or before this date.
- `fromSubmittedDate` string — Mandates submitted on or after this date.
- `toSubmittedDate` string — Mandates submitted on or before this date.
- `status` string[] — Status of the Mandate
- `name` string — Account Name on the Mandate
- `reference` string — reference of the Mandate
- `externalReference` string — externalReference of the Mandate
- `bulkCreateRequestId` string — Bulk create request ID
- `bulkCancelRequestId` string — Bulk cancel request ID
- `sortField` string — Sort by field
- `sortOrder` 'ASC' | 'DESC' — Sort order
- `page` integer — Page to fetch (zero-indexed)
- `size` integer — Size of page to fetch.

## Response `200`

OK

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.net/modulrfinance/apis/modulr-api.md) · [All operations](https://skmtc.net/modulrfinance/apis/modulr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modulrfinance/modulr-api/versions/cbd52524c8ef/schema)