Appearance
expenses
10 endpoints at a glance
| Method | Path | Summary |
|---|---|---|
GET | /expenses | List Expenses |
POST | /expenses | Create Expense |
DELETE | /expenses/{expense_id} | Delete Expense |
GET | /expenses/{expense_id} | Get Expense |
PATCH | /expenses/{expense_id} | Update Expense |
POST | /expenses/{expense_id}/book | Book Expense |
POST | /expenses/{expense_id}/credit | Credit Expense |
POST | /expenses/{expense_id}/payment | Register Payment |
POST | /expenses/capture | Capture Expense |
POST | /expenses/capture-from-email | Capture Expense From Email |
expenses
List Expenses
Create Expense
POST
/expenses
Parameters
Header Parameters
authorization
Request Body
application/json
JSON "supplier_ref": { "type": "string", "id": "string", "ref": { "additionalProperties": "string" }, "label": "string" }, "issue_date": "string", "due_date": "string", "supplier_invoice_number": "string", "notes": "string", "lines": [ { "description": "", "amount_cents": 0, "incl_btw": false, "btw_code": "string", "expense_account_id": "string" } ]
{
}
Responses
Successful Response
application/json
JSON "additionalProperties": "string"
{
}
Capture Expense
POST
/expenses/capture
Upload a receipt (image or PDF) → prefilled draft expense with the receipt
attached. Digital PDFs read their text layer (no OCR); images/scans use
tesseract (501 when it's not installed).
Parameters
Header Parameters
authorization
Request Body
multipart/form-data
Responses
Successful Response
application/json
JSON "additionalProperties": "string"
{
}
Capture Expense From Email
POST
/expenses/capture-from-email
Capture a receipt straight from an email attachment (PDF/image) — the
common path for emailed invoices — into a prefilled draft expense.
Parameters
Header Parameters
authorization
Request Body
application/json
JSON "email_id": "string", "part_id": "string"
{
}
Responses
Successful Response
application/json
JSON "additionalProperties": "string"
{
}
Get Expense
Delete Expense
Update Expense
PATCH
/expenses/{expense_id}
Parameters
Header Parameters
authorization
Path Parameters
expense_id*
Type
Requiredstring
Request Body
application/json
JSON "supplier_ref": { "type": "string", "id": "string", "ref": { "additionalProperties": "string" }, "label": "string" }, "issue_date": "string", "due_date": "string", "supplier_invoice_number": "string", "notes": "string", "lines": [ { "description": "", "amount_cents": 0, "incl_btw": false, "btw_code": "string", "expense_account_id": "string" } ]
{
}
Responses
Successful Response
application/json
JSON "additionalProperties": "string"
{
}