SecureBank API Documentation — Developer Portal

Account Balance API

Returns the current and available balance for the specified account. Requires OAuth 2.0 bearer token with accounts:read scope.

Response Example

{
  "account_id": "acc_7x8k2m9p4q",
  "currency": "USD",
  "current_balance": 14523.87,
  "available_balance": 13890.42,
  "pending_transactions": 3,
  "pending_amount": 633.45,
  "as_of": "2026-04-22T10:30:00Z",
  "institution": "First National Bank",
  "account_type": "checking",
  "routing_number": "021000021"
}

Authentication

Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...

Error Codes

Code	Description
401	Invalid or expired access token
403	Insufficient scope — requires accounts:read
404	Account not found or not linked
429	Rate limit exceeded — 100 requests/minute per client

Transaction History API

Response Example

{
  "transactions": [
    {
      "id": "txn_a8b3c2d1e0",
      "date": "2026-04-21",
      "description": "AMAZON.COM*2K7YT8M3 SEATTLE WA",
      "amount": -89.43,
      "category": "shopping",
      "merchant": "Amazon",
      "status": "posted"
    },
    {
      "id": "txn_f9g8h7i6j5",
      "date": "2026-04-20",
      "description": "PAYROLL DEPOSIT — ACME CORP",
      "amount": 3247.50,
      "category": "income",
      "status": "posted"
    }
  ],
  "pagination": {
    "total": 847,
    "page": 1,
    "per_page": 25,
    "has_more": true
  }
}

Webhook Configuration

Register webhooks to receive real-time notifications for account events.

POST /v2/webhooks
{
  "url": "https://yourapp.com/webhooks/securebank",
  "events": ["transaction.created", "balance.updated", "account.linked"],
  "secret": "whsec_k8m2p4q7r9t1v3x5z..."
}