Wallet Actions

Get wallet action

Changed on Oct 20, 2026

Get the current status of a wallet action by its ID. Use ?include=steps to include step-level details.

get/v1/wallets/{wallet_id}/actions/{action_id}

Request

Base URL
https://api.privy.io
URL
https://api.privy.io/v1/wallets/{wallet_id}/actions/{action_id}
Auth
HTTP basic

Path parameters

wallet_idstring required

ID of the wallet.

action_idstring uuid required

ID of the wallet action.

Query parameters

include'steps'

Include step-level details in the response.

Headers

privy-app-idstring required

ID of your Privy app.

privy-authorization-signaturestring

Request authorization signature. If multiple signatures are required, they should be comma separated.

Response

The wallet action with its current status.

Example response

{
  "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 oneOf[subschema #1: SwapActionResponse]/steps/items/oneOf[subschema #1: EVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #1: SwapActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #1: SwapActionResponse]/steps/items/oneOf[subschema #3: SVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #1: SwapActionResponse]/steps/items/oneOf[subschema #4: TVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #2: TransferActionResponse]/steps/items/oneOf[subschema #1: EVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #2: TransferActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #2: TransferActionResponse]/steps/items/oneOf[subschema #3: SVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #2: TransferActionResponse]/steps/items/oneOf[subschema #4: TVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #3: EarnDepositActionResponse]/steps/items/oneOf[subschema #1: EVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #3: EarnDepositActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #3: EarnDepositActionResponse]/steps/items/oneOf[subschema #3: SVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #3: EarnDepositActionResponse]/steps/items/oneOf[subschema #4: TVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #4: EarnWithdrawActionResponse]/steps/items/oneOf[subschema #1: EVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #4: EarnWithdrawActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #4: EarnWithdrawActionResponse]/steps/items/oneOf[subschema #3: SVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #4: EarnWithdrawActionResponse]/steps/items/oneOf[subschema #4: TVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #5: EarnIncentiveClaimActionResponse]/steps/items/oneOf[subschema #1: EVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #5: EarnIncentiveClaimActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #5: EarnIncentiveClaimActionResponse]/steps/items/oneOf[subschema #3: SVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #5: EarnIncentiveClaimActionResponse]/steps/items/oneOf[subschema #4: TVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #6: EarnFeeCollectActionResponse]/steps/items/oneOf[subschema #1: EVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #6: EarnFeeCollectActionResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #6: EarnFeeCollectActionResponse]/steps/items/oneOf[subschema #3: SVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #6: EarnFeeCollectActionResponse]/steps/items/oneOf[subschema #4: TVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #7: PayoutResponse]/steps/items/oneOf[subschema #1: EVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #7: PayoutResponse]/steps/items/oneOf[subschema #2: EVMUserOperationWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property oneOf[subschema #7: PayoutResponse]/steps/items/oneOf[subschema #3: SVMTransactionWalletActionStep]/gas_credits_charged_usd deprecated
- info
  response property 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 (14 revisions)