Home
Release Notes
Home
Release Notes
Linkedin
  1. Lookups
  • Baladâ„¢ Gateway Documentation đŸ“–
  • Get Started
  • Authorization
  • Responses
  • Go Live!
  • FAQs
  • APIs
    • Authentication
      • Token
    • Core
      • Exchange rate
        • Exchange Rates
      • Balance
        • Get Current Balance
      • Secrets
        • Generate Secret
        • Delete Secret
        • Get Secrets
    • Link
      • Sandbox Testing Guide
      • Error Codes
      • Transaction Lifecycle V2
      • Lookups
        • Purposes List
          GET
        • Sources List
          GET
        • Banks List
          GET
        • Relations
          GET
      • Transactions
        • Create transaction
        • Update transaction
        • Cancel transaction
        • Get transaction status V2
        • Transactions List
        • Export Transactions List
        • Calculate receiving amount
        • Validate Account
      • Reconciliation
        • Reconciliation
  • Webhooks
    • Link.Transaction.StatusUpdateV2
  1. Lookups

Banks List

GET
/remit-api/banks
This method retrieves a list of available banks in the system. The list can be filtered based on the transaction type and receiving country to provide a more refined set of results.

Filters:#

Transaction Type: You can filter the list of banks based on the type of transaction being conducted. The supported transaction types are:
1.
Cash
2.
Bank Account
3.
Wallet
4.
Card

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params

Header Params

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 'https://gateway-sandbox.balad.tech/remit-api/banks?transaction_type=2' \
--header 'X-Country-Code;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'

Responses

đŸŸ¢200Success
application/json
Bodyapplication/json

Example
{
    "data": [
        {
            "code": "XXX",
            "description": "BANK 1",
            "address": "BANK 1 ADDRESS",
            "bic_code": "BANK1EGCXXXX"
        },
        {
            "code": "XXXX",
            "description": "BANK 2",
            "address": "BANK 2 ADDRESS",
            "bic_code": "BANK2EGCXXXX"
        }
    ],
    "errors": null
}
Previous
Sources List
Next
Relations
Built with