API Reference

The Cache API.

RESTful endpoints for querying financial data, managing accounts, and building integrations.

Base URL

https://api.usecache.com/v1

Endpoints

GET

/accounts

List all connected accounts with balances and metadata

GET

/accounts/:id

Retrieve a single account by ID

GET

/transactions

List transactions with filtering, pagination, and sorting

GET

/transactions/:id

Retrieve a single transaction by ID

POST

/queries

Execute a natural language query against your financial data

POST

/webhooks

GET

/categories

List all transaction categories with spending totals

GET

/recurring

List detected recurring charges and subscriptions

Example

List transactions

Request

curl -X GET "https://api.usecache.com/v1/transactions" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "acc_8f3k2j1",
    "start_date": "2025-01-01",
    "end_date": "2025-01-31",
    "category": "software",
    "limit": 50
  }'

Response

{
  "data": [
    {
      "id": "txn_9x8k2m1",
      "account_id": "acc_8f3k2j1",
      "amount": -49.00,
      "currency": "USD",
      "merchant": "Vercel Inc",
      "category": "software",
      "date": "2025-01-15",
      "pending": false,
      "metadata": {
        "confidence": 0.98,
        "recurring": true,
        "frequency": "monthly"
      }
    },
    {
      "id": "txn_7y2n4p3",
      "account_id": "acc_8f3k2j1",
      "amount": -20.00,
      "currency": "USD",
      "merchant": "GitHub",
      "category": "software",
      "date": "2025-01-12",
      "pending": false,
      "metadata": {
        "confidence": 0.99,
        "recurring": true,
        "frequency": "monthly"
      }
    }
  ],
  "has_more": true,
  "next_cursor": "cur_abc123"
}