{"info":{"_postman_id":"e9bbf107-caaa-458a-a48c-70572856f319","name":"Expenses-API_Gloria","description":"

The Expenses API is a RESTful API that allows users to track personal expenses efficiently. It provides user authentication (registration & login) and enables users to add, view, and delete expenses.EndFragment

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"43019439","collectionId":"e9bbf107-caaa-458a-a48c-70572856f319","publishedId":"2sAYkDLKfw","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-03-17T09:39:33.000Z"},"item":[{"name":"All Expenses","id":"0f51f4bf-869f-45b1-b015-28de5dd6d99f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://expenses-api-0e6d.onrender.com/expenses","description":"

This endpoint makes an HTTP GET request to retrieve a list of expenses from the specified URL. The request does not require any request body parameters.

Response

The response will have a status code of 200 and a content type of application/json. The body of the response will contain an array of expense objects, each with the following properties:

user (string): The user associated with the expense.
\n
item (string): The item or description of the expense.
\n
amount (number): The amount of the expense.
\n
category (string): The category of the expense.
\n
payment (string): The payment method used for the expense.
\n
status (string): The status of the expense.
\n
createdAt (string): The timestamp when the expense was created.
\n
updatedAt (string): The timestamp when the expense was last updated.
\n
id (string): The unique identifier of the expense.
\n

\n","urlObject":{"path":["expenses"],"host":["https://expenses-api-0e6d.onrender.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"0f51f4bf-869f-45b1-b015-28de5dd6d99f"},{"name":"Get Expenses by Id","id":"7ed852d8-54df-4c6e-a46d-ed91c078baba","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://expenses-api-0e6d.onrender.com/expenses/67d6f8cad99b07e4860486d6","description":"

Get Expense Details

This endpoint retrieves the details of a specific expense.

Request

Request URL

GET https://expenses-api-0e6d.onrender.com/expenses/67d6f8cad99b07e4860486d6

Response

The response will be a JSON object with the following schema:

{\n    \"type\": \"object\",\n    \"properties\": {\n        \"user\": {\n            \"type\": \"string\"\n        },\n        \"item\": {\n            \"type\": \"string\"\n        },\n        \"amount\": {\n            \"type\": \"number\"\n        },\n        \"category\": {\n            \"type\": \"string\"\n        },\n        \"payment\": {\n            \"type\": \"string\"\n        },\n        \"status\": {\n            \"type\": \"string\"\n        },\n        \"createdAt\": {\n            \"type\": \"string\"\n        },\n        \"updatedAt\": {\n            \"type\": \"string\"\n        },\n        \"id\": {\n            \"type\": \"string\"\n        }\n    }\n}\n\n

\n","urlObject":{"path":["expenses","67d6f8cad99b07e4860486d6"],"host":["https://expenses-api-0e6d.onrender.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"7ed852d8-54df-4c6e-a46d-ed91c078baba"},{"name":"Add an Expense","id":"db667499-7c98-4a21-977a-50c672c26864","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{vault:authorization-secret}}"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"item\": \"Book\",\r\n \"amount\": 1200,\r\n \"category\": \"Stationary\",\r\n \"payment\": \"Credit Card\",\r\n \"status\": \"Completed\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://expenses-api-0e6d.onrender.com/expenses","description":"

Create Expense

This endpoint allows the user to create a new expense.

Request Body

item (string): The name of the item purchased.
\n
amount (number): The cost of the item.
\n
category (string): The category to which the item belongs.
\n
payment (string): The mode of payment used.
\n
status (string): The status of the expense.
\n

Response (201 - Created)

The response will be in JSON format with the following schema:

{\n    \"type\": \"object\",\n    \"properties\": {\n        \"user\": { \"type\": \"string\" },\n        \"item\": { \"type\": \"string\" },\n        \"amount\": { \"type\": \"number\" },\n        \"category\": { \"type\": \"string\" },\n        \"payment\": { \"type\": \"string\" },\n        \"status\": { \"type\": \"string\" },\n        \"createdAt\": { \"type\": \"string\" },\n        \"updatedAt\": { \"type\": \"string\" },\n        \"id\": { \"type\": \"string\" }\n    }\n}\n\n

This endpoint allows you to add a new expense.

\n","urlObject":{"path":["expenses"],"host":["https://expenses-api-0e6d.onrender.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"db667499-7c98-4a21-977a-50c672c26864"},{"name":"Register User","id":"d70616e7-8318-4051-a424-99df5efcfc0a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"username\": \"afua doe\",\r\n \"email\": \"afua@example.com\",\r\n \"password\": \"Afua1234!\"\r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://expenses-api-0e6d.onrender.com/auth/register","description":"

Register User

This endpoint is used to register a new user.

Request Body

username (string): The username of the new user.
\n
email (string): The email address of the new user.
\n
password (string): The password for the new user.
\n

Example:

{\n    \"username\": \"afua doe\",\n    \"email\": \"afua@example.com\",\n    \"password\": \"Afua1234!\"\n}\n\n

Response

message (string): A message indicating the status of the registration process.

Example:

{\n    \"message\": \"User resgistered succesfully\"\n}\n\n

\n","urlObject":{"path":["auth","register"],"host":["https://expenses-api-0e6d.onrender.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"d70616e7-8318-4051-a424-99df5efcfc0a"},{"name":"User Login","id":"16ad81e6-6f47-4a4c-ad67-e4fb05c4277f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{vault:authorization-secret}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"email\": \"afua@example.com\",\r\n \"password\": \"Afua1234!\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://expenses-api-0e6d.onrender.com/auth/login","urlObject":{"path":["auth","login"],"host":["https://expenses-api-0e6d.onrender.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"16ad81e6-6f47-4a4c-ad67-e4fb05c4277f"},{"name":"Delete by Id","id":"28af3166-22bb-4f11-bc6b-7a44db921c58","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"https://expenses-api-0e6d.onrender.com/expenses/67d7401b25ea66d86a09645f","description":"

This endpoint allows the deletion of a specific expense identified by its unique ID.

Request Body

This request does not require a request body.

Response

Status: 200
\n
Content-Type: application/json
\n
{ \"message\": \"\"}
Upon successful deletion, the response will contain a message confirming the action.
\n

\n","urlObject":{"path":["expenses","67d7401b25ea66d86a09645f"],"host":["https://expenses-api-0e6d.onrender.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"28af3166-22bb-4f11-bc6b-7a44db921c58"}],"variable":[{"key":"LiveUrl","value":"https://expenses-api-0e6d.onrender.com","type":"default"}]}