Get wallet action by reference ID
Wallet actions
Get wallet action by external ID
Look up a wallet action by reference_id across every wallet in the app. Returns an empty list if no action matches. Use ?include=steps to include step-level details.
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.
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
Basic Auth header with your app ID as the username and your app secret as the password.
Headers
ID of your Privy app.
Query Parameters
Developer-provided reference ID to look the wallet action up by.
Required string length:
1 - 64Include 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.
- SwapActionResponse
- TransferActionResponse
- EarnDepositActionResponse
- EarnWithdrawActionResponse
- EarnIncentiveClaimActionResponse
- EarnFeeCollectActionResponse
- PayoutResponse

