---
title: Get mandates
description: Retrieve a paged list of DebiPay mandates using the collection endpoint.
openapi: /openapi/debi-pay-api.yaml GET /api/v1/mandates
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

Use this endpoint to list mandates that match your query criteria. It is suitable for merchant dashboards, customer support tools, and reconciliation tasks where you need to review multiple mandate records at once.

<Info>
The collection endpoint supports pagination and filtering by mandate type or merchant, which makes it suitable for large mandate inventories.
</Info>

## Query parameters

You can use the following query filters with the request:

- `Key` for simple text search support
- `Page` and `PageSize` for pagination
- `MandateTypeId` to filter by mandate type
- `MerchantId` to narrow the results to a specific merchant

## Response handling

The response returns a paged result set of mandate records. Review the generated schema in the right panel to understand the fields included in each item and the pagination metadata returned with the payload.

<Tip>
Use pagination when you expect a large number of mandates so the API can return a manageable page size.
</Tip>

## Related pages

- [Get a mandate by id](./mandates-get-id)
- [Create a mandate](./mandates-create)
- [Get mandate transactions](./mandates-id-transactions)


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://mutex-core-apis.jamdesk.app/api-specs.zip