Get Institutional Bank Accounts

GET 
/v1.1/master-data/institution/bank-accounts

This is used to get the institution's bank accounts in the system. Those accounts are used by customers to deposit money before performing the deposit request to fund their cash accounts in the system.

Request

Query Parameters

institutionCode stringrequired

Example: TRADE_API_INST_ONE

Responses

200

OK

application/json

Schema

Schema

status stringrequired

Possible values: non-empty, [SUCCESS, FAILED]

reason string

Possible values: non-empty

rejectCode number

Find error codes here

bankAccountList object[]required
Possible values: >= 1
Array [
bankName stringrequired
Possible values: non-empty
bankId stringrequired
Possible values: non-empty
bankAccountNumber string
currency string
]

Example (from schema)

{
  "status": "SUCCESS",
  "reason": "string",
  "rejectCode": 0,
  "bankAccountList": [
    {
      "bankName": "string",
      "bankId": "string",
      "bankAccountNumber": "string",
      "currency": "string"
    }
  ]
}

example

{
  "status": "SUCCESS",
  "bankAccountList": [
    {
      "bankName": "DBS",
      "bankId": "101",
      "currency": "AED",
      "bankAccountNumber": "234234"
    },
    {
      "bankName": "HSBC BANK",
      "bankId": "142",
      "currency": "USD",
      "bankAccountNumber": "12332"
    },
    {
      "bankName": "HSBC BANK",
      "bankId": "142",
      "currency": "LKR",
      "bankAccountNumber": "1234124"
    },
    {
      "bankName": "HSBC BANK",
      "bankId": "142",
      "currency": "AED",
      "bankAccountNumber": "1123242"
    }
  ]
}

401

Unauthorized

application/json

Schema

Schema

timestamp string
status string
error string
message string
path string
rejectCode string

Example (from schema)

{
  "timestamp": "string",
  "status": "string",
  "error": "string",
  "message": "string",
  "path": "string",
  "rejectCode": "string"
}

Invalid Token

{
  "timestamp": "2023-12-28T09:51:50.682Z",
  "status": "401",
  "error": "Unauthorized",
  "message": "Invalid Token",
  "path": "/api/v1.1/master-data/institution/bank-accounts",
  "rejectCode": "1008"
}

Expired Token

{
  "timestamp": "2023-12-28T09:51:50.682Z",
  "status": "401",
  "error": "Unauthorized",
  "message": "Expired Token",
  "path": "/api/v1.1/master-data/institution/bank-accounts",
  "rejectCode": "1007"
}

Loading...