Accounts API · Pasona Finance Tracker API

GET /api/accounts

List accounts

Returns every account owned by the authenticated user, each with its calculated balance.

Responses

[
  {
    "id": 1,
    "user_id": 1,
    "name": "GTBank Checking",
    "type": "bank",
    "starting_balance": "1000.00",
    "notes": null,
    "created_at": "2026-06-03T12:00:00Z",
    "updated_at": "2026-06-03T12:00:00Z",
    "balance": 1350.00
  },
  {
    "id": 2,
    "user_id": 1,
    "name": "MTN MoMo",
    "type": "mobile",
    "starting_balance": "200.00",
    "notes": "Personal mobile money",
    "created_at": "2026-06-03T12:00:00Z",
    "updated_at": "2026-06-03T12:00:00Z",
    "balance": 75.50
  }
]

{ "message": "Unauthenticated." }

POST /api/accounts

Create an account

Creates a new financial account for the authenticated user.

Request body

Name	Type	Required	Description
`name`	string	Required	Display name. Max `255` characters.
`type`	string	Required	One of: `bank`, `mobile`, `cash`.
`starting_balance`	number	Required	Opening balance for the account.
`notes`	string	Optional	Free-form notes.

Request body example

{
  "name": "GTBank Checking",
  "type": "bank",
  "starting_balance": 1000.00,
  "notes": "Primary salary account"
}

Responses

{
  "id": 1,
  "user_id": 1,
  "name": "GTBank Checking",
  "type": "bank",
  "starting_balance": "1000.00",
  "notes": "Primary salary account",
  "created_at": "2026-06-03T12:00:00Z",
  "updated_at": "2026-06-03T12:00:00Z",
  "balance": 1000.00
}

{
  "message": "The given data was invalid.",
  "errors": {
    "type": ["The selected type is invalid."]
  }
}

{ "message": "Unauthenticated." }

GET /api/accounts/{id}

Retrieve an account

Returns a single account by ID, including its calculated balance.

Path parameters

Name	Type	Required	Description
`id`	integer	Required	The account's unique identifier.

Responses

{
  "id": 1,
  "user_id": 1,
  "name": "GTBank Checking",
  "type": "bank",
  "starting_balance": "1000.00",
  "notes": null,
  "created_at": "2026-06-03T12:00:00Z",
  "updated_at": "2026-06-03T12:00:00Z",
  "balance": 1350.00
}

{ "message": "This action is unauthorized." }

{ "message": "No query results for model [App\Models\Account] #99" }

PUT /api/accounts/{id}

Update an account

Updates one or more fields of an existing account. Only the fields you send are updated.

Request body

Name	Type	Required	Description
`name`	string	Optional	Display name. Max `255` characters.
`type`	string	Optional	One of: `bank`, `mobile`, `cash`.
`starting_balance`	number	Optional	New starting balance.
`notes`	string	Optional	Free-form notes.

DELETE /api/accounts/{id}

Delete an account

Permanently deletes an account and all of its associated transactions. This action cannot be undone.

Response

HTTP/1.1 204 No Content