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
    • Client Notifications
      PUT
    • Activate Client Account
      POST
    • Add Client Address
      POST
    • Update Client Address
      PUT
    • Get Full Account Details
      GET
    • Get Full Account Details By NUBAN
      GET
    • Upload Client Passport
      POST
    • Update NIN
      POST
    • Create Client
      POST
    • Get Directors
      GET
    • Create Directors
      POST
    • Update Directors
      PUT
    • Delete Director
      DELETE
    • Get Genders
      GET
    • Get Signatories
      GET
    • Create Signatories
      POST
    • Delete Signatory
      DELETE
    • Get Template
      GET
  • KYC
    • Get KYC Info
    • Update KYC
    • Get KYC Level
    • Auto Verify KYC
    • Get KYC Comparison Details
    • Face Comparison
    • Get KYC Info
    • Get KYC Settings
    • Get KYC Info
    • Create Face Liveness Session
    • Get KYC Log Details
    • Get KYC Logs
    • Set KYC Level
    • Set KYC Log Status
  • Transaction
    • Payment Types
    • Debit Account
    • Credit Account
    • Transaction History
    • Transaction Details [Legacy]
    • Transaction Details
    • Get All Transactions
  • Transfer
    • Interbank Transfer
      • Get Institutions
      • Name Inquiry
      • Interbank Transfer
      • InterBank Transfer Query
      • Transfer Details
      • Bulk Interbank Transfer
    • Intrabank Transfer
      • IntraBank Transfer
      • Intrabank Transfer To Virtual Accounts
      • Query Intrabank Transfer Status
      • Intrabank Transfer To Virtual Accounts
      • Query Intrabank Transfer To Virtual Account Status
  • Account Restrictions
    • Block Debit
      POST
    • Unblock Debit
      POST
    • Hold Amount
      POST
    • Release Amount
      POST
    • Block Account
      POST
    • Block Account Credits
      POST
    • Unblock Account
      POST
    • Unblock Account Credits
      POST
  • Reporting
    • Report Types
    • Get Report Parameters
    • Create Report
    • Report Details
    • Get Reports
  • Organisation
    • Get Address Types
    • Get Offices
    • Get States
  • Schemas
    • Client
    • Product
    • ClientNotificationsRequest
    • ClientNotificationsResponse
    • ErrorDetail
    • ErrorResponse
    • ValidationErrorResponse
  1. Account Restrictions

Block Account

POST
/core/account/block

Block Account#

Blocks an account completely: no credits and no debits are accepted until it is unblocked with POST /core/account/unblock.
POST /core/account/block

Request Body#

Field NameTypeRequiredDescription
nubanstringtrueThe account number (NUBAN) of the account.
reasonForBlockstringtrueWhy the account is being restricted. Maximum 100 characters.

Response#

The response is the result of the operation.
Field NameTypeDescription
savingsIdintegerUnique identifier of the savings account that was changed.
clientIdintegerUnique identifier of the account holder.
officeIdintegerOffice the account belongs to.
resourceIdintegerSame as savingsId.
Blocking an account that is already fully blocked succeeds without change. Use /core/account/block-credit to stop credits only.

Request

Authorization
OAuth 2.0
Client Credentials
Add the parameter
Authorization
to Headers
,whose value is to concatenate the Token after the Bearer.
Example:
Authorization: Bearer ********************
Token URL: {{tpGatewayHostUrl}}/security/authenticate
or
Body Params application/json

Example
{
  "nuban": "0123456789",
  "reasonForBlock": "Suspected fraud - customer request"
}

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 '/core/account/block' \
--header 'Content-Type: application/json' \
--data '{
  "nuban": "0123456789",
  "reasonForBlock": "Suspected fraud - customer request"
}'

Responses

🟢200Success
application/json
Success
Bodyapplication/json

Example
{
  "officeId": 1,
  "clientId": 101,
  "savingsId": 54,
  "resourceId": 54
}
🟠400| Source | Error | When |
🟠401| Source | Error | When |
🟠403| Source | Error | When |
🟠404| Source | Error | When |
🔴500| Source | Error | When |
Modified at 2026-11-02 05:49:15
Previous
Release Amount
Next
Block Account Credits
Built with