Fetch transaction via API

The following functionality exists for wallets reconstituted server-side. More on Privy architecture here

To get a transaction’s details using the NodeJS SDK, use the getTransaction method from the Privy client:

getTransaction: (input: {id: string}) => Promise<WalletApiTransactionResponseType>;

Usage

const transaction = await privy.walletApi.getTransaction({
  id: 'insert-transaction-id'
});
console.log(transaction);

Parameters

string

required

ID of the transaction to fetch details for.

Returns

transaction

WalletApiTransactionResponseType

Hide WalletApiTransactionResponseType

string

ID for the transaction.

walletId

string

ID for the wallet that sent the transaction.

caip2

string

CAIP-2 chain ID for the network the transaction was broadcasted on.

transactionHash

string

Hash for the transaction.

status

'broadcasted' | 'confirmed' | 'execution_reverted'

Current status of the transaction.

'broadcasted' refers to when a transaction has been submitted to the network but has not yet been included in a block
'confirmed' refers to when a transaction has been included in a block that has been confirmed on the network.
'execution_reverted' refers to when a transaction has reverted in execution.

To get a transaction’s details using the NodeJS SDK, use the getTransaction method from the Privy client:

getTransaction: (input: {id: string}) => Promise<WalletApiTransactionResponseType>;

Usage

const transaction = await privy.walletApi.getTransaction({
  id: 'insert-transaction-id'
});
console.log(transaction);

Parameters

string

required

ID of the transaction to fetch details for.

Returns

transaction

WalletApiTransactionResponseType

Hide WalletApiTransactionResponseType

string

ID for the transaction.

walletId

string

ID for the wallet that sent the transaction.

caip2

string

CAIP-2 chain ID for the network the transaction was broadcasted on.

transactionHash

string

Hash for the transaction.

status

'broadcasted' | 'confirmed' | 'execution_reverted'

Current status of the transaction.

'broadcasted' refers to when a transaction has been submitted to the network but has not yet been included in a block
'confirmed' refers to when a transaction has been included in a block that has been confirmed on the network.
'execution_reverted' refers to when a transaction has reverted in execution.

Privy supports fetching transaction status by the transaction ID.

To do so, make a GET request to

https://api.privy.io/v1/transactions/<transaction_id>

replacing <transaction_id> with the ID of your desired transaction.

Response

string

ID for the transaction.

wallet_id

string

ID for the wallet that sent the transaction.

status

'broadcasted' | 'confirmed' | 'execution_reverted'

Current status of the transaction. - 'broadcasted' refers to when a transaction has been submitted to the network but has not yet been included in a block - 'confirmed' refers to when a transaction has been included in a block that has been confirmed on the network. - 'execution_reverted' refers to when a transaction has reverted in execution.

transaction_hash

string

Hash for the transaction.

caip2

string

CAIP-2 chain ID for the network the transaction was broadcasted on.

Example

For example, you might fetch a transactions status using transaction ID using the cURL request below.

$ curl --request GET https://api.privy.io/v1/transactions/<transaction_id> \
-u "<your-privy-app-id>:<your-privy-app-secret>" \
-H "privy-app-id: <your-privy-app-id>" \
-H 'Content-Type: application/json' \

The response might look like

{
  "id": "<transaction_id>",
  "wallet_id": "fmfdj6yqly31huorjqzq38zc",
  "status": "confirmed",
  "transaction_hash": "0x2446f1fd773fbb9f080e674b60c6a033c7ed7427b8b9413cf28a2a4a6da9b56c",
  "caip2": "eip155:8453"
}

Embedded wallets

Using wallets

Funding

Gas and asset management

Session signers

Global wallets

Advanced Topics

Fetch transaction via API

Usage

Parameters

Returns

Usage

Parameters

Returns

Response

Example

Embedded wallets

Using wallets

Funding

Gas and asset management

Session signers

Global wallets

Advanced Topics

​Usage

​Parameters

​Returns

​Usage

​Parameters

​Returns

​Response

​Example

Usage

Parameters

Returns

Usage

Parameters

Returns

Response

Example