{"info":{"_postman_id":"0f9f5b2c-da3b-486a-b3a8-1cbca1899be6","name":"finance backend","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"description":"","owner":"48439439","collectionId":"0f9f5b2c-da3b-486a-b3a8-1cbca1899be6","publishedId":"2sBXiqEoew","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-04-06T09:47:20.000Z"},"item":[{"name":"Register","id":"cd2cfd2d-3463-4280-bc64-392febdf352f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\": \"rushi\",\r\n \"email\": \"vijay@gmail.com\",\r\n \"password\": \"123\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/users/register","description":"

Register users as Viewers by default. Only Admins are authorized to change roles like Analyst or Viewer.

\n

Users register as Viewer Only Admin can change roles.

\n

Note: Admin users are manually created in the database for security reasons and cannot be registered through public APIs.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"0f9f5b2c-da3b-486a-b3a8-1cbca1899be6","id":"0f9f5b2c-da3b-486a-b3a8-1cbca1899be6","name":"finance backend","type":"collection"}},"urlObject":{"path":["api","users","register"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"816dc8e8-4632-497e-b143-4077426f233e","name":"Register","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\": \"karan\",\r\n \"email\": \"karan@gmail.com\",\r\n \"password\": \"karan1\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/users/register"},"status":"Created","code":201,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 06 Apr 2026 09:44:34 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"238"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"Content-Encoding","value":"br"},{"key":"etag","value":"W/\"121-EKx3OqQVL6WDNJlTizcHGCDp2XM\""},{"key":"rndr-id","value":"c693fc59-0165-4e48"},{"key":"vary","value":"Accept-Encoding"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"9e7fda420ee24099-BOM"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"_id\": \"69d38082d255033501b1dff3\",\n \"name\": \"karan\",\n \"email\": \"karan@gmail.com\",\n \"role\": \"viewer\",\n \"isActive\": true,\n \"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY5ZDM4MDgyZDI1NTAzMzUwMWIxZGZmMyIsImlhdCI6MTc3NTQ2ODY3NCwiZXhwIjoxNzc2MDczNDc0fQ.OSna8xcOvbcMnOs49ElNoVC9AnqFMn1L6x1ciGvRT6c\"\n}"}],"_postman_id":"cd2cfd2d-3463-4280-bc64-392febdf352f"},{"name":"login","id":"eaa6b953-06ea-4b76-8665-7fa8b8959f16","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"admin@gmail.com\",\r\n \"password\": \"admin123\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/users/login","description":"

This API allows users to authenticate using email and password.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"0f9f5b2c-da3b-486a-b3a8-1cbca1899be6","id":"0f9f5b2c-da3b-486a-b3a8-1cbca1899be6","name":"finance backend","type":"collection"}},"urlObject":{"path":["api","users","login"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"54e05dbb-ac32-45be-9347-feb0f5d9173a","name":"login","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"rushi@gmail.com\",\r\n \"password\": \"rushi123\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/users/login"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 06 Apr 2026 04:39:38 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"243"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"Content-Encoding","value":"br"},{"key":"etag","value":"W/\"122-BxEo0RDhh6bvlETw57LFEv2z8Gc\""},{"key":"rndr-id","value":"a6fc1543-a015-4214"},{"key":"vary","value":"Accept-Encoding"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"9e7e1c192c1f80c1-BOM"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"_id\": \"69d32a2c25ed1b06f94dcde8\",\n \"name\": \"Prasad\",\n \"email\": \"rushi@gmail.com\",\n \"role\": \"viewer\",\n \"isActive\": true,\n \"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY5ZDMyYTJjMjVlZDFiMDZmOTRkY2RlOCIsImlhdCI6MTc3NTQ1MDM3OCwiZXhwIjoxNzc2MDU1MTc4fQ.OfrldMqTXDwxazbMq2OrRO8JDovHz3eZo2po7Xn3geY\"\n}"},{"id":"cf46c9b3-9a87-4577-bb61-4c1dd71efbbf","name":"Login failed","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"vihay@gmail.com\",\r\n \"password\": \"123\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/users/login"},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 06 Apr 2026 04:46:52 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"53"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"Content-Encoding","value":"br"},{"key":"etag","value":"W/\"37-5uDpJTljPBecOPs/j7OXFdPRcmQ\""},{"key":"rndr-id","value":"a22d6ff2-2602-4981"},{"key":"vary","value":"Accept-Encoding"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"9e7e26b53eca3dfe-BOM"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Invalid email or password\"\n}"},{"id":"768cbce0-2983-46c5-a0b5-d84c117336ba","name":"Manully admin login","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"email\": \"admin@gmail.com\",\r\n \"password\": \"admin123\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/users/login"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 06 Apr 2026 04:51:51 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"239"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"Content-Encoding","value":"br"},{"key":"etag","value":"W/\"120-QroFF1RGIbDc50gHGYDgySoYC6M\""},{"key":"rndr-id","value":"b0a89020-bbf0-40f2"},{"key":"vary","value":"Accept-Encoding"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"9e7e2dfffd608c3a-BOM"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"_id\": \"69d3220c16b426a4c569c545\",\n \"name\": \"Admin\",\n \"email\": \"admin@gmail.com\",\n \"role\": \"admin\",\n \"isActive\": true,\n \"token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY5ZDMyMjBjMTZiNDI2YTRjNTY5YzU0NSIsImlhdCI6MTc3NTQ1MTExMSwiZXhwIjoxNzc2MDU1OTExfQ.kkQ-bxn9k5ciY44poWCc4K8m-KIMQHH-L2Eu6PPO6TA\"\n}"}],"_postman_id":"eaa6b953-06ea-4b76-8665-7fa8b8959f16"},{"name":"Get all users","id":"a4be6373-f4a4-47bb-9e52-815c85569cd6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/users","description":"

This API allow to get all user information acess only ADMIN

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"0f9f5b2c-da3b-486a-b3a8-1cbca1899be6","id":"0f9f5b2c-da3b-486a-b3a8-1cbca1899be6","name":"finance backend","type":"collection"}},"urlObject":{"path":["api","users"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"80d0e5e8-df77-4809-b07d-e2f104e1f4ab","name":"Get all user by admin","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/users"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 06 Apr 2026 04:39:59 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"229"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"Content-Encoding","value":"br"},{"key":"etag","value":"W/\"1f1-vdxcPHyITQN1b+sB08h9Cfuumq0\""},{"key":"rndr-id","value":"10ee221b-112a-4fb5"},{"key":"vary","value":"Accept-Encoding"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"9e7e1c9f4adb80c1-BOM"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"[\n {\n \"isActive\": true,\n \"_id\": \"69d3220c16b426a4c569c545\",\n \"name\": \"Admin\",\n \"email\": \"admin@gmail.com\",\n \"role\": \"admin\"\n },\n {\n \"_id\": \"69d32a2c25ed1b06f94dcde8\",\n \"name\": \"Prasad\",\n \"email\": \"rushi@gmail.com\",\n \"role\": \"viewer\",\n \"isActive\": true,\n \"createdAt\": \"2026-04-06T03:36:12.451Z\",\n \"updatedAt\": \"2026-04-06T03:36:12.451Z\",\n \"__v\": 0\n },\n {\n \"_id\": \"69d333e0cd0f3b4acbac6099\",\n \"name\": \"rushi\",\n \"email\": \"vijay@gmail.com\",\n \"role\": \"viewer\",\n \"isActive\": true,\n \"createdAt\": \"2026-04-06T04:17:36.532Z\",\n \"updatedAt\": \"2026-04-06T04:17:36.532Z\",\n \"__v\": 0\n }\n]"},{"id":"639145b3-7abc-4685-93e1-176b1df058ce","name":"false to get users","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/users"},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 06 Apr 2026 04:51:08 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"48"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"Content-Encoding","value":"br"},{"key":"etag","value":"W/\"2c-wJP/0I2QL4vsXSp7BZZocFxX9P8\""},{"key":"rndr-id","value":"82ad2349-9ef8-468a"},{"key":"vary","value":"Accept-Encoding"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"9e7e2cf7d8528c3a-BOM"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Not authorized\"\n}"}],"_postman_id":"a4be6373-f4a4-47bb-9e52-815c85569cd6"},{"name":"Assign role","id":"58d1aff4-28b7-4547-989b-15131bb6c877","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"role\": \"analyst\"\r\n \r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/users/69d32a2c25ed1b06f94dcde8","description":"

Admin have Acess to assign the role to user like Analyst , viewer

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"0f9f5b2c-da3b-486a-b3a8-1cbca1899be6","id":"0f9f5b2c-da3b-486a-b3a8-1cbca1899be6","name":"finance backend","type":"collection"}},"urlObject":{"path":["api","users","69d32a2c25ed1b06f94dcde8"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"a5fa7b86-3cb8-44be-928b-94e2dcd20935","name":"Assign Role Admin only","originalRequest":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"role\": \"analyst\"\r\n \r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/users/69d32a2c25ed1b06f94dcde8"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 06 Apr 2026 04:40:43 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"94"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"Content-Encoding","value":"br"},{"key":"etag","value":"W/\"6d-+Wuox87Wu/iOmO1fDAdr5sgqxk8\""},{"key":"rndr-id","value":"56301ed0-d84c-479b"},{"key":"vary","value":"Accept-Encoding"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"9e7e1db2dd2580c1-BOM"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"_id\": \"69d32a2c25ed1b06f94dcde8\",\n \"name\": \"Prasad\",\n \"email\": \"rushi@gmail.com\",\n \"role\": \"analyst\",\n \"isActive\": true\n}"}],"_postman_id":"58d1aff4-28b7-4547-989b-15131bb6c877"},{"name":"Delete user by Admin","id":"6ae5a7d2-a9ce-4819-a5bb-11236e851a43","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api/users/69d32a2c25ed1b06f94dcde8","description":"

Delete user only by Admin . They have full permission to controller user

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"0f9f5b2c-da3b-486a-b3a8-1cbca1899be6","id":"0f9f5b2c-da3b-486a-b3a8-1cbca1899be6","name":"finance backend","type":"collection"}},"urlObject":{"path":["api","users","69d32a2c25ed1b06f94dcde8"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"6e50ab0c-f041-4739-b0fc-4fa8d1a76e23","name":"user delete successful","originalRequest":{"method":"DELETE","header":[],"url":"{{base_url}}/api/users/69d32a2c25ed1b06f94dcde8"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 06 Apr 2026 05:02:21 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"40"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"Content-Encoding","value":"br"},{"key":"etag","value":"W/\"27-27o4zzUjhHNmthTJyia4gBCjpos\""},{"key":"rndr-id","value":"1433be30-ceff-49b5"},{"key":"vary","value":"Accept-Encoding"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"9e7e3d5fbfeb97f6-BOM"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"User deleted successfully\"\n}"},{"id":"b6180a63-6498-42dd-aae4-401ac709ae36","name":"delete failed","originalRequest":{"method":"DELETE","header":[],"url":"{{base_url}}/api/users/69d32a2c25ed1b06f94dcde8"},"status":"Not Found","code":404,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 06 Apr 2026 05:03:23 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"46"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"Content-Encoding","value":"br"},{"key":"etag","value":"W/\"2c-EAnCIFy1uGovyo/FU6KYwnjLgrc\""},{"key":"rndr-id","value":"33083dd3-87d1-4e55"},{"key":"vary","value":"Accept-Encoding"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"9e7e3ee559a897f6-BOM"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"User not found\"\n}"}],"_postman_id":"6ae5a7d2-a9ce-4819-a5bb-11236e851a43"},{"name":"create record only admin","id":"b440b0b2-9b01-4b52-af23-b625f3b452ad","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"amount\": 7000,\r\n \"type\": \"expense\",\r\n \"category\": \"food\",\r\n \"date\": \"2026-04-06T00:00:00.000Z\",\r\n \"notes\": \"dinner with friends\",\r\n \"email\": \"vijay@gmail.com\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/records","description":"

create viewer records only admin have permission

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"0f9f5b2c-da3b-486a-b3a8-1cbca1899be6","id":"0f9f5b2c-da3b-486a-b3a8-1cbca1899be6","name":"finance backend","type":"collection"}},"urlObject":{"path":["api","records"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"c679c6ee-1e6e-4330-9bd5-045820c17d64","name":"create record only admin","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"amount\": 2000,\r\n \"type\": \"expense\",\r\n \"category\": \"food\",\r\n \"date\": \"2026-04-06T00:00:00.000Z\",\r\n \"notes\": \"dinner with friends\",\r\n \"email\": \"vijay@gmail.com\"\r\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/records"},"status":"Created","code":201,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 06 Apr 2026 04:43:00 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"170"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"Content-Encoding","value":"br"},{"key":"etag","value":"W/\"10b-swVGss55HanhpX8BZWqLAl+AuCs\""},{"key":"rndr-id","value":"7ddec34e-30b5-4733"},{"key":"vary","value":"Accept-Encoding"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"9e7e210cdc9c4467-BOM"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"user\": \"69d333e0cd0f3b4acbac6099\",\n \"amount\": 2000,\n \"type\": \"expense\",\n \"category\": \"food\",\n \"date\": \"2026-04-06T00:00:00.000Z\",\n \"notes\": \"dinner with friends\",\n \"_id\": \"69d339d413ddc8367f147cae\",\n \"createdAt\": \"2026-04-06T04:43:00.585Z\",\n \"updatedAt\": \"2026-04-06T04:43:00.585Z\",\n \"__v\": 0\n}"}],"_postman_id":"b440b0b2-9b01-4b52-af23-b625f3b452ad"},{"name":"Get all record admin only","id":"56c6677e-5ffd-4574-836d-7726d12f8a99","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/records?page=1&limit=2","description":"

This API allows an Admin user to fetch all financial records across all users.

\n

alos adding a pagination technique

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"0f9f5b2c-da3b-486a-b3a8-1cbca1899be6","id":"0f9f5b2c-da3b-486a-b3a8-1cbca1899be6","name":"finance backend","type":"collection"}},"urlObject":{"path":["api","records"],"host":["{{base_url}}"],"query":[{"key":"page","value":"1"},{"key":"limit","value":"2"}],"variable":[]}},"response":[{"id":"1faee128-8254-49a2-b427-236dfe268ea5","name":"Get all record admin only","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":{"raw":"{{base_url}}/api/records?page=1&limit=2","host":["{{base_url}}"],"path":["api","records"],"query":[{"key":"page","value":"1"},{"key":"limit","value":"2"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 06 Apr 2026 04:43:21 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"248"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"Content-Encoding","value":"br"},{"key":"etag","value":"W/\"256-cdy7eFIXBwu9wkY0v7xWZzQDOCg\""},{"key":"rndr-id","value":"5b124c96-e880-46b2"},{"key":"vary","value":"Accept-Encoding"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"9e7e218f28e24467-BOM"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"totalRecords\": 5,\n \"currentPage\": 1,\n \"totalPages\": 3,\n \"count\": 2,\n \"data\": [\n {\n \"_id\": \"69d32aeb25ed1b06f94dcdf9\",\n \"user\": \"69d32a2c25ed1b06f94dcde8\",\n \"amount\": 33300,\n \"type\": \"income\",\n \"category\": \"salary\",\n \"date\": \"2026-04-09T00:00:00.000Z\",\n \"notes\": \"wife salary\",\n \"createdAt\": \"2026-04-06T03:39:23.240Z\",\n \"updatedAt\": \"2026-04-06T03:39:23.240Z\",\n \"__v\": 0\n },\n {\n \"_id\": \"69d32aaf25ed1b06f94dcdf5\",\n \"user\": \"69d32a2c25ed1b06f94dcde8\",\n \"amount\": 500,\n \"type\": \"expense\",\n \"category\": \"product\",\n \"date\": \"2026-04-09T00:00:00.000Z\",\n \"notes\": \"purchase Trimmmer\",\n \"createdAt\": \"2026-04-06T03:38:23.241Z\",\n \"updatedAt\": \"2026-04-06T03:38:23.241Z\",\n \"__v\": 0\n }\n ]\n}"}],"_postman_id":"56c6677e-5ffd-4574-836d-7726d12f8a99"},{"name":"Get Dashboard Summary (Role-based)","id":"0434393e-eb4d-4bce-91ef-1c9883d82c71","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/dashboard","description":"

Analyst Get insight and filter to manage user records.

\n

admin have full access to dashboard.

\n

viewer see there only own records on the Dashboard

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"0f9f5b2c-da3b-486a-b3a8-1cbca1899be6","id":"0f9f5b2c-da3b-486a-b3a8-1cbca1899be6","name":"finance backend","type":"collection"}},"urlObject":{"path":["api","dashboard"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"82e6f00c-c96c-4949-b530-c222ed829470","name":"Admin","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/dashboard"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 06 Apr 2026 04:44:14 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"386"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"Content-Encoding","value":"br"},{"key":"etag","value":"W/\"38e-HULGdJe0XKvS6FQ61cTz7iVoVjA\""},{"key":"rndr-id","value":"16a8236f-75fa-4db5"},{"key":"vary","value":"Accept-Encoding"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"9e7e22d39e724467-BOM"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"totalIncome\": 123300,\n \"totalExpense\": 52500,\n \"netBalance\": 70800,\n \"categoryWise\": [\n {\n \"_id\": \"grocery\",\n \"total\": 140000\n },\n {\n \"_id\": \"salary\",\n \"total\": 33300\n },\n {\n \"_id\": \"product\",\n \"total\": 500\n },\n {\n \"_id\": \"food\",\n \"total\": 2000\n }\n ],\n \"recentTransactions\": [\n {\n \"_id\": \"69d339d413ddc8367f147cae\",\n \"user\": \"69d333e0cd0f3b4acbac6099\",\n \"amount\": 2000,\n \"type\": \"expense\",\n \"category\": \"food\",\n \"date\": \"2026-04-06T00:00:00.000Z\",\n \"notes\": \"dinner with friends\",\n \"createdAt\": \"2026-04-06T04:43:00.585Z\",\n \"updatedAt\": \"2026-04-06T04:43:00.585Z\",\n \"__v\": 0\n },\n {\n \"_id\": \"69d32aeb25ed1b06f94dcdf9\",\n \"user\": \"69d32a2c25ed1b06f94dcde8\",\n \"amount\": 33300,\n \"type\": \"income\",\n \"category\": \"salary\",\n \"date\": \"2026-04-09T00:00:00.000Z\",\n \"notes\": \"wife salary\",\n \"createdAt\": \"2026-04-06T03:39:23.240Z\",\n \"updatedAt\": \"2026-04-06T03:39:23.240Z\",\n \"__v\": 0\n }\n ],\n \"monthlyTrends\": [\n {\n \"_id\": {\n \"month\": 2,\n \"year\": 2025\n },\n \"total\": 90000\n },\n {\n \"_id\": {\n \"month\": 2,\n \"year\": 2026\n },\n \"total\": 50000\n },\n {\n \"_id\": {\n \"month\": 4,\n \"year\": 2026\n },\n \"total\": 35800\n }\n ]\n}"},{"id":"95a1dd0c-0268-4955-8d11-62a48f4bfa92","name":"Analyst","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/dashboard"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 06 Apr 2026 04:46:00 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"387"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"Content-Encoding","value":"br"},{"key":"etag","value":"W/\"38e-BqfBjwDa2rZYKLMBCx6a8pyAm/0\""},{"key":"rndr-id","value":"200b1d92-c173-4e98"},{"key":"vary","value":"Accept-Encoding"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"9e7e25676cdd3dfe-BOM"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"totalIncome\": 123300,\n \"totalExpense\": 52500,\n \"netBalance\": 70800,\n \"categoryWise\": [\n {\n \"_id\": \"salary\",\n \"total\": 33300\n },\n {\n \"_id\": \"food\",\n \"total\": 2000\n },\n {\n \"_id\": \"product\",\n \"total\": 500\n },\n {\n \"_id\": \"grocery\",\n \"total\": 140000\n }\n ],\n \"recentTransactions\": [\n {\n \"_id\": \"69d339d413ddc8367f147cae\",\n \"user\": \"69d333e0cd0f3b4acbac6099\",\n \"amount\": 2000,\n \"type\": \"expense\",\n \"category\": \"food\",\n \"date\": \"2026-04-06T00:00:00.000Z\",\n \"notes\": \"dinner with friends\",\n \"createdAt\": \"2026-04-06T04:43:00.585Z\",\n \"updatedAt\": \"2026-04-06T04:43:00.585Z\",\n \"__v\": 0\n },\n {\n \"_id\": \"69d32aeb25ed1b06f94dcdf9\",\n \"user\": \"69d32a2c25ed1b06f94dcde8\",\n \"amount\": 33300,\n \"type\": \"income\",\n \"category\": \"salary\",\n \"date\": \"2026-04-09T00:00:00.000Z\",\n \"notes\": \"wife salary\",\n \"createdAt\": \"2026-04-06T03:39:23.240Z\",\n \"updatedAt\": \"2026-04-06T03:39:23.240Z\",\n \"__v\": 0\n }\n ],\n \"monthlyTrends\": [\n {\n \"_id\": {\n \"month\": 2,\n \"year\": 2025\n },\n \"total\": 90000\n },\n {\n \"_id\": {\n \"month\": 2,\n \"year\": 2026\n },\n \"total\": 50000\n },\n {\n \"_id\": {\n \"month\": 4,\n \"year\": 2026\n },\n \"total\": 35800\n }\n ]\n}"},{"id":"1924d959-e821-4639-88b9-7f3d3b45605f","name":"Viewer","originalRequest":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/dashboard"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 06 Apr 2026 04:48:20 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"263"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"Content-Encoding","value":"br"},{"key":"etag","value":"W/\"1c7-Ynb2edM1SR6ge7ij27FltkxuT4M\""},{"key":"rndr-id","value":"2b285a52-2990-474f"},{"key":"vary","value":"Accept-Encoding"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"9e7e28d6492b3dfe-BOM"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"totalIncome\": 0,\n \"totalExpense\": 2000,\n \"netBalance\": -2000,\n \"categoryWise\": [\n {\n \"_id\": \"food\",\n \"total\": 2000\n }\n ],\n \"recentTransactions\": [\n {\n \"_id\": \"69d339d413ddc8367f147cae\",\n \"user\": \"69d333e0cd0f3b4acbac6099\",\n \"amount\": 2000,\n \"type\": \"expense\",\n \"category\": \"food\",\n \"date\": \"2026-04-06T00:00:00.000Z\",\n \"notes\": \"dinner with friends\",\n \"createdAt\": \"2026-04-06T04:43:00.585Z\",\n \"updatedAt\": \"2026-04-06T04:43:00.585Z\",\n \"__v\": 0\n }\n ],\n \"monthlyTrends\": [\n {\n \"_id\": {\n \"month\": 4,\n \"year\": 2026\n },\n \"total\": 2000\n }\n ]\n}"}],"_postman_id":"0434393e-eb4d-4bce-91ef-1c9883d82c71"},{"name":"Update recordsAdmin only","id":"c63f0def-2b2e-4678-a033-fb253c4e146f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Authorization","value":"Bearer {{token}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"amount\": 800000,\n \"type\": \"income\",\n \"category\": \"business\",\n \"date\": \"2026-04-06T00:00:00.000Z\",\n \"notes\": \"updated by admin - profit increased\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/records/69d32aaf25ed1b06f94dcdf5","description":"

This Api only admin can update users records .

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"0f9f5b2c-da3b-486a-b3a8-1cbca1899be6","id":"0f9f5b2c-da3b-486a-b3a8-1cbca1899be6","name":"finance backend","type":"collection"}},"urlObject":{"path":["api","records","69d32aaf25ed1b06f94dcdf5"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"47327c29-cfd9-4cc7-8a98-fd38f71612ab","name":"update fail","originalRequest":{"method":"PUT","header":[{"key":"Authorization","value":"Bearer {{token}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"amount\": 800000,\n \"type\": \"income\",\n \"category\": \"business\",\n \"date\": \"2026-04-06T00:00:00.000Z\",\n \"notes\": \"updated by admin - profit increased\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/records/69d32aaf25ed1b06f94dcdf5"},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 06 Apr 2026 04:52:57 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"48"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"Content-Encoding","value":"br"},{"key":"etag","value":"W/\"2c-wJP/0I2QL4vsXSp7BZZocFxX9P8\""},{"key":"rndr-id","value":"69e0f542-2703-4c1b"},{"key":"vary","value":"Accept-Encoding"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"9e7e2fa33b678c3a-BOM"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"success\": false,\n \"message\": \"Not authorized\"\n}"},{"id":"659528b1-6872-4048-8066-9ae8cec1519e","name":"Update sucessfully","originalRequest":{"method":"PUT","header":[{"key":"Authorization","value":"Bearer {{token}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"amount\": 800000,\n \"type\": \"income\",\n \"category\": \"business\",\n \"date\": \"2026-04-06T00:00:00.000Z\",\n \"notes\": \"updated by admin - profit increased\"\n}","options":{"raw":{"language":"json"}}},"url":"{{base_url}}/api/records/69d32aaf25ed1b06f94dcdf5"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 06 Apr 2026 04:55:49 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"181"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"Content-Encoding","value":"br"},{"key":"etag","value":"W/\"120-ZNjGyKKGO9Y5yJErk9UnsyLu250\""},{"key":"rndr-id","value":"9dee9edd-1edc-467b"},{"key":"vary","value":"Accept-Encoding"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"9e7e33cc2d284904-BOM"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"_id\": \"69d32aaf25ed1b06f94dcdf5\",\n \"user\": \"69d32a2c25ed1b06f94dcde8\",\n \"amount\": 800000,\n \"type\": \"income\",\n \"category\": \"business\",\n \"date\": \"2026-04-06T00:00:00.000Z\",\n \"notes\": \"updated by admin - profit increased\",\n \"createdAt\": \"2026-04-06T03:38:23.241Z\",\n \"updatedAt\": \"2026-04-06T04:55:48.967Z\",\n \"__v\": 0\n}"}],"_postman_id":"c63f0def-2b2e-4678-a033-fb253c4e146f"},{"name":"Delete record Admin only","id":"ff4b1e9a-3a26-4220-b393-10b36bea794c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"{{base_url}}/api/records/69d32aaf25ed1b06f94dcdf5","description":"

only Admin can delete records

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"0f9f5b2c-da3b-486a-b3a8-1cbca1899be6","id":"0f9f5b2c-da3b-486a-b3a8-1cbca1899be6","name":"finance backend","type":"collection"}},"urlObject":{"path":["api","records","69d32aaf25ed1b06f94dcdf5"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"decdbb50-bb5e-43fe-bd06-ff813bc0de13","name":"Delete record failed","originalRequest":{"method":"DELETE","header":[],"url":"{{base_url}}/api/records/69d3239e25ed1b06f94dcdbd"},"status":"Not Found","code":404,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 06 Apr 2026 04:57:35 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"34"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"Content-Encoding","value":"br"},{"key":"etag","value":"W/\"1e-AEuiJmu5BwTG8l6l2ONcbwZ5ITA\""},{"key":"rndr-id","value":"7c05a797-8ccd-437e"},{"key":"vary","value":"Accept-Encoding"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"9e7e3662cb6d47e7-BOM"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Record not found\"\n}"},{"id":"a00dd06b-38c2-41bc-a3c2-f00b54324c85","name":"Delete successfully","originalRequest":{"method":"DELETE","header":[],"url":"{{base_url}}/api/records/69d32aaf25ed1b06f94dcdf5"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Date","value":"Mon, 06 Apr 2026 05:00:04 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Content-Length","value":"43"},{"key":"Connection","value":"keep-alive"},{"key":"access-control-allow-origin","value":"*"},{"key":"Content-Encoding","value":"br"},{"key":"etag","value":"W/\"29-us2dDQ8uYUhKd54WoDEgZNWpdX4\""},{"key":"rndr-id","value":"2b0f2f9e-2ea7-44b2"},{"key":"vary","value":"Accept-Encoding"},{"key":"x-powered-by","value":"Express"},{"key":"x-render-origin-server","value":"Render"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"9e7e3a076ad147e7-BOM"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Record deleted successfully\"\n}"}],"_postman_id":"ff4b1e9a-3a26-4220-b393-10b36bea794c"}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]}},"event":[{"listen":"prerequest","script":{"id":"e123e38c-4937-4713-9ca3-07a85432748e","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"5a98e6d7-dc7e-4ebe-aed5-188fa8ed9cfc","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}]}