Actions

Get wallet action by reference ID

Changed on Oct 20, 2026

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/v1/actions

Request

Base URL
https://api.privy.io
URL
https://api.privy.io/v1/actions
Auth
HTTP basic

Query parameters

reference_idstring required

Developer-provided reference ID to look the wallet action up by.

include'steps'

Include step-level details in the response.

Headers

privy-app-idstring required

ID of your Privy app.

Response

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

Example response

{
  "actions": [
    {
      "steps": [
        {
          "gas_credits_charged": {
            "value": "100.00",
            "currency": "usd"
          }
        }
      ],
      "estimated_fees": [
        {
          "type": "relayer",
          "recipient": "0x1234567890abcdef1234567890abcdef12345678",
          "amount": "0.20"
        }
      ],
      "estimated_gas": {
        "base_amount": "100000000000000",
        "amount": "0.0001",
        "gas_asset": "ETH"
      },
      "fees": [
        {
          "type": "relayer",
          "recipient": "0x1234567890abcdef1234567890abcdef12345678",
          "amount": "0.20"
        }
      ],
      "gas": {
        "base_amount": "100000000000000",
        "amount": "0.0001",
        "gas_asset": "ETH"
      }
    }
  ]
}

Changes

Oct 20, 2026527110c2c2f4 Revision changes
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  response property actions/items/oneOf[subschema #1: SwapActionResponse]/steps/items/oneOf[subschema #1: EVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #1: SwapActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #1: SwapActionResponse]/steps/items/oneOf[subschema #3: SVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #1: SwapActionResponse]/steps/items/oneOf[subschema #4: TVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #2: TransferActionResponse]/steps/items/oneOf[subschema #1: EVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #2: TransferActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #2: TransferActionResponse]/steps/items/oneOf[subschema #3: SVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #2: TransferActionResponse]/steps/items/oneOf[subschema #4: TVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #3: EarnDepositActionResponse]/steps/items/oneOf[subschema #1: EVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #3: EarnDepositActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #3: EarnDepositActionResponse]/steps/items/oneOf[subschema #3: SVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #3: EarnDepositActionResponse]/steps/items/oneOf[subschema #4: TVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #4: EarnWithdrawActionResponse]/steps/items/oneOf[subschema #1: EVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #4: EarnWithdrawActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #4: EarnWithdrawActionResponse]/steps/items/oneOf[subschema #3: SVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #4: EarnWithdrawActionResponse]/steps/items/oneOf[subschema #4: TVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #5: EarnIncentiveClaimActionResponse]/steps/items/oneOf[subschema #1: EVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #5: EarnIncentiveClaimActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #5: EarnIncentiveClaimActionResponse]/steps/items/oneOf[subschema #3: SVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #5: EarnIncentiveClaimActionResponse]/steps/items/oneOf[subschema #4: TVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #6: EarnFeeCollectActionResponse]/steps/items/oneOf[subschema #1: EVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #6: EarnFeeCollectActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #6: EarnFeeCollectActionResponse]/steps/items/oneOf[subschema #3: SVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #6: EarnFeeCollectActionResponse]/steps/items/oneOf[subschema #4: TVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #7: PayoutResponse]/steps/items/oneOf[subschema #1: EVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #7: PayoutResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #7: PayoutResponse]/steps/items/oneOf[subschema #3: SVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property actions/items/oneOf[subschema #7: PayoutResponse]/steps/items/oneOf[subschema #4: TVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
Oct 19, 2026a77e516e7c57 Revision changes
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status

Operation history (3 revisions)