List expenses

GET/v1/expenses

Coming April 2027

This endpoint ships in April 2027. The shape shown here can still change before release.

Returns expenses, newest first, filtered by client, category, currency or billable state.

Results use cursor pagination. See Expenses.

Permission: expenses.view
Type: Read-only. Changes nothing.
Auth: API key, MCP token or signed-in session
Capability: list_expenses
CLI: freeinvoiceautomation expense list
Available: From April 2027

list_expenses

curl --request GET \
  --url https://api.freeinvoiceautomation.com/v1/expenses \
  --header 'Authorization: Bearer <api-key>'

{
  "data": [
    {
      "id": "0193fa20-3c4d-7e5f-8a6b-7c8d9e0f1a2b",
      "business_id": "0193f29e-11aa-7c3b-8d2e-5a6b7c8d9e0f",
      "expense_date": "2027-04-05",
      "vendor": "Stock Images Co",
      "category_key": "software",
      "amount_minor": "4900",
      "currency": "USD",
      "tax_minor": null,
      "tax_rate_id": null,
      "receipt_attachment_id": "0193fa20-3c4d-7e5f-8a6b-7c8d9e0f1a2c",
      "agent_run_id": null,
      "billable": true,
      "client_id": "0193f2a0-5b1c-7d2e-8f3a-4b5c6d7e8f90",
      "markup_percent": "10.0000",
      "invoiced_document_id": null,
      "invoiced_line_id": null,
      "notes": "Photos for the homepage",
      "created_at": "2027-04-05T16:20:00Z",
      "updated_at": "2027-04-05T16:20:00Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Authorizations

Authorizationstringrequired

Bearer <api-key>. An API key from Settings > API keys, or an MCP token. See Authentication.

Query Parameters

business_idstring<uuid>

Only expenses of this business.

client_idstring<uuid>

Only expenses billable to this client.

category_keystring

Only this category; comma-separate several.

currencystring

Only this currency.

billableboolean

Only billable (true) or non-billable (false) expenses.

limitintegerdefault:50

Page size, 1 to 200.

cursorstring

Cursor from the previous page's next_cursor.

Response

200 - application/json

dataobject[]

The expenses on this page.

next_cursorstring | null

Cursor for the next page, or null on the last page.

has_moreboolean

Whether another page exists.

Errors

business_out_of_scope

Plus the common errors every call can return. See Errors.

Suggest edits Raise issue

Record an expensePrevious Get an expenseNext

list_expenses

curl --request GET \
  --url https://api.freeinvoiceautomation.com/v1/expenses \
  --header 'Authorization: Bearer <api-key>'

{
  "data": [
    {
      "id": "0193fa20-3c4d-7e5f-8a6b-7c8d9e0f1a2b",
      "business_id": "0193f29e-11aa-7c3b-8d2e-5a6b7c8d9e0f",
      "expense_date": "2027-04-05",
      "vendor": "Stock Images Co",
      "category_key": "software",
      "amount_minor": "4900",
      "currency": "USD",
      "tax_minor": null,
      "tax_rate_id": null,
      "receipt_attachment_id": "0193fa20-3c4d-7e5f-8a6b-7c8d9e0f1a2c",
      "agent_run_id": null,
      "billable": true,
      "client_id": "0193f2a0-5b1c-7d2e-8f3a-4b5c6d7e8f90",
      "markup_percent": "10.0000",
      "invoiced_document_id": null,
      "invoiced_line_id": null,
      "notes": "Photos for the homepage",
      "created_at": "2027-04-05T16:20:00Z",
      "updated_at": "2027-04-05T16:20:00Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}