Expenses

Log and retrieve business expenses. Useful for syncing expenses from external tools or automating expense capture from receipts.

Endpoints

GEThttps://api.tryesperworks.com/api/v1/expensesexpenses:read

List expenses. Supports ?category=, ?date_from=, ?date_to=, ?per_page=.

POSThttps://api.tryesperworks.com/api/v1/expensesexpenses:write

Create an expense.

PATCHhttps://api.tryesperworks.com/api/v1/expenses/:idexpenses:write

Update an expense.

DELETEhttps://api.tryesperworks.com/api/v1/expenses/:idexpenses:write

Delete an expense.

Create an expense

curl -X POST https://api.tryesperworks.com/api/v1/expenses \
  -H "Authorization: Bearer ew_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Office supplies",
    "amount": 150.00,
    "date": "2026-05-01",
    "category": "Office",
    "vendor": "Melcom"
  }'

Response

{
  "expense": {
    "id": 88,
    "description": "Office supplies",
    "amount": "150.00",
    "currency": "GHS",
    "date": "2026-05-01",
    "category": "Office",
    "vendor": "Melcom",
    "status": "pending",
    "created_at": "2026-05-01T12:00:00Z"
  }
}

Expense fields

Field	Required	Description
`description`	Yes	What the expense was for.
`amount`	Yes	Numeric amount (e.g. 150.00).
`date`	Yes	Date of the expense (YYYY-MM-DD).
`category`	No	Free-text category label.
`vendor`	No	Vendor or supplier name.
`notes`	No	Additional notes.