---
title: List Mandate API
description: Retrieve the complete list of mandates or subscription agreements for a merchant or customer.
---

Retrieve the complete list of mandates or subscription agreements for a given merchant or customer. Includes detailed information on start/end dates, amount, payment channel, and current subscription status (subscribed, unsubscribed). Useful for dashboards, reporting, or customer support.

#### POST

```
https://payments.airpay.co.in/pay/v4/api/mandates/list_mandate.php
```

## Header

| Parameter | Type Value | Description | Value Like |
| --- | --- | --- | --- |
| Content-Type  required | String | The Content-Type header specifies the media type of the request or response body, allowing the receiver to correctly interpret the For XML data, use application/xml. | `For JSON: application/json,For XML: application/xml` |

## Request Body

| Parameter | Type Value | Description | Value Like |
| --- | --- | --- | --- |
| page_number  required | Numeric  <br>(1–10) | `0` |

## Success 200

| Parameter | Type Value | Description | Value Like |
| --- | --- | --- | --- |
| total_records  required | String | `377` |
| subscriptions  required | String | Array of subscription objects |
| subscriptions.subscription_id  required | String | `10003143` |
| subscriptions.start_date  required | String | `13\/10\/2025` |
| subscriptions.end_date  required | String | `20\/10\/2025` |
| subscriptions.amount  required | String | `2600.00` |
| subscriptions.period  required | String | `daily` |
| subscriptions.transaction_type  required | String | `upi` |
| subscriptions.transaction_date  required | String | `09-10-2025` |
| subscriptions.subscription_status  required | String | `subscribed` |