API Reference

CapyBank REST API

A simple, RESTful API to integrate banking features directly into your application. JSON in, JSON out.

Authentication

Authenticate requests by including your API key in the Authorization header.

curl https://api.capybank.com/v1/accounts \
  -H "Authorization: Bearer sk_live_your_api_key"

Endpoints

Core endpoints available in the CapyBank API.

GET/v1/accounts

List all accounts associated with your API key.

POST/v1/transfers

Initiate a new transfer between accounts.

GET/v1/transactions

Retrieve a paginated list of transactions.

GET/v1/balance

Get the current balance for a specified account.

Example response

All API responses return JSON with a consistent structure.

{
  "id": "acc_1a2b3c4d",
  "object": "account",
  "name": "Primary Checking",
  "balance": 12500.00,
  "currency": "usd",
  "status": "active",
  "created_at": "2025-01-15T08:00:00Z"
}