Skip to main content
GET
Get wallet action by reference ID
Use this endpoint to look up a wallet action by a developer-provided reference_id. This is useful for reconciling actions initiated via transfer, swap or earn with your internal records. Unlike get wallet action and list all wallet actions, this endpoint searches across every wallet in your app, so you do not need to know which wallet performed the action.
To set a reference_id on a wallet action, pass it in the request body when creating the action. The reference_id must be unique per app and can be up to 64 characters. See Set a reference ID for examples.
If no action matches the given reference_id, the endpoint returns 200 with an empty list rather than a 404. Pass ?include=steps to expand step-level details in the response.

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 look the wallet action up by.

Required string length: 1 - 64
include
enum<string>

Include step-level details in the response.

Available options:
steps

Response

200 - application/json

List containing the matching wallet action, or empty if none matched.

A list of wallet actions.

actions
(SwapActionResponse · object | TransferActionResponse · object | EarnDepositActionResponse · object | EarnWithdrawActionResponse · object | EarnIncentiveClaimActionResponse · object | EarnFeeCollectActionResponse · object | PayoutResponse · object)[]
required

Response for a swap action.