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
Transaction · object[]
required