---
title: "Block an amount in an account"
method: POST
path: "/v3/ledger/account/block/{id}"
tags: ["Account"]
---

# Block an amount in an account

`POST /v3/ledger/account/block/{id}`

## Request

- Base URL: `https://api.tatum.io`
- URL: `https://api.tatum.io/v3/ledger/account/block/{id}`
- Auth: API key in header `x-api-key`

/v3/ledger/account/block/{id}

#### 2 credits per API call.

  

Blocks an amount in an account. Any number of distinct amounts can be blocked in one account. Every new blockage has its own distinct ID, which is used as a reference. When the amount is blocked, it is debited from the available balance of the account. The account balance remains the same. The account balance represents the total amount of funds in the account. The available balance represents the total amount of funds that can be used to perform transactions. When an account is frozen, the available balance is set to 0 minus all blockages for the account.

## Path parameters

- `id` string, required

## Request body

- BlockAmount
  - `amount` string, required: The amount to be blocked on the account
  - `type` string, required: The type of the blockage that you are applying; can be a code or an identifier from an external system or a short description of the blockage
  - `description` string: The description of the blockage that you are applying
  - `ensureSufficientBalance` boolean: Enable sufficient balance check. When set to true, blocking an amount greater than the account's available balance will throw an error.

## Response `200`

OK

- Id
  - `id` string: ID of the entity.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
- `403`: Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
- `500`: Internal server error. There was an error on the server during the processing of the request.

---

[API](https://skmtc.dev/tatum/apis/virtual-accounts.md) - [All operations](https://skmtc.dev/tatum/apis/virtual-accounts/llms.txt) - [OpenAPI document](https://skmtc.dev/tatum/apis/virtual-accounts/revisions/ba220553084b?raw)