Expenses

Manage expenses

CREATE

POST https://api.pesatime.com/v1/expenses

Record a new expense

Request Body

Name	Type	Description
description	string	Add any other information here
category	string	The category ID
date	string	The date of the expense in format YYYY-MM-DD HH:MM
amount	number	The expense amount

200 Category successfully created.

{
  "status": 1,
  "message": "Saved",
  "data": {
    "_id": "5dce4b8a4d44af36f693cd2b"
  }
}

302 Error

{
  "status": 0,
  "message": "Error message here"
}

UPDATE

PUT https://api.pesatime.com/v1/expenses/:expenseId

Update an expense

Path Parameters

Name	Type	Description
expenseId	string	The ID of the expense to update

Request Body

Name	Type	Description
description	string	New description for the exp
category	string	The new category ID
date	string	Date in format YYYY-MM-DD
amount	number	The new amount

200 Success

{
  "status": 1,
  "message": "Expense updated successfully"
}

302 Error

{
  "status": 0,
  "message": "Error description here"
}

RETRIEVE - All

GET https://api.pesatime.com/v1/expenses

Retrieves all expenses

Path Parameters

Name	Type	Description
expenseID	string	The ID of the expense to retrieve details for

Query Parameters

Name	Type	Description
description	string	Search part of the description
category	string	The ID of the category
date_to	string	Date expense incurred (YYYY-MM-DD) e.g. 2019-10-14
date_from	string	Date expense incurred (YYYY-MM-DD) e.g. 2019-10-13

200 Success

{
  "status": 1,
  "data": [
    {
      "amount": 10001,
      "active": true,
      "_id": "5dce51d0bf6c524c59a75c96",
      "organization": "5db5a64a6cb3e2060a7b864c",
      "user": "5cded7f553ea376e8bba6bfd",
      "category": {
        "_id": "5cdfb75bb8f2b84e5fb55ce6",
        "name": "Office supplies"
      },
      "description": "20 copies ",
      "date": "2019-01-23T00:00:00.000Z",
      "attachments": [],
      "dateCreated": "2019-11-15T07:20:48.818Z",
      "__v": 0
    },
    
    .......
  
  ]
}

302 Expense not found

{
  "status": 1,
  "data": []
}

RETRIEVE - single item

GET https://api.pesatime.com/v1/expenses/:expenseId

Get details of one item

Path Parameters

Name	Type	Description
expenseId	string	Id of the expense to get details for

200

{
  "status": 1,
  "data": {
    "amount": 10001,
    "active": true,
    "_id": "5dce51d0bf6c524c59a75c96",
    "organization": "5db5a64a6cb3e2060a7b864c",
    "user": "5cded7f553ea376e8bba6bfd",
    "category": {
      "_id": "5cdfb75bb8f2b84e5fb55ce6",
      "name": "Office supplies"
    },
    "description": "20 copies ",
    "date": "2019-01-23T00:00:00.000Z",
    "attachments": [],
    "dateCreated": "2019-11-15T07:20:48.818Z",
    "__v": 0
  }
}

302 Error

{
  "status": 0,
  "message": "Expense with this id was not found"
}

DELETE

DELETE https://api.pesatime.com/v1/expenses/:expenseId

Delete a category

Path Parameters

Name	Type	Description
expenseId	string	The ID of the expense to delete

200

{
  "status": 1,
  "message": "Expense deleted successfully"
}

302

{
  "status": 0,
  "message": "Error description"
}