Get mandates

Retrieve a paged list of DebiPay mandates using the collection endpoint.

GEThttps://api.debipay.co.za/api/v1/mandates
Loading code example

Query Parameters

Keystring
Pageinteger | string<int32>
Pattern: ^-?(?:0|[1-9]\d*)$
PageSizeinteger | string<int32>
Pattern: ^-?(?:0|[1-9]\d*)$
MandateTypeIdinteger | string<int32>
Pattern: ^-?(?:0|[1-9]\d*)$
MerchantIdstring

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.

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

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.

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