Gravv docs
Docs Agent Sign in Get API keys

List transactions

Lists your transactions, newest first. Filters that take values accept a comma-separated list. There is no date filter; use the export for dates. A typo in a filter value returns an empty list, not an error. Page through the results with total_pages until a page is empty.

GEThttps://api.gravv.xyz/v1/transactions

Query Parameters

Transactions that send from or receive into this account

Exact blockchain transaction hash

Sending or receiving wallet address, not case-sensitive

One or more channels, comma-separated, such as ach,wire. See the channel values on the transaction. An unknown value returns nothing.

Possible values: in, out

One or more of pending, completed, failed, waiting_approval and paused, comma-separated

One or more transaction types, comma-separated. See the transaction_type values on the transaction. An unknown value returns nothing.

Responses

Status Description
200 A page of transactions
400 The request failed. Every transactions error is a 400, including not-found.

200 response

Amount in currency, as a decimal string

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

The client_metadata sent with the transfer

Possible values: in, out

Details that depend on the transaction type. Empty fields can be null or left out.

Local equivalent amount as a decimal string

ISO 4217 currency code for local_amount

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

The transfer reference

Why it failed, when known

paused means the transfer needs something from you; see POST /v1/transfer/{id}/resume. A returned payment keeps completed, and the return appears as a new transaction.

Possible values: pending, completed, failed, waiting_approval, paused

US payouts are bank_account; refunds are transfer_refund.

Possible values: internal_transfer, crypto_transfer, crypto_funding, global_remittance, ach_transfer, wire_transfer, sepa_transfer, swift_transfer, fps_transfer, bank_transfer, bank_account, mobile_money, card_funding, card_withdrawal, card_payment, card_collection, account_funding, credit, debit, fee_charge, subscription_fee, invoice_payment, otc, transfer_refund, stablecoin_conversion

Blockchain transaction hash

The number of items on this page, not the page size you asked for

An estimate when there is more than one page, and 0 on an empty page. Use total_pages.

400 response

{
"data": null,
"error": "invalid request params"
}

Authorization

  • ApiKeyAuth
Was this page helpful?
ESC