---
title: "Cancel account"
method: POST
path: "/v1/interest/account/cancellation"
tags: ["Interest engine"]
---

# Cancel account

`POST /v1/interest/account/cancellation`

Cancel all operations for the specified account, and withdraw the remaining balance.

This endpoint generates the following events.
- [Interest account cancellation succeeded](https://developers.pismo.io/events/docs/interest-engine-interest-account-cancellation-success-1) when account cancellation operation succeeds
- [Interest account cancellation failed](https://developers.pismo.io/events/docs/interest-engine-interest-account-cancellation-failure-1) when account cancellation fails

For more information, refer to the [Interest-bearing accounts](https://developers.pismo.io/pismo-docs/docs/interest-bearing-accounts) guide.

## Headers

- `x-program-id` string, required
- `content-type` string, required
- `Authorization` string, required

## Request body

- InterestAccountCancellationRequest
  - `account_id` string, number, required — Account ID
  - `document_number` string — Cardholder government document number. This can be from any document that identifies the cardholder such as a Tax ID, State ID, or driver's license.
  - `external_account_cancellation_id` string, required — External ID managed and used by requester to track the account cancellation request

## Response `200`

OK

- InterestAccountCancellationResponse
  - `external_account_cancellation_id` string, required — External ID managed and used by requester to track the account cancellation request

## Other responses

- `400` — Bad request
- `401` — Access token is missing or invalid
- `404` — Not Found
- `500` — Internal server error

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)