1. Account Restrictions
Core Banking Services
  • Introduction
  • Terminologies
  • Webhooks
  • Authentication
  • Account
    • Product List
      GET
    • Create Account
      POST
    • Update Account
      PUT
    • Find Client
      POST
    • Accounts
      GET
    • Create Additional Account
      POST
    • Account Details By BVN
      GET
    • Get Client Addresses
      GET
    • Get Account Details
      GET
    • Get Account Summary
      GET
    • Client Images
      GET
    • Update BVN
      POST
    • Update Transaction Limit
      POST
  • KYC
    • Get KYC Info
      POST
    • Update KYC
      POST
    • Get KYC Level
      GET
  • Transaction
    • Payment Types
      GET
    • Debit Account
      POST
    • Credit Account
      POST
    • Transaction History
      GET
    • Transaction Details [Legacy]
      GET
    • Transaction Details
      GET
  • Transfer
    • Get Institutions
    • Name Inquiry
    • Interbank Transfer
    • InterBank Transfer Query
    • Transfer Details
    • IntraBank Transfer
    • Intrabank Transfer To Virtual Accounts
  • Reporting
    • Report Types
    • Get Report Parameters
    • Create Report
    • Report Details
    • Get Reports
  • Account Restrictions
    • Block Debit
      POST
    • Unblock Debit
      POST
    • Hold Amount
      POST
    • Release Amount
      POST
  • Schemas
    • Client
    • Product
  1. Account Restrictions

Hold Amount

Developing
POST
/core/account/hold-amount

Hold Amount#

Places a hold (lien) on a specific amount of the account balance. The held amount is deducted
from the withdrawable balance but the account otherwise stays fully operational. The hold is
identified by the resourceId returned in the response.

Request Body#

Field NameTypeRequiredDescription
nubanstringTRUEAccount number (NUBAN) to place the hold on.
amountnumberTRUEAmount to hold. Must be 0.01 or greater.
reasonForBlockstringTRUEReason recorded against the hold. Maximum 100 characters.
{
  "nuban": "0000000206",
  "amount": 5000.00,
  "reasonForBlock": "Loan collateral"
}

Response#

Field NameTypeDescription
officeIdintegerIdentifier of the office that owns the client / account.
clientIdintegerClient identifier of the account holder.
savingsIdintegerSavings account ID identifier.
resourceIdintegerThis is the hold (lien) transaction id – supply it as holdTransactionId when calling release-amount.

Request

None

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/core/account/hold-amount'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{}
Modified at 2026-09-04 10:57:00
Previous
Unblock Debit
Next
Release Amount
Built with