Skip to main content
GET
/
2025-06-09
/
wallets
/
{walletLocator}
/
transactions
Get Wallet Transactions
curl --request GET \
  --url https://staging.crossmint.com/api/2025-06-09/wallets/{walletLocator}/transactions \
  --header 'X-API-KEY: <x-api-key>'
{
  "transactions": [
    {
      "chainType": "evm",
      "walletType": "smart",
      "params": {
        "calls": [
          {
            "address": "<string>",
            "functionName": "<string>",
            "abi": [
              "<unknown>"
            ],
            "args": [
              "<unknown>"
            ],
            "value": "0"
          }
        ],
        "chain": "abstract",
        "signer": {
          "type": "external-wallet",
          "address": "<string>",
          "locator": "<string>"
        }
      },
      "onChain": {
        "userOperation": {
          "sender": "<string>",
          "nonce": "<string>",
          "callData": "<string>",
          "callGasLimit": "<string>",
          "verificationGasLimit": "<string>",
          "preVerificationGas": "<string>",
          "maxFeePerGas": "<string>",
          "maxPriorityFeePerGas": "<string>",
          "signature": "<string>",
          "paymaster": "<string>",
          "paymasterVerificationGasLimit": "<string>",
          "paymasterData": "<string>",
          "paymasterPostOpGasLimit": "<string>",
          "factory": "<string>",
          "factoryData": "<string>"
        },
        "userOperationHash": "<string>",
        "txId": "<string>",
        "explorerLink": "<string>"
      },
      "id": "<string>",
      "status": "awaiting-approval",
      "createdAt": "2024-01-01T00:00:00.000Z",
      "approvals": {
        "pending": [
          {
            "signer": {
              "type": "external-wallet",
              "address": "<string>",
              "locator": "<string>"
            },
            "message": "<string>"
          }
        ],
        "submitted": [
          {
            "signature": "<string>",
            "submittedAt": "2024-01-01T00:00:00.000Z",
            "signer": {
              "type": "external-wallet",
              "address": "<string>",
              "locator": "<string>"
            },
            "message": "<string>",
            "metadata": {
              "deviceInfo": "<string>",
              "ipAddress": "<string>",
              "userAgent": "<string>"
            }
          }
        ],
        "required": 123
      },
      "completedAt": "2024-01-01T00:00:00.000Z",
      "error": {
        "reason": "build_failed",
        "message": "<string>"
      },
      "sendParams": {
        "token": "<string>",
        "params": {
          "recipient": "<string>",
          "recipientAddress": "<string>",
          "amount": "<string>"
        }
      }
    }
  ]
}

Headers

​
X-API-KEY
string
required

API key required for authentication

Path Parameters

​
walletLocator
string
required

A wallet locator can be of the format:

  • <walletAddress>
  • email:<email>:<chainType>[:<walletType>][:alias:<alias>] (walletType defaults to 'smart')
  • userId:<userId>:<chainType>[:<walletType>][:alias:<alias>] (white label user example)
  • phoneNumber:<phoneNumber>:<chainType>[:<walletType>][:alias:<alias>]
  • twitter:<handle>:<chainType>[:<walletType>][:alias:<alias>]
  • x:<handle>:<chainType>[:<walletType>][:alias:<alias>]
  • me:<chainType>[:<walletType>][:alias:<alias>] (Use when calling from the client side with a client API key)
  • chainType[:<walletType>]:alias:<alias>

Query Parameters

​
page
string
default:1
​
perPage
string
default:10
​
dateFrom
string<date-time>
​
dateTo
string<date-time>

Response

The transactions have been successfully retrieved.

List of transactions with their status, signing requirements, and wallet type specific data

​
transactions
(EVM Smart Wallet · object | EVM MPC Wallet · object | Solana Smart Wallet · object | Solana MPC Wallet · object | Stellar Smart Wallet · object)[]
required

Complete transaction response including status, signing requirements, and wallet type specific data