Skip to main content
GET
/
v1
/
transactions
List Transactions
curl --request GET \
  --url https://api.privy.io/v1/transactions \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'privy-app-id: <privy-app-id>'
{
  "transactions": [
    {
      "id": "cm7oxq1el000e11o8iwp7d0d0",
      "wallet_id": "fmfdj6yqly31huorjqzq38zc",
      "status": "confirmed",
      "transaction_hash": "0x2446f1fd773fbb9f080e674b60c6a033c7ed7427b8b9413cf28a2a4a6da9b56c",
      "caip2": "eip155:8453",
      "created_at": 1631573050000
    }
  ]
}
Use this endpoint to look up transactions by a developer-provided reference_id. This is useful for reconciling transactions initiated via eth_sendTransaction or signAndSendTransaction with your internal records.
To set a reference_id on a transaction, pass it when calling eth_sendTransaction (EVM) or signAndSendTransaction (Solana). The reference_id must be unique per transaction and can be up to 64 characters.

Authorizations

Authorization
string
header
required

Basic Auth header with your app ID as the username and your app secret as the password.

Headers

privy-app-id
string
required

ID of your Privy app.

Query Parameters

reference_id
string
required

Developer-provided reference ID to filter transactions by.

Response

200 - application/json

List of transactions matching the reference ID.

A list of transactions.

transactions
object[]
required