Skip to main content
GET
/
api
/
accounts
curl -X GET https://api.yourfinanceapp.com/api/accounts \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Main Wallet",
    "type": "WALLET",
    "currency": "ARS",
    "balance": 15000,
    "color": "#10B981",
    "icon": "wallet",
    "targetAmount": null,
    "targetDate": null,
    "progress": 0,
    "isDefault": true,
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2026-01-15T10:30:00Z",
    "updatedAt": "2026-03-04T08:20:00Z"
  },
  {
    "id": "660e8400-e29b-41d4-a716-446655440001",
    "name": "Vacation Fund",
    "type": "SAVINGS",
    "currency": "USD",
    "balance": 3250,
    "color": "#3B82F6",
    "icon": "piggy-bank",
    "targetAmount": 5000,
    "targetDate": "2026-12-31T00:00:00Z",
    "progress": 65,
    "isDefault": false,
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2026-02-01T14:00:00Z",
    "updatedAt": "2026-03-04T09:15:00Z"
  }
]
Retrieves all accounts for the authenticated user, ordered by creation date. The response includes calculated progress for savings accounts with target amounts.

​
Query Parameters

The current implementation returns all accounts. Filtering by type can be done client-side or may be added in future versions.

​
Response

Returns an array of account objects with enhanced data:
​
id
string
Unique identifier for the account
​
name
string
Account name
​
type
string
Account type: WALLET, SAVINGS, INVESTMENT, or CREDIT_CARD
​
currency
string
Currency code (ARS, USD, EUR)
​
balance
number
Current balance (converted to number)
​
color
string
Hex color code
​
icon
string
Icon identifier
​
targetAmount
number | null
Target amount goal (null if not set)
​
targetDate
string | null
Target date for goal
​
progress
number
Calculated progress percentage (0-100) based on balance / targetAmountReturns 0 if no target is set. Capped at 100 even if balance exceeds target.
​
isDefault
boolean
Whether this is the default account
​
userId
string
Owner user ID
​
createdAt
string
Creation timestamp
​
updatedAt
string
Last update timestamp
curl -X GET https://api.yourfinanceapp.com/api/accounts \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Main Wallet",
    "type": "WALLET",
    "currency": "ARS",
    "balance": 15000,
    "color": "#10B981",
    "icon": "wallet",
    "targetAmount": null,
    "targetDate": null,
    "progress": 0,
    "isDefault": true,
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2026-01-15T10:30:00Z",
    "updatedAt": "2026-03-04T08:20:00Z"
  },
  {
    "id": "660e8400-e29b-41d4-a716-446655440001",
    "name": "Vacation Fund",
    "type": "SAVINGS",
    "currency": "USD",
    "balance": 3250,
    "color": "#3B82F6",
    "icon": "piggy-bank",
    "targetAmount": 5000,
    "targetDate": "2026-12-31T00:00:00Z",
    "progress": 65,
    "isDefault": false,
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2026-02-01T14:00:00Z",
    "updatedAt": "2026-03-04T09:15:00Z"
  }
]

Build docs developers (and LLMs) love

Get started for freeTalk to us