---
title: "Execute wallet action"
method: POST
path: "/ledger/v2/wallets/{id}/actions"
tags: ["Fiat Payments"]
---

# Execute wallet action

`POST /ledger/v2/wallets/{id}/actions`

## Request

- Base URL: `https://api.sandbox.bvnk.com`
- URL: `https://api.sandbox.bvnk.com/ledger/v2/wallets/{id}/actions`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/docs/ledger/v2/wallets/:id/actions/post.ts> (a function with typed inputs; its response is checked against the schema)

Executes a lifecycle action on a wallet: TERMINATE, BLOCK, or UNBLOCK. A non-empty comment explaining the reason is required.

## Path parameters

- `id` string, required

## Request body

- WalletActionRequest
  - `action` 'TERMINATE' | 'BLOCK' | 'UNBLOCK', required: Type of wallet action to execute: - `TERMINATE`: Permanently deletes the wallet. **This action cannot be reversed**. For **fiat** wallets, the linked virtual account is also closed (not applicable to the crypto wallets). The wallet balance must be zero before termination—transfer funds to another wallet first if needed. - `BLOCK`: Temporarily freezes the wallet. A blocked wallet cannot receive deposits or make payments and typically has the `INACTIVE` status. - `UNBLOCK`: Unfreezes the blocked wallet.
  - `comment` 'COMPLIANCE' | 'OPERATION' | 'OFFBOARDING' | 'CLIENT_REQUEST' | 'OTHER', required: Reason the wallet action is being executed.

## Response `204`

No Content. The action was applied successfully.

## Other responses

- `403`: Forbidden.
- `409`: Conflict. For example, blocking or unblocking a wallet that is already terminated.
- `422`: Bad request. For example, terminating a wallet while its balance is not zero.

## Changes

- **2026-06-16** `97d6c0d2fe2e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/changes/ledger/v2/wallets/:id/actions/post.md)

---

[API](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints.md) - [All operations](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/revisions/c386d436bf2c?raw)