List transactions

get

https://api.toriihq.com/v1.0/transactions

Returns recognized (mapped) expense transactions by default.

amount is an object: value/currency are the original transaction amount; convertedValue is that amount in the organization display currency. Values are in minor currency units (e.g., cents).

Cursor-paginated: pass size for the page size and the returned nextCursor as cursor for the next page.

Sort with sort=<field>:asc|desc; sorting by amount uses the display-currency converted value. See transactionSortSchema for the sortable fields.

Rate limit: 100 requests per minute

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

idApp

integer

≤ 2147483647

Filter transactions by app id

source

string

Filter transactions by source

string

length ≤ 800

Free-text search on transaction description

mappingStatus

string

Defaults to mapped

Filter by mapping status (comma-separated). Defaults to mapped. Unmatched statuses (unknown, recommend_map) are unavailable when the org hides unmatched expenses.

sort

string

Sort order, e.g. transactionDate:desc. Sortable fields: id, transactionDate, amount, description, source, appName, appAccountName, reportedByFullName, mappingStatus, mappingLogic, idExternalTransaction, externalAccountId, externalAccountName. Sorting by amount uses the display-currency converted value.

size

integer

1 to 1000

The max amount of results to return

cursor

string

A base64 string indicating the offset from which to start.
Pass the value of nextCursor returned from the previous call to get the next set of results

fields

string

Defaults to id,idApp,transactionDate,amount,source,description,mappingStatus

List of fields to return for each transaction.
Allowed fields: id, idApp, appName, idAppAccount, appAccountName, idUpload, fileName, transactionDate, origTransactionDate, amount, source, description, extraInfo, department, domain, externalAccountId, externalAccountName, mappingStatus, mappingLogic, reportedBy, reportedByFullName, idExternalTransaction

Response

200Transactions