FinTrack API

Authenticate a user, create a session, and get a token.

Log out the current user by invalidating the session.

Update the current user's profile (e.g., name).

Change the current user's password.

List all users with search, pagination and sorting. Accessible by any authenticated user.

Create a new user. Admin only.

Update a user's information. Admin only. Password field is optional.

Delete a user. Admin only.

Upload one or more image files. Returns an array of objects containing the full image URL and a thumbnail URL for each file.

List expense groups for the current user (or all if admin), including members and categories, with search and pagination.

Get the details of a specific expense group, including its members, categories, sub-categories, and periods.

Create a new group or update an existing one. If "id" is present in the data, it performs an update; otherwise, it creates a new group.

Delete an expense group. Only the group owner or an admin can perform this action.

List expense periods for a group with pagination, sorting, status filtering, and financial summaries. The response includes details of the parent group, including its members.

Get the details of a specific expense period, including its financial summary and category targets. Admins or group members only.

Create a new expense period or update an existing one. Admins have access to all groups.

Delete an expense period. Admins have access to all groups.

Create a new transaction or update an existing one. Any group member or admin can perform this action.

List all transactions for a period, with various filtering and sorting options. Includes full details of the parent group and period. Does not use pagination.

Get full details of a single transaction, including recipients and full image URLs.

Delete a transaction. Any group member or admin can delete any transaction in the group.

Create a new loan/debt or update an existing one. Automatically generates lender/borrower names from member IDs.

List all loans the current user is a member of, with search, filtering, pagination, and member IDs.

Get the setting details of a single loan, including members.

Delete a loan and all its associated data (members, transactions).

List all transactions for a specific loan. Always returns the full history without pagination. Includes lender/borrower IDs in the loan object.

Get details for a single loan transaction, including images.

Save a loan transaction (payment/disbursement). Any member or admin can perform this action. Automatically updates the parent loan's summary.

Delete a loan transaction. Any member or admin can perform this action. Automatically updates the parent loan's summary.

List savings goals for the current user, or all goals if the user is an admin. Supports search, pagination, and sorting. Also returns the list of members for each goal.

Get the details of a specific savings goal, including its members. Admins or members only.

Create a new savings goal or update an existing one. Differentiated by the presence of a "id" in the data payload.

Delete a savings goal. Only the group owner or an admin can perform this action.

Get details of a savings goal, including its full transaction history. The goal object returned now includes a list of members.

Creates a new transaction (deposit/withdrawal) or updates an existing one. Any member or admin can perform this action.

Get full details of a single savings transaction, including full image URLs.

Delete a savings transaction. Any member or admin can perform this action. The goal's current amount is updated automatically.

Analyzes an image of a receipt or invoice and extracts structured data from it.