expenses

List /expenses

Search expenses. Matches name, reference number, note, or supplier name (optional query). Supports pagination and filters: status, payment status, category, assignees, date ranges, client, supplier, project, object, invoice, currency, organization, recurring. Each item uses uuid only. Response: items and pagination.

GET

/expenses

List /expenses

curl --request GET \
  --url 'https://default.hannacrm.app/api/v4/expenses?query=%3Cstring%3E&page=123&per_page=123&filter%5Bupdated_since%5D=2023-11-07T05%3A31%3A56Z&filter%5Bcreated_since%5D=2023-11-07T05%3A31%3A56Z&filter%5Bstatus%5D=%3Cstring%3E&filter%5Bpayment_status%5D=%3Cstring%3E&filter%5Bcategory%5D=3c90c3cc-0d44-4b50-8888-8dd25736052a&filter%5Bassignees%5D=3c90c3cc-0d44-4b50-8888-8dd25736052a&filter%5Bdate%5D=%3Cstring%3E&filter%5Bduedate%5D=%3Cstring%3E&filter%5Bclients%5D=%3Cstring%3E&filter%5Bsuppliers%5D=%3Cstring%3E&filter%5Bproject%5D=%3Cstring%3E&filter%5Bobject%5D=%3Cstring%3E&filter%5Binvoice%5D=%3Cstring%3E&filter%5Bcurrency%5D=%3Cstring%3E&filter%5Borganization%5D=3c90c3cc-0d44-4b50-8888-8dd25736052a&filter%5Brecurring%5D=123&filter%5Buuid%5D=%3Cstring%3E&filter%5Bcreated_by%5D=3c90c3cc-0d44-4b50-8888-8dd25736052a&filter%5Bupdated_by%5D=3c90c3cc-0d44-4b50-8888-8dd25736052a&filter%5Bcreated_at%5D=%3Cstring%3E&filter%5Bupdated_at%5D=%3Cstring%3E&sort=%3Cstring%3E&fields=%3Cstring%3E' \
  --header 'Authorization: Bearer <token>'

{
  "items": [
    {
      "amount": "<string>",
      "assignees": [
        {}
      ],
      "category": [
        {}
      ],
      "client": [
        {}
      ],
      "created_at": "2023-11-07T05:31:56Z",
      "created_by": {
        "name": "<string>",
        "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      },
      "currency": [
        {}
      ],
      "date": "<string>",
      "duedate": "<string>",
      "estimates": [
        {}
      ],
      "invoices": [
        {}
      ],
      "name": "<string>",
      "note": "<string>",
      "object": [
        {}
      ],
      "organization": [
        {}
      ],
      "organization_name": "<string>",
      "payment_mode": "<string>",
      "payment_status": "<string>",
      "project": [
        {}
      ],
      "reference_no": "<string>",
      "status": "<string>",
      "supplier": [
        {}
      ],
      "supplier_account_no": "<string>",
      "total": "<string>",
      "total_tax": "<string>",
      "updated_at": "2023-11-07T05:31:56Z",
      "updated_by": {
        "name": "<string>",
        "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      },
      "uuid": "<string>"
    }
  ],
  "pagination": {
    "from": 123,
    "last_page": 123,
    "page": 123,
    "per_page": 123,
    "to": 123,
    "total": 123
  },
  "query": "<string>"
}

Authorizations

Authorizationstringheaderrequired

API key (Bearer token) created in Setup → API & MCP.

Query Parameters

querystringquery

Optional search phrase for expense name, reference number, note, or supplier name.

Minimum string length: 1

pageintegerquery

Page number (1-based).

Required range: 1 <= x

per_pageintegerquery

Number of results per page. limit is accepted as an alias.

Required range: 1 <= x <= 50

filter[updated_since]stringquery

Return only records whose updated_at is at or after this ISO 8601 timestamp (e.g. 2026-08-11T00:00:00Z). Intended for incremental polling.

filter[created_since]stringquery

Return only records whose created_at is at or after this ISO 8601 timestamp (e.g. 2026-08-11T00:00:00Z). Intended for polling new records.

filter[status]stringquery

Expense status codes (1=default, 2=waiting approval, 3=approved, 4=cancelled, 5=incurred, 6=advance paid).

filter[payment_status]stringquery

Payment status codes (1=unpaid, 2=paid).

filter[category]string[]query

Expense category code_name values.

filter[assignees]string[]query

Responsible person staff UUIDs.

filter[date]stringquery

Expense date range.

filter[duedate]stringquery

Expense due date range.

filter[clients]stringquery

Client UUIDs.

filter[suppliers]stringquery

Supplier client UUIDs.

filter[project]stringquery

Project UUIDs.

filter[object]stringquery

Object UUIDs.

filter[invoice]stringquery

Related invoice UUIDs.

filter[currency]stringquery

Currency names (exact match, e.g. EUR).

filter[organization]string[]query

Organization UUIDs.

filter[recurring]integerquery

Filter by recurring flag.

Required range: 0 <= x <= 1

filter[uuid]stringquery

Record UUIDs. Use it to fetch several known records in one call.

filter[created_by]string[]query

Staff UUID who created the record.

filter[updated_by]string[]query

Staff UUID who last changed the record. Empty until the record is saved once after 2026-09.

filter[created_at]stringquery

Created date range (YYYY-MM-DD - YYYY-MM-DD). Use created_since for one-sided incremental polling.

filter[updated_at]stringquery

Last change date range (YYYY-MM-DD - YYYY-MM-DD). Use updated_since for one-sided incremental polling.

sortstringquery

Optional sort order, comma-separated; prefix a field with - for descending (e.g. sort=-updated_at); empty values sort last. Sortable fields: amount, created_at, date, duedate, name, note, payment_mode, payment_status, reference_no, status, supplier_account_no, updated_at, uuid. Default when omitted: -date.

fieldsstring[]query

Optional response field paths (dot notation for nested groups, e.g. billing_address.street; array fields are returned whole). Comma-separated string is also accepted. Identifier field is always included.

Response

Search results

itemsobject[]

Show child attributes

paginationobject

Show child attributes

querystring

Still need help? Ask the team