Accounts

Overview

The Accounts API allows you to retrieve information about all financial accounts in your Sure workspace. Accounts represent depository accounts, credit cards, investment accounts, loans, and other asset or liability accounts.

List accounts

curl -X GET https://api.sure.app/v1/accounts \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Retrieve a paginated list of all visible accounts (draft and active status).

Query parameters

page

integer

default:"1"

Page number for pagination

per_page

integer

default:"25"

Number of accounts per page (max 100)

Response

accounts

array

Array of account objects

Show Account object

integer

Unique identifier for the account

name

string

Display name of the account

balance

string

Current balance formatted as a currency string

currency

string

Three-letter ISO currency code (e.g., “USD”, “EUR”)

classification

string

Account classification: asset or liability

account_type

string

Type of account: depository, credit_card, investment, loan, property, vehicle, other_asset, other_liability, or crypto

pagination

object

Pagination metadata

Show Pagination object

{
  "accounts": [
    {
      "id": 1,
      "name": "Chase Checking",
      "balance": "$5,432.10",
      "currency": "USD",
      "classification": "asset",
      "account_type": "depository"
    },
    {
      "id": 2,
      "name": "Amex Platinum",
      "balance": "$1,234.56",
      "currency": "USD",
      "classification": "liability",
      "account_type": "credit_card"
    },
    {
      "id": 3,
      "name": "Vanguard 401(k)",
      "balance": "$125,000.00",
      "currency": "USD",
      "classification": "asset",
      "account_type": "investment"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 25,
    "total_count": 3,
    "total_pages": 1
  }
}

Error responses

error

string

Error code identifier

message

string

Human-readable error description

{
  "error": "unauthorized",
  "message": "Invalid or missing API key"
}

Account types

Type	Description	Classification
`depository`	Bank accounts (checking, savings)	Asset
`credit_card`	Credit card accounts	Liability
`investment`	Brokerage and retirement accounts	Asset
`crypto`	Cryptocurrency exchange accounts	Asset
`loan`	Loan accounts (mortgage, personal, student)	Liability
`property`	Real estate properties	Asset
`vehicle`	Vehicles	Asset
`other_asset`	Other assets	Asset
`other_liability`	Other liabilities	Liability

Getting Started

Resources

Overview

List accounts

Query parameters

Response

Error responses

Account types

Build docs developers (and LLMs) love

Getting Started

Resources

​Overview

​List accounts

​Query parameters

​Response

​Error responses

​Account types

Build docs developers (and LLMs) love

Overview

List accounts

Query parameters

Response

Error responses

Account types