Introduction
Concepts
Guides
API Reference
- Introduction
- POSTCreate Wallet
- GETGet Wallet By Locator
- GETGet Wallet Balance
- POSTFund Wallet
- GETGet NFTs from Wallet
- POSTCreate Transaction
- GETGet Transaction
- GETGet Wallet Transactions
- POSTApprove Transaction
- POSTCreate Signature
- GETGet All Signatures
- GETGet Signature
- POSTApprove Signature
- POSTCreate Delegated Signer
- GETGet Delegated Signer
- POSTTransfer Token
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"
}
]
}Get All Signatures
Retrieves all signatures associated with the specified wallet.
API scope required: wallets:signatures.read
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
API key required for authentication
Path Parameters
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>
Response
The signatures have been successfully retrieved.
List of signatures with their status, signing requirements, and wallet type specific data
Show child attributes
Show child attributes
Unique identifier for the signature
The type of signature
message, typed-data The blockchain type of the wallet
evm, solana, aptos, sui, stellar The wallet type (smart or mpc)
smart, mpc Current status of the signature
awaiting-approval, pending, failed, success Type-specific signature parameters
- Message signature parameters
- Typed data signature parameters
Show child attributes
Show child attributes
The message in plain text to sign
The full signer object who will submit this signature. Defaults to the wallet's admin signer.
- External Wallet Signer
- Passkey Signer
- API Key Signer
- Device Signer
- Option 5
- Option 6
The chain on which the signature will be submitted
arbitrum-sepolia, arc-testnet, avalanche-fuji, curtis, base-goerli, base-sepolia, bsc-testnet, chiliz-spicy-testnet, coti-testnet, ethereum-goerli, ethereum-sepolia, hedera-testnet, hypersonic-testnet, lightlink-pegasus, mantle-sepolia, 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, u2u-nebulas, zenchain-testnet, abstract-testnet, world-chain-sepolia, plume-testnet, flow-testnet, ethereum, polygon, bsc, optimism, arbitrum, base, zora, arbitrumnova, astar-zkevm, apechain, hedera, coti, lightlink, mantle, skale-nebula, sei-pacific-1, chiliz, avalanche, xai, shape, rari, scroll, viction, mode, space, soneium, story, u2u-solaris, abstract, world-chain, plume, flow ISO timestamp when the signature was created
"2024-01-01T00:00:00.000Z"
Complete approval data including requirements, pending and submitted signatures
Show child attributes
Show child attributes
List of pending signatures
Show child attributes
Show child attributes
The full signer object that's pending approval
- External Wallet Signer
- Passkey Signer
- API Key Signer
- Device Signer
- Option 5
- Option 6
Show child attributes
Show child attributes
The message that needs to be signed
Record of all submitted signatures
Show child attributes
Show child attributes
The cryptographic signature
When the signature was submitted
"2024-01-01T00:00:00.000Z"
The full signer object who submitted this signature
- External Wallet Signer
- Passkey Signer
- API Key Signer
- Device Signer
- Option 5
- Option 6
Show child attributes
Show child attributes
The message that was signed
Number of required approvals for the transaction
ISO timestamp when the transaction reached finality
"2024-01-01T00:00:00.000Z"
Error message if the signature fails
The wallet's output signature of the request
Was this page helpful?