iotoms Docs

List expenses for a day cycle

GET
/api/v1/ops/day-cycles/{dayCycleId}/expenses

Returns all field expenses logged in a day cycle, newest first. Optionally filter by status (PENDING, APPROVED, REJECTED).

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Path Parameters

dayCycleId*string

Day cycle UUID

Formatuuid

Query Parameters

status?string

Filter by approval status: PENDING | APPROVED | REJECTED

Value in"PENDING""APPROVED""REJECTED"

Header Parameters

Response Body

OK

*/*
  1. response
status*string

Outcome of the call: SUCCESS when it worked, ERROR when it failed.

message*string

Short human-readable message describing the outcome, for example "Vendor created". Do not parse it.

data?array<>|

Expenses logged in the day cycle, newest first.

Example Request
curl -X GET 'https://beta.iotoms.com/api/v1/ops/day-cycles/497f6eca-6276-4993-bfeb-53cbbbba6f08/expenses'
Example Response
{  "status": "string",  "message": "string",  "data": [    {      "expenseId": "a2142719-090a-410b-ad70-ea5efeb1c9dc",      "dayCycleId": "bbed7a30-80be-4ccf-810d-a33c370a67d1",      "salesExecutiveId": "string",      "category": "FUEL",      "amount": 0,      "title": "string",      "vendorName": "string",      "receiptNumber": "string",      "paymentMode": "CASH",      "expenseDate": "2019-08-24",      "gpsLat": 0,      "gpsLon": 0,      "notes": "string",      "approvalStatus": "PENDING",      "approvedBy": "string",      "approvedAt": "2019-08-24T14:15:22Z",      "rejectionReason": "string",      "createdAt": "2019-08-24T14:15:22Z"    }  ]}