Skip to main content
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": "<string>",
      "params": {
        "message": "<string>",
        "signer": {
          "address": "<string>",
          "locator": "<string>"
        }
      },
      "createdAt": 123,
      "approvals": {
        "pending": [
          {
            "signer": {
              "address": "<string>",
              "locator": "<string>"
            },
            "message": "<string>"
          }
        ],
        "submitted": [
          {
            "signature": "<string>",
            "submittedAt": 123,
            "signer": {
              "address": "<string>",
              "locator": "<string>"
            },
            "message": "<string>",
            "metadata": {
              "deviceInfo": "<string>",
              "ipAddress": "<string>",
              "userAgent": "<string>"
            }
          }
        ],
        "required": 123
      },
      "completedAt": 123,
      "error": "<unknown>",
      "outputSignature": "<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
Pattern: ^[1-9]\d*$
​
perPage
string
Pattern: ^[1-9]\d*$

Response

The signatures have been successfully retrieved.

​
signatures
object[]
required