Skip to content
Last updated

Postman Collection

To help you get started quickly, we've prepared a Postman collection that includes all major endpoints for the Bermuda Commercial Bank Open Banking API.

📦 Download Collection

You can download the latest version of the Postman collection here:

👉 Download BCB Open Banking Postman Collection - 2026-10-02

  • Authentication
    • Generate OAuth token (client credentials grant)
  • Accounts
    • List user accounts with cursor-based pagination
    • Get account details
    • List payment statuses for an account
  • Credentials
    • Create new API client credentials
    • Rotate client secret
    • Disable API client
    • Get permissions for an API client
    • Get public key metadata
    • Upload secondary public key
    • Delete secondary public key
    • Promote secondary key to primary
    • Generate secondary key challenge
    • Verify secondary key ownership
  • FX Quotes
    • Get foreign exchange quote
  • Internal Transfers
    • Initiate internal transfer
  • Investments
    • List investment positions
    • List investment trades
    • List investment orders
    • Place investment order
    • Get investment order
    • Cancel investment order
  • Payments
    • Submit SWIFT payment
    • Submit ACH local payment
    • Get payment status by payment ID
  • Public Keys
    • Get the bank's signing public key (JWKS)
  • Transactions
    • Retrieve account transactions with pagination
  • Virtual Accounts
    • Create Virtual Accounts (batch, v1 and v2)
    • Get All Virtual Accounts (v1 and v2)
    • Update Virtual Account (v1 and v2)
    • Get Virtual Account Details (v1 and v2)
    • Get Virtual Account Balances (batch)
    • Get Total Virtual Account Balances
    • Get Virtual Account Transactions
    • Get Virtual Account Transaction Report
    • Get Transaction Detail
    • Reverse Transaction
    • Get Virtual Account Deposits
    • Credit Virtual Account (with Idempotency-Key support)
    • Debit Virtual Account (with Idempotency-Key support)
    • Counter-party Settlement Transfer (Internal)
    • Counter-party Settlement Transfer (External)
    • Withdraw funds (Internal)
    • Withdraw funds (External, v1 and v2)
  • Notifications
    • Create notification subscription
    • List subscriptions
    • Get subscription
    • Deactivate subscription
  • Background Jobs
    • Get All Background Jobs
    • Get Job Status
    • Cancel Job
    • Get Job Results
  • System
    • Retrieve system time
  • Testing (non-production only)
    • Create a test SWIFT deposit
  • Error handling examples
  • Environment variables setup

🔧 How to Use

  1. Import the collection into Postman using the "Import" button.
  2. Head to the token endpoint and enter your client Id and client secret in the body.
  3. Submit this request, if successful you'll recieve a token back.
  4. Copy the token, click on the parent container ("Bermuda Commercial Bank APIs").
  5. Go to Authorization, select bearer and enter this token in the token field. All endpoints will now use this.

auth.png

💡 Tips

  • Use the "Pre-request Script" and "Tests" tabs for automation.
  • Set up environments for UAT and Production to switch easily.
  • Monitor headers like Retry-After during testing.

For any issues or help using the Postman collection, contact 📧 api@bcb.bm.