Skip to main content
GET
/
budget
curl -X GET "https://api.homeaccount.com/budget?account_id=123e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "account_id": "123e4567-e89b-12d3-a456-426614174000",
      "category_id": "987fcdeb-51a2-43d7-9f12-345678901234",
      "amount": 50000,
      "period": "monthly",
      "alert_threshold": 85,
      "created_at": "2026-03-05T10:30:00.000Z",
      "updated_at": "2026-03-05T10:30:00.000Z"
    },
    {
      "id": "660e9511-f39c-52e5-b827-557766551111",
      "account_id": "123e4567-e89b-12d3-a456-426614174000",
      "category_id": "abc12345-67de-89fg-01hi-234567890jkl",
      "amount": 100000,
      "period": "weekly",
      "alert_threshold": 80,
      "created_at": "2026-03-01T08:15:00.000Z",
      "updated_at": "2026-03-01T08:15:00.000Z"
    }
  ]
}
Retrieves all budgets associated with a specific account, ordered by creation date (newest first).

​
Query Parameters

​
account_id
string
required
The UUID of the account to retrieve budgets for

​
Response

​
success
boolean
Indicates if the request was successful
​
data
array
Array of budget objects
curl -X GET "https://api.homeaccount.com/budget?account_id=123e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer YOUR_TOKEN"

{
  "success": true,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "account_id": "123e4567-e89b-12d3-a456-426614174000",
      "category_id": "987fcdeb-51a2-43d7-9f12-345678901234",
      "amount": 50000,
      "period": "monthly",
      "alert_threshold": 85,
      "created_at": "2026-03-05T10:30:00.000Z",
      "updated_at": "2026-03-05T10:30:00.000Z"
    },
    {
      "id": "660e9511-f39c-52e5-b827-557766551111",
      "account_id": "123e4567-e89b-12d3-a456-426614174000",
      "category_id": "abc12345-67de-89fg-01hi-234567890jkl",
      "amount": 100000,
      "period": "weekly",
      "alert_threshold": 80,
      "created_at": "2026-03-01T08:15:00.000Z",
      "updated_at": "2026-03-01T08:15:00.000Z"
    }
  ]
}

​
Error Codes

  • 400 - Missing or invalid account_id parameter
  • 401 - Missing or invalid authentication token
  • 500 - Internal server error

Build docs developers (and LLMs) love

Get started for freeTalk to us