buezli.app API

/2026-07-14/expenses

Expense

Expenses preserve project-related cost snapshots, billing state and optional receipt downloads.

Endpoints

GET /2026-07-14/expenses/:id/receipt Receipt

Example request

curl \
  -H "Authorization: Bearer $BUEZLI_API_TOKEN" \
  "https://api.buezli.app/2026-07-14/expenses/123/receipt"
GET /2026-07-14/expenses List records

Example request

curl \
  -H "Authorization: Bearer $BUEZLI_API_TOKEN" \
  "https://api.buezli.app/2026-07-14/expenses?page=1&limit=50"
GET /2026-07-14/expenses/:id Retrieve one record

Example request

curl \
  -H "Authorization: Bearer $BUEZLI_API_TOKEN" \
  "https://api.buezli.app/2026-07-14/expenses/123"

Fields

FieldTypeDescription
idintegerUnique identifier for the resource.
created_atdatetimeTimestamp when the resource was created.
updated_atdatetimeTimestamp when the resource was last updated.
client_idintegerID of the client associated with the project.
project_idintegerID of the project the expense was recorded against.
expense_category_idintegerID of the category assigned to the expense.
invoice_idintegerID of the invoice containing this expense, or null when not invoiced.
spent_ondateDate on which the expense occurred.
calculation_typestringSnapshotted calculation shape: flat or quantity_based.
quantitydecimalSnapshotted quantity with at most four decimal places, or null for a flat expense.
unitstringSnapshotted unit label, or null for a flat expense.
unit_ratemoneySnapshotted rate per unit, or null for a flat expense.
totalmoneyAuthoritative stored total; consumers must not recalculate this accounting amount.
currencystringISO 4217 currency code used for the entire expense snapshot.
notesstringFree-form notes describing the expense.
billablebooleanWhether the expense can be billed to the client.
billedbooleanWhether the expense has been billed, including outside Buezli.
reimbursedbooleanWhether the expense has been reimbursed.
archived_atdatetimeTimestamp when the expense was archived, or null when active.
receiptdownloadAvailability and API download path for the expense receipt.

Relationships

client

Returned as an ID. Add expand=client to include the related record.

project

Returned as an ID. Add expand=project to include the related record.

expense_category

Returned as an ID. Add expand=expense_category to include the related record.

invoice

Returned as an ID. Add expand=invoice to include the related record.