---
page_source: https://juspay.io/in/docs/payment-page-enterprise/android/mandates/mandate-revoke-api
page_title: Mandate Revoke API
---

## API Version: default


# Revoke Mandate API



Use this API to revoke/cancel an ACTIVE mandate.## Endpoints:
- Production: https://api.juspay.in/mandates/:mandate_id

## Request Type: 
POST

## Authorization:

#### Basic Auth:
Consists of two parts.

* Username: API Key obtained from Juspay dashboard
* Password: Empty string

Example:-MUQ2QUZEQzhFQTY0OUU5QTIxQzNFNTQwNkFDMEZCOg==


- Tags: Base64 Encoded Username:Password, Required
## Headers:

#### x-merchantid:
Merchant ID which would have been issues while registering with Juspay.

Example:-merchant-id


- Tags: string, Required
## Sample Code Snippets:
### Sample Request:

#### Shell Code Snippet:

```shell
curl POST 'https://api.juspay.in/mandates/7SucJZ2PCyoGY5vvW8Xa26' \
-H 'x-merchantid: merchant' \
-H 'Authorization: Basic <Base-64 Key>' 
-H 'x-routing-id: customer_1122'\
-d 'command=revoke'

```

### Sample Response:

#### UPI:
```json
{
  "mandate_status": "REVOKED",
  "mandate_id": "ns3UFqGKHLWXNGDREXDE67"
}
```

#### CARD:
```json
{
  "mandate_status": "REVOKED",
  "mandate_id": "7SucJZ2PCyoGY5vvW8Xa26"
}
```

## Body Parameters:
### Parameters:

#### command:
- Description: To be set as revoke, to revoke an existing mandate.

Example:-

revoke


- Tags: string
## API Responses:
### 200:

#### mandate_status:
- Description: REVOKED
- Tags: string

#### mandate_id:
- Description: 7SucJZ2PCyoGY5vvW8Xa26
- Tags: string
### 400:

#### status:
- Description: invalid_request_error
- Tags: string

#### error_message:
- Description: Mandate not found
- Tags: string

#### error_code:
- Description: Mandate not found
- Tags: string
### 401:

#### status:
- Description: error
- Tags: string

#### error_code:
- Description: access_denied
- Tags: string