| Method & Path | Permission | Purpose | Side effects |
|---|---|---|---|
GET expenses / GET expenses/{expense} | expense.view | List / detail | — |
POST expenses | expense.manage | Create draft | Computes tax from the linked tax rate |
DELETE expenses/{expense} | expense.manage | Delete draft | — |
GET expenses/{expense}/pdf | expense.view | Stream PDF with signature block | — |
GET/POST expenses/{expense}/attachments | expense.view/expense.manage | Attachments (e.g. receipts) | Stores file, audit |
GET expenses/{expense}/history | expense.view | Workflow history | — |
POST expenses/{expense}/submit | /review | /approve | /reject | /reverse | expense.submit/review/approve/reject/reverse | Workflow | approve posts to ledger (402 usage_limit_reached at the monthly transaction cap); reverse submits a reversing entry for approval |
Expenses API
Create, submit, review, approve and reverse expense records, attach receipts, and read an expense back with its workflow history.
More in Developers & API
- API Overview
- API Access
- API Authentication
- API Conventions
- Authorization
- API Error Reference
- Integration Examples
- Webhooks
Endpoint reference