Get All Signatures

Retrieves all signatures associated with the specified wallet.

API scope required: wallets:signatures.read

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>:<walletType>
• userId:<userId>:<walletType>
• userId:<userId>:<walletType> (white label user example)
• phoneNumber:<phoneNumber>:<walletType>
• twitter:<handle>:<walletType>
• x:<handle>:<walletType>

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

signatures

object[]

required

Show child attributes

signatures.id

string

required

Unique identifier for the signature

signatures.type

enum<string>

required

The type of signature

Available options:

evm-message,

solana-message,

evm-typed-data,

aptos-message,

cardano-message,

sui-message

signatures.status

enum<string>

required

Current status of the signature

Available options:

awaiting-approval,

pending,

failed,

success

signatures.params

object

required

Type-specific signature parameters

• EVM message signature parameters
• Solana message signature parameters
• EVM typed data signature parameters

Show child attributes

signatures.params.message

string

required

The message in plain text to sign

signatures.params.chain

enum<string>

required

The chain on which the signature will be submitted

Available options:

arbitrum-sepolia,

avalanche-fuji,

curtis,

barret-testnet,

base-goerli,

base-sepolia,

bsc-testnet,

chiliz-spicy-testnet,

ethereum-goerli,

ethereum-sepolia,

hypersonic-testnet,

lightlink-pegasus,

optimism-goerli,

optimism-sepolia,

polygon-amoy,

polygon-mumbai,

crossmint-private-testnet-ethereum,

crossmint-private-testnet-polygon,

rari-testnet,

scroll-sepolia,

sei-atlantic-2-testnet,

shape-sepolia,

skale-nebula-testnet,

soneium-minato-testnet,

space-testnet,

story-testnet,

verify-testnet,

viction-testnet,

xai-sepolia-testnet,

zkatana,

zkyoto,

zora-goerli,

zora-sepolia,

mode-sepolia,

zenchain-testnet,

ethereum,

polygon,

bsc,

optimism,

arbitrum,

base,

zora,

arbitrumnova,

astar-zkevm,

apechain,

apex,

boss,

lightlink,

skale-nebula,

sei-pacific-1,

chiliz,

avalanche,

xai,

shape,

rari,

scroll,

viction,

mode,

space,

soneium,

story

signatures.params.signer

string

The locator for the signer who will submit this signature. Defaults to the wallet's admin signer.

signatures.createdAt

number

required

ISO timestamp when the signature was created

signatures.approvals

object

Complete approval data including requirements, pending and submitted signatures

Show child attributes

signatures.approvals.pending

object[]

required

List of pending signatures

Show child attributes

signatures.approvals.pending.signer

string

required

The locator of the signer that's pending approval

signatures.approvals.pending.message

string

required

The message that needs to be signed

signatures.approvals.submitted

object[]

required

Record of all submitted signatures

Show child attributes

signatures.approvals.submitted.signature

string

required

The cryptographic signature

signatures.approvals.submitted.submittedAt

number

required

When the signature was submitted

signatures.approvals.submitted.signer

string

required

The locator of the signer who submitted this signature

signatures.approvals.submitted.message

string

required

The message that was signed

signatures.approvals.submitted.metadata

object

Additional metadata about the signature submission

Show child attributes

signatures.approvals.submitted.metadata.deviceInfo

string

signatures.approvals.submitted.metadata.ipAddress

string

signatures.approvals.submitted.metadata.userAgent

string

signatures.approvals.required

number

Number of required approvals for the transaction

signatures.completedAt

number

ISO timestamp when the transaction reached finality

signatures.error

any

Error message if the signature fails

signatures.outputSignature

string

The wallet's output signature of the request