---
page_title: List all mandates
product: lotuspay
platform: web
page_source: https://docs.juspay.io/lotuspay/web/core-resources/list-all-mandates
openapi: https://docs.juspay.io/api/swagger?document=https%3A%2F%2Fdocs.juspay.io%2Flotuspay%2Fweb%2Fcore-resources%2Flist-all-mandates
llms_txt: https://docs.juspay.io/llms.txt
product_llms_txt: https://docs.juspay.io/lotuspay/llms.txt
---

## API Version: default


# **List all mandates** 



You can see a list of your mandates. The mandates are returned sorted by creation date, with the most recent appearing first. You can use this API method and the limit parameter to page through mandates. You can also filter for status and variant. You can use any combination of these arguments.

**ARGUMENTS** 


| Argument | Description |
|---|---|
| limit optional, default is 100	 | A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 100. |
| status optional	 | A filter on the status of the mandates to be returned e.g. status=active. |
| variant optional	 | A filter on the variant of the mandates to be returned e.g. variant=physical. |
| page optional | This will return all the mandates in the respective page. |


**Returns**  A dictionary with a `data` property that contains an array of up to `limit` mandates and when you pass `page`  it will return you all the entries in the respective page.Each entry in the array is a separate mandate object. If no more mandates are available, the resulting array will be empty. If you provide a non-existent filter, this call returns an error. Note: Limited API Keys will return only those objects to which they are associated.## Endpoints:
- Sandbox: https://api-test.lotuspay.com/v1/mandates

- Production: https://api.lotuspay.com/v1/mandates

## Request Type: 
GET

## Content-Type: 
application/json

## Authorization:

#### Basic Auth:
Auth example
- Value:  sk_test_XjIHowXWSI23uvjepz2X82
## Sample Code Snippets:
### Sample Request and Response:

#### Request:
```Shell
$ curl https://api-test.lotuspay.com/v1/mandates?limit=10 \
   -u sk_test_XjIHowXWSI23uvjepz2X82: \
   -G
```

#### Response:
```json
{
    "object": "list",
    "url": "/v1/mandates",
    "has_more": false,
    "data": [
      {
          "id": "MD004433221AA",
          "reference1": "test1"
      },
      {
          "id": "MD004433221BB",
          "reference1": "test2"
      },
      {
          "id": "MD004433221CC",
          "reference1": "test3"
      },
      {
          "id": "MD004433221DD",
          "reference1": "test4"
      }
    ]
  }
```

## API Responses: