Skip to content
You are offline. Some features may be unavailable.

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.

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": "unpaid",
    "created_at": "2026-05-01T12:00:00Z"
  }
}

Expense fields

FieldRequiredDescription
descriptionYesWhat the expense was for.
amountYesNumeric amount (e.g. 150.00).
dateYesDate of the expense (YYYY-MM-DD).
categoryNoFree-text category label.
vendorNoVendor or supplier name.
notesNoAdditional notes.