Expenses
Log and retrieve business expenses. Useful for syncing expenses from external tools or automating expense capture from receipts.
Endpoints
GET
https://api.tryesperworks.com/api/v1/expensesexpenses:readList expenses. Supports ?category=, ?date_from=, ?date_to=, ?per_page=.
POST
https://api.tryesperworks.com/api/v1/expensesexpenses:writeCreate an expense.
PATCH
https://api.tryesperworks.com/api/v1/expenses/:idexpenses:writeUpdate 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
| 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. |