Gravv DOCS
Docs Agent Get Started
API Reference Get transactions

Get transactions

Retrieve a list of transactions with optional filtering and pagination.

GET/v1/transactions

Query Parameters

Page number for pagination

Number of transactions per page

Filter transactions by customer ID

Filter transactions by account ID

Filter transactions by card ID

Filter transactions by payment link ID

Filter by blockchain transaction hash

Filter by transaction channel

Possible values: avalanche, ethereum, solana, stellar, polygon, ach, wire, swift, bank_transfer, mobile_money, internal, swap, sepa, base, sui, tron, card, card_funding, card_withdrawal, card_payment, savings, savings_withdrawal, savings_interest

Filter by transaction direction

Possible values: in, out

Filter by transaction status

Possible values: pending, completed, failed, waiting_approval

Filter by transaction type

Possible values: internal_transfer, crypto_transfer, crypto_funding, global_remittance, card_funding, card_withdrawal, card_payment, account_funding, credit, debit, fee_charge, subscription_fee, invoice_payment

Filter transactions created on or after this timestamp

Filter transactions created on or before this timestamp

Responses

Status Description
200 List of transactions
400 Bad request — invalid parameters or downstream error

200 response

Unique transaction identifier

Transaction amount as a decimal string

Account balance before this transaction as a decimal string

Account balance after this transaction as a decimal string

Transaction channel

Possible values: avalanche, ethereum, solana, stellar, polygon, ach, wire, swift, bank_transfer, mobile_money, internal, swap, sepa, base, sui, tron, card, card_funding, card_withdrawal, card_payment, savings, savings_withdrawal, savings_interest

Caller-supplied opaque JSON string stored verbatim for reference

Client reference identifier

Customer identifier

Transaction creation timestamp

Transaction description

Transaction direction

Possible values: in, out

External system identifier for this transaction

Transaction fee as a decimal string

Additional transaction metadata

Local equivalent amount as a decimal string

ISO 4217 currency code for local_amount

Unique end-to-end transaction reference (SWIFT UETR)

Receiving account identifier

Transaction reference

Sending account identifier

Display name of the sending account

Account number of the sending account

Transaction status

Possible values: pending, completed, failed, waiting_approval

Tenant identifier

Type of transaction

Possible values: internal_transfer, crypto_transfer, crypto_funding, global_remittance, card_funding, card_withdrawal, card_payment, account_funding, credit, debit, fee_charge, subscription_fee, invoice_payment

Blockchain transaction hash

400 response

{
"data": null,
"error": "invalid query parameter"
}

Authorization

  • ApiKeyAuth
Was this page helpful?
Assistant
Responses are generated using AI and may contain mistakes.

Ask me anything about the documentation.

ESC