expenses

Query

limit = 10

The number of results to fetch (default 10, max 1000)

offset

The offset to use to fetch

fromAccount

Reference of an account that is the payee of an expense

fromAccounts

An alternative to filter by fromAccount (singular), both cannot be used together

account

Reference of an account that is the payer of an expense

accounts

An alternative to filter by accounts, both cannot be used together

host

Return expenses only for this host (payer / collective side)

fromHost

Return expenses only for payees (fromCollective) hosted by this host. Cannot be used together with host .

hostContext

If host or fromHost is provided, select whether to include ALL, INTERNAL or HOSTED accounts (payer when using host , payee when using fromHost ).

createdByAccount

Return expenses only created by this INDIVIDUAL account

status

Use this field to filter expenses on their statuses

type

Use this field to filter expenses on their type (RECEIPT/INVOICE)

types

tag

Only expenses that match these tags

orderBy = { "field": "CREATED_AT", "direction": "DESC" }

The order of results

amount

Only return expenses that match this amount range

minAmount

Only return expenses where the amount is greater than or equal to this value (in cents)

maxAmount

Only return expenses where the amount is lower than or equal to this value (in cents)

payoutMethodType

Only return expenses that use the given type as payout method

dateFrom

Only return expenses that were created after this date

dateTo

Only return expenses that were created after this date

searchTerm

The term to search

includeChildrenExpenses

Whether to include expenses from children of the account (Events and Projects)

customData

Only return expenses that contains this custom data. Requires being an admin of the collective, payee or host.

chargeHasReceipts

Filter expenses of type charges based on presence of receipts

virtualCards

Filter expenses of type charges using these virtual cards

lastCommentBy

Filter expenses by the last user-role who replied to them

accountingCategory

Only return expenses that match these accounting categories

payoutMethod

Only return transactions that are associated with this payout method

activity

Filter expenses by activities

kycStatus

Filter expenses by KYC status