---
title: "Update blocked amount"
method: POST
path: "/api/v1/cards/{publicToken}/blocked-amount"
tags: ["Transactions"]
---

# Update blocked amount

`POST /api/v1/cards/{publicToken}/blocked-amount`

## Request

- Base URL: `https://cardsapi-uat-pub.globalprocessing.net`
- URL: `https://cardsapi-uat-pub.globalprocessing.net/api/v1/cards/{publicToken}/blocked-amount`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://uatists.globalprocessing.net/connect/token` scopes: `readWrite`

## Path parameters

- `publicToken` string, required

## Request body

- UpdateBlockedAmountRequest: Request received to update blocked amount
  - `adjustmentType` 'Credit' | 'Debit', required: Credit/Debit
  - `amount` number, double, required: The amount to be adjusted in blocked amount
  - `currencyCode` string, required: The currency of the transaction (3 letter currency code).
  - `description` string, nullable: Description
  - `loadedBy` string, nullable: Entry to the card status table

## Response `200`

Success

- CreateTransactionResponse: Response class returned by a CardsController CreateTransaction web method.
  - `transaction` TransactionDetail[], nullable: Details of the transaction(s) performed
    - `transactionType` 'Load' | 'Unload' | 'TransferFunds' | 'BalanceAdjustment' | 'Fee': The type of transaction that was performed.
    - `transactionId` integer: ID of the Transaction.
    - `amount` number, double: Transaction amount.
    - `currencyCode` string, nullable: 3-letter currency code - same value as in the request.
    - `publicToken` string, nullable: Public token to which transaction has been recorded against
  - `balance` BalanceResponse: Card balance.
    - `currencyCode` string, nullable: Currency code (3-letter format)
    - `cardBalance` number, double: Actual balance of the Card (including blocked amount)
    - `pendingAmount` number, double: Blocked Amount (i.e. part of available balance which cannot be used)
    - `availableBalance` number, double: Available Balance

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Client Error
- `500`: Server Error

## Changes

- **2026-11-03** `a5b5e4fdcf41`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/thredd/apis/core-cards/changes/api/v1/cards/:publicToken/blocked-amount/post.md)

---

[API](https://skmtc.dev/thredd/apis/core-cards.md) - [All operations](https://skmtc.dev/thredd/apis/core-cards/llms.txt) - [OpenAPI document](https://skmtc.dev/thredd/apis/core-cards/revisions/a5b5e4fdcf41?raw)