Skip to main content
GET
List transactions
Spam transactions are excluded unless you set include_spam=true. An ID filter cannot be combined with has_posted_journal_entry, status=posted or status=pending.

Authorizations

X-API-Key
string
header
required

Your organization API key. Some operations also need a key that is associated with a user; their pages say so.

Query Parameters

source_class
enum<string>

Filter by source class.

Available options:
crypto,
fiat,
exchange,
card,
other
status
enum<string>

Filter by transaction status.

Available options:
pending,
posted,
spam
has_posted_journal_entry
boolean

Filter by whether the transaction has a posted journal entry.

include_spam
boolean

Set to true to include spam transactions. Use status=spam for spam only.

min_value
string

Minimum gross fiat value in the selected currency. No currency conversion is applied.

Pattern: ^[0-9]+(?:\.[0-9]+)?$
Example:

"100.00"

max_value
string

Maximum gross fiat value in the selected currency. No currency conversion is applied.

Pattern: ^[0-9]+(?:\.[0-9]+)?$
Example:

"100.00"

min_quantity
string

Minimum gross asset quantity. For fiat transactions, this is the fiat amount.

Pattern: ^[0-9]+(?:\.[0-9]+)?$
Example:

"0.5"

max_quantity
string

Maximum gross asset quantity. For fiat transactions, this is the fiat amount.

Pattern: ^[0-9]+(?:\.[0-9]+)?$
Example:

"0.5"

sort_by
enum<string>
default:transaction_date

Field to sort results by.

Available options:
transaction_date,
created_at,
updated_at,
gross_amount,
net_amount,
gross_price,
asset_type,
chain
sort_direction
enum<string>
default:desc

Sort order. Defaults to descending (newest first).

Available options:
asc,
desc

Filter by one or more legal entity IDs. Omit to include all authorized entities. An empty list is invalid.

transaction_ids
string[]

IDs to return, separated by commas. The other filters also apply. Do not combine with has_posted_journal_entry, status=posted or status=pending.

exclude_transaction_ids
string[]

Exclude these transaction IDs. Can be combined with has_posted_journal_entry=false.

transaction_sequence_numbers
string[]

Any of these transaction sequence numbers, such as OT-123. Do not combine with has_posted_journal_entry=false.

Maximum array length: 100
Maximum string length: 64
Pattern: ^OT-\d+$
financial_account_ids
string[]

Filter by IDs returned in account_id. Matches a source or its associated wallet, including linked Solana staking accounts.

transaction_types
enum<string>[]

Any of these economic transaction types. These are separate from accounting classifications.

Available options:
DEPOSIT,
WITHDRAWAL,
SWAP,
NON_TAXABLE_CONVERSION,
BRIDGE,
INTERCOMPANY TRANSFER,
INTERNAL TRANSFER,
FEE,
MINTING,
STAKING_REWARD,
VALIDATOR_REWARD,
INVOICE,
BILL,
CLAIM REWARD,
BORROW,
REPAYMENT,
RESERVES CHANGE,
REALIZED_PNL,
INCOME,
EXPENSE,
REFUND,
CHARGEBACK,
NFT,
SPAM,
UNKNOWN
source_types
string[]

Filter by one or more source types. Repeat the parameter or send a comma-separated list.

asset_types
string[]

Filter by one or more asset types. Repeat the parameter or send a comma-separated list.

chains
string[]

Filter by one or more chains. Repeat the parameter or send a comma-separated list.

addresses
string[]

On-chain addresses, up to 100. Matches the from or to address, without case sensitivity. A transaction matches when it touches an address or belongs to a source in financial_account_ids or source_id. Repeat the parameter or send a comma-separated list.

Maximum array length: 100
provider_category
string[]

Raw category from Ramp or Plaid, matched as a substring without case sensitivity. Values in the array match any; labels joined with ; in one value must all match.

include_count
boolean

Include the total number of matching records. If the count cannot be calculated, the request fails.

count_only
boolean

Return total_count with an empty data array and no next page. Takes precedence over include_count.

limit
integer
default:25

Maximum number of records to return.

Required range: 1 <= x <= 100
cursor
string

The next_cursor value from the previous page. Keep the other filters unchanged.

Case-insensitive search in labels and descriptions.

source_id
string

Source ID (src_…).

Example:

"src_507f1f77bcf86cd799439011"

direction
enum<string>

Direction of the movement relative to the source.

Available options:
debit,
credit
start_date
string<date-time>

Inclusive event timestamp lower bound.

Example:

"2026-08-31T12:00:00Z"

end_date
string<date-time>

Inclusive upper bound for the event timestamp.

Example:

"2026-08-31T12:00:00Z"

updated_since
string<date-time>

Inclusive lower bound for the last update time. When you sync changes, deduplicate by id and updated_at.

Example:

"2026-08-31T12:00:00Z"

Response

The matching records.

data
object[]
required

The records.

has_more
boolean
required

Whether another page is available.

next_cursor
string | null
required

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

total_count
integer

Total matching records across all pages. Present when include_count=true or count_only=true.

Required range: x >= 0