Collections are your starting point for building and testing APIs. You can use this one to:
\n• Group related requests\n• Test your API in real-world scenarios\n• Document and share your requests
\nUpdate the name and overview whenever you’re ready to make it yours.
\nLearn more about Postman Collections.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"53763320","collectionId":"d45c5917-5dbe-4bdf-98cb-543ba349178c","publishedId":"2sBXiqE8To","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-04-05T10:47:33.000Z"},"item":[{"name":"Records","item":[{"name":"Get Financial Records","id":"1e39ba14-7c2d-44f2-b1d1-a00d423deaa1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"description":"Fetch all financial records with pagination.
\nQuery Parameters:
\nrole: User role (ADMIN, ANALYST, VIEWER)
\npage: Page number (starts from 0)
\nsize: Number of records per page
\nResponse:
Returns a paginated list of financial records including:
id
\ntype (INCOME / EXPENSE)
\ncategory
\namount
\nnote
\ndate
\nAccess Control:
\nADMIN: Full access
\nANALYST: Can view records and insights
\nVIEWER: Read-only access
\nCreate a new financial record.
\nRequest Body:
\namount: transaction amount (number)
\ntype: INCOME or EXPENSE
\ncategory: category name (string)
\ndate: transaction date (YYYY-MM-DD)
\nnotes: optional description
\nExample:
{
\"amount\": 1000,
\"type\": \"INCOME\",
\"category\": \"Salary\",
\"date\": \"2026-04-05\",
\"notes\": \"Monthly salary\"
}
Response:
Returns the created financial record with ID.
Access Control:
Only ADMIN users are allowed to create records.
Update an existing financial record.
\nPath Parameter:
\nRequest Body:
\namount: transaction amount
\ntype: INCOME or EXPENSE
\ncategory: category name
\ndate: transaction date
\nnotes: optional
\nResponse:
Returns updated financial record.
Access Control:
Only ADMIN users can update records.
Delete a financial record.
\nPath Parameter:
\nNote:
This performs a soft delete (record is marked as deleted, not permanently removed).
Response:
Returns success message or updated record status.
Access Control:
Only ADMIN users can delete records.
Fetch financial records filtered by category.
\nQuery Parameters:
\ncategory (required): Category name (e.g., Salary, Food, Travel)
\nrole (required): User role (ADMIN / ANALYST / VIEWER)
\npage (optional): Page number (default 0)
\nsize (optional): Number of records per page (default 5)
\nExample Request:
GET /records?category=Salary&role=ADMIN&page=0&size=5
Response:
Returns a paginated list of financial records matching the given category.
Access Control:
ADMIN and ANALYST can access filtered data.
VIEWER has limited access (read-only).
Note:
Pagination is supported and results are returned page-wise.
Fetch financial records filtered by type.
\nQuery Parameters:
\ntype (required): INCOME or EXPENSE
\nrole (required): User role (ADMIN / ANALYST / VIEWER)
\npage (optional): Page number (default 0)
\nsize (optional): Number of records per page (default 5)
\nExample Request:
GET /records?type=INCOME&role=ADMIN&page=0&size=5
Response:
Returns paginated list of records filtered by transaction type.
Access Control:
ADMIN and ANALYST can access this data.
Note:
Supports pagination and can be combined with other filters.
Fetch financial records filtered by date.
\nQuery Parameters:
\ndate (required): Transaction date in format YYYY-MM-DD
\nrole (required): User role (ADMIN / ANALYST / VIEWER)
\npage (optional): Page number (default 0)
\nsize (optional): Number of records per page (default 5)
\nExample Request:
GET /records?date=2026-04-05&role=ADMIN&page=0&size=5
Response:
Returns paginated list of financial records for the given date.
Access Control:
ADMIN and ANALYST can access this data.
Note:
Date format must be YYYY-MM-DD.
Supports pagination and can be combined with other filters.
Fetch total income from all financial records.
\nQuery Parameters:
\nResponse:
Returns total income amount.
Access Control:
ADMIN and ANALYST can access this data.
Fetch total Expense from financial records
\n","urlObject":{"query":[],"variable":[]},"url":""},"response":[],"_postman_id":"8ee8def3-83b5-4040-a873-bc6a84ad96e4"},{"name":"Net Balance","id":"25bff496-0b73-4576-867e-0f3c99fdfbb3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"description":"Return net balance = total income-total expense.
\n","urlObject":{"query":[],"variable":[]},"url":""},"response":[],"_postman_id":"25bff496-0b73-4576-867e-0f3c99fdfbb3"},{"name":"Category summary","id":"acfed240-207e-400a-a7fe-ad7933a12263","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"description":"Fetch dashboard summary including category-level insights.
\nQuery Parameters:
\nExample Request:
GET /records/summary?role=ADMIN
Response:
Returns summary data including:
Total Income
\nTotal Expense
\nNet Balance
\nNote:
Category-wise summary is included as part of overall summary.
Separate category API is not implemented.
Access Control:
ADMIN and ANALYST can access this data.