---
title: "Revoke a consent"
method: POST
path: "/consents/v1/{consent_id}/revocation"
tags: ["Consents"]
---

# Revoke a consent

`POST /consents/v1/{consent_id}/revocation`

Revokes an authorised payment consent. The consent must be in `AUTHORISED` state.

## Request body

- object
  - `reason` 'END_USER_REQUESTED' | 'CONSENT_RENEWAL' | 'KYC_VERIFICATION_FAILED' | 'REGULATORY_RESTRICTION' | 'FRAUD_SUSPECTED' | 'CLIENT_TERMINATED_RELATIONSHIP' | 'ACCOUNT_CLOSED_BY_USER' | 'DUPLICATE_CONSENT', required — The reason the consent is being revoked. Must be one of the predefined values: - `END_USER_REQUESTED`: The end user has requested revocation of their consent through the Lean-provided consent management interface or via the client's customer support. - `CONSENT_RENEWAL`: The consent is being revoked as part of a renewal flow, where a replacement consent has been authorized to supersede it. - `KYC_VERIFICATION_FAILED`: The client's KYC or identity verification checks on the end user have failed or could not be completed. - `REGULATORY_RESTRICTION`: A regulatory, compliance, or jurisdictional obligation requires the client to revoke the consent. - `FRAUD_SUSPECTED`: Suspicious or potentially fraudulent activity has been detected on the end user's account or transactions. - `CLIENT_TERMINATED_RELATIONSHIP`: The client has ended their commercial relationship with the end user. - `ACCOUNT_CLOSED_BY_USER`: The end user has permanently closed their account with the client. - `DUPLICATE_CONSENT`: A duplicate or superseding consent exists for the same end user and payment source, and this consent is being retired.
  - `additional_context` string, nullable — Optional free-text context describing the circumstances of the revocation.

## Response `200`

Consent revoked successfully.

- object

## Other responses

- `400` — The consent is not in an `AUTHORISED` state and cannot be revoked.

---

[API](https://skmtc.net/leantech/apis/auth.md) · [All operations](https://skmtc.net/leantech/apis/auth/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/leantech/auth/revisions/c2e46d54d886/schema)