Validate Account

POST

/remit-api/v1/transactions/validate-account

This API allows clients to validate bank account numbers and IBANs before initiating transfers. It enforces specific rules based on currency (EGP vs. USD), bank codes, and length requirements.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
   "account_no": "78153237676595",
   "bank_code": "SCB",
   "currency": "EGP"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://gateway-sandbox.balad.tech/remit-api/v1/transactions/validate-account' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
   "account_no": "78153237676595",
   "bank_code": "SCB",
   "currency": "EGP"
}'

Responses

🟢200Valid Account Sucess

application/json

Bodyapplication/json

Example

{
    "data": null,
    "errors": null
}

🟠400Invalid IBAN

Calculate receiving amount

Reconciliation