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": [
              {
                "type": "error",
                "inputs": [
                  "<any>"
                ],
                "name": "<string>"
              }
            ],
            "args": [
              "<any>"
            ],
            "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>",
          "paymaster": "<string>",
          "paymasterVerificationGasLimit": "<string>",
          "paymasterData": "<string>",
          "paymasterPostOpGasLimit": "<string>",
          "signature": "<string>",
          "factory": "<string>",
          "factoryData": "<string>"
        },
        "userOperationHash": "<string>",
        "txId": "<string>",
        "explorerLink": "<string>"
      },
      "id": "<string>",
      "status": "awaiting-approval",
      "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
      },
      "createdAt": "2024-01-01T00:00:00.000Z",
      "completedAt": "2024-01-01T00:00:00.000Z",
      "error": {
        "reason": "build_failed",
        "message": "<string>"
      },
      "sendParams": {
        "token": "<string>",
        "params": {
          "amount": "<string>",
          "recipient": "<string>",
          "recipientAddress": "<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>] (walletType defaults to 'smart')
  • userId:<userId>:<chainType>[:<walletType>] (white label user example)
  • phoneNumber:<phoneNumber>:<chainType>[:<walletType>]
  • twitter:<handle>:<chainType>[:<walletType>]
  • x:<handle>:<chainType>[:<walletType>]
  • me:<chainType>[:<walletType>] (Use when calling from the client side with a client API key)

Query Parameters

page
string
default:1
perPage
string
default:10

Response

200
application/json

The transactions have been successfully retrieved.

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