GET
/
2025-06-09
/
wallets
/
{walletLocator}
/
signatures
Get All Signatures
curl --request GET \
  --url https://staging.crossmint.com/api/2025-06-09/wallets/{walletLocator}/signatures \
  --header 'X-API-KEY: <x-api-key>'
{
  "signatures": [
    {
      "id": "sig-b984491a-5785-43c0-8811-45d46fe6e520",
      "type": "message",
      "chainType": "evm",
      "walletType": "smart",
      "status": "awaiting-approval",
      "params": {
        "message": "Hello, world!",
        "signer": {
          "type": "external-wallet",
          "address": "0xB17Ea8d34078424B9d7D126E444d5F2C3CC5c81E",
          "locator": "external-wallet:0xB17Ea8d34078424B9d7D126E444d5F2C3CC5c81E"
        },
        "chain": "polygon"
      },
      "approvals": {
        "pending": [
          {
            "signer": {
              "type": "external-wallet",
              "address": "0xB17Ea8d34078424B9d7D126E444d5F2C3CC5c81E",
              "locator": "external-wallet:0xB17Ea8d34078424B9d7D126E444d5F2C3CC5c81E"
            },
            "message": "Hello world!"
          }
        ],
        "submitted": []
      },
      "createdAt": "2024-01-01T00:00:00Z"
    }
  ]
}

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 signatures have been successfully retrieved.

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