--- title: "Get Wallet By Locator" method: GET path: "/2025-06-09/wallets/{walletLocator}" --- # Get Wallet By Locator `GET /2025-06-09/wallets/{walletLocator}` Retrieves a wallet by its locator (address or user identifier and wallet type) **API scope required**: `wallets.read` ## Path parameters - `walletLocator` string, required ## Headers - `X-API-KEY` string, required ## Response `200` The record has been successfully retreived. - union - object - `chainType` 'evm', required — The blockchain type of the wallet - `type` 'smart' | 'mpc', required — The wallet type (smart or mpc) - `config` object — EVM wallet type specific configuration settings - `adminSigner` union, required - object — Configuration for an external wallet signer - `type` 'external-wallet', required — Identifier for external wallet signer type - `address` string, required — The blockchain address of the external wallet - `locator` string, required — The locator of the signer - object — Configuration for a server signer - `type` 'server', required — Identifier for server signer type - `address` string, required — The blockchain address of the server signer - `locator` string, required — The locator of the signer - object — Configuration for a custodial signer managed by Crossmint. Contact sales (https://www.crossmint.com/contact/sales) for access. - `type` 'api-key', required — Identifier for API key signer type - `address` union, required — The blockchain address of the custodial signer - string — The recipient address for this transaction call - string — The Solana address of the signer - string - `locator` string, required — The locator of the signer - object — Response schema for a registered Passkey signer including validator contract details - `type` 'passkey', required — Identifier for the Passkey signer type - `id` string, required — Credential ID from the WebAuthn registration response - `name` string, required — Human-readable name for the passkey - `publicKey` object, required — The public key coordinates from the WebAuthn credential - `x` string, required — S component of the signature as a stringified bigint - `y` string, required — S component of the signature as a stringified bigint - `validatorContractVersion` string, required — ERC-7579 webAuthn validator contract version - `locator` string, required — Unique identifier for locating this passkey signer - object — Configuration for an email signer - `type` 'email', required — Identifier for email signer type - `email` string, required — The email address for the signer - `locator` string, required — The locator of the signer - `address` union, required — The address of the signer - string — The recipient address for this transaction call - string - object — Configuration for a phone signer - `type` 'phone', required — Identifier for phone signer type - `phone` string, required — The phone number for the signer in E164 format - `locator` string, required — The locator of the signer - `address` union, required — The address of the signer - string — The recipient address for this transaction call - string - `delegatedSigners` union[] — Optional array of additional signers for the wallet - union - object — Configuration for an external wallet signer - `type` 'external-wallet', required — Identifier for external wallet signer type - `address` string, required — The blockchain address of the external wallet - `locator` string, required — The locator of the signer - `scopes` unknown[] — Permission scopes granted to this delegated signer - … - `expiresAt` string — ISO timestamp of when the delegated signer expires - `chains` object — Per-chain configuration for the delegated signer - object — Configuration for a server signer - `type` 'server', required — Identifier for server signer type - `address` string, required — The blockchain address of the server signer - `locator` string, required — The locator of the signer - `scopes` unknown[] — Permission scopes granted to this delegated signer - … - `expiresAt` string — ISO timestamp of when the delegated signer expires - `chains` object — Per-chain configuration for the delegated signer - object — Configuration for a custodial signer managed by Crossmint. Contact sales (https://www.crossmint.com/contact/sales) for access. - `type` 'api-key', required — Identifier for API key signer type - `address` union, required — The blockchain address of the custodial signer - … - `locator` string, required — The locator of the signer - `scopes` unknown[] — Permission scopes granted to this delegated signer - … - `expiresAt` string — ISO timestamp of when the delegated signer expires - `chains` object — Per-chain configuration for the delegated signer - object — Response schema for a registered Passkey signer including validator contract details - `type` 'passkey', required — Identifier for the Passkey signer type - `id` string, required — Credential ID from the WebAuthn registration response - `name` string, required — Human-readable name for the passkey - `publicKey` object, required — The public key coordinates from the WebAuthn credential - … - `validatorContractVersion` string, required — ERC-7579 webAuthn validator contract version - `locator` string, required — Unique identifier for locating this passkey signer - `scopes` unknown[] — Permission scopes granted to this delegated signer - … - `expiresAt` string — ISO timestamp of when the delegated signer expires - `chains` object — Per-chain configuration for the delegated signer - object — Configuration for an email signer - `type` 'email', required — Identifier for email signer type - `email` string, required — The email address for the signer - `locator` string, required — The locator of the signer - `address` union, required — The address of the signer - … - `scopes` unknown[] — Permission scopes granted to this delegated signer - … - `expiresAt` string — ISO timestamp of when the delegated signer expires - `chains` object — Per-chain configuration for the delegated signer - object — Configuration for a phone signer - `type` 'phone', required — Identifier for phone signer type - `phone` string, required — The phone number for the signer in E164 format - `locator` string, required — The locator of the signer - `address` union, required — The address of the signer - … - `scopes` unknown[] — Permission scopes granted to this delegated signer - … - `expiresAt` string — ISO timestamp of when the delegated signer expires - `chains` object — Per-chain configuration for the delegated signer - object — Configuration for a device signer - `type` 'device', required — Identifier for device signer type - `publicKey` object, required — The p256 public key of the device signer - … - `locator` string, required — The locator of the signer - `name` string — Optional human-readable name for the device signer - `scopes` unknown[] — Permission scopes granted to this delegated signer - … - `expiresAt` string — ISO timestamp of when the delegated signer expires - `chains` object — Per-chain configuration for the delegated signer - `address` string, required — The onchain address of the wallet - `owner` string — The user that owns this wallet in format : - `createdAt` union — ISO timestamp of when the wallet was created - number — ISO timestamp when the signature was created - string - `alias` string — The wallet alias - object - `chainType` 'solana', required — The blockchain type of the wallet - `type` 'smart' | 'mpc', required — The wallet type (smart or mpc) - `config` object — Solana wallet type specific configuration settings - `adminSigner` union, required - object — Configuration for an external wallet signer - `type` 'external-wallet', required — Identifier for external wallet signer type - `address` string, required — The blockchain address of the external wallet - `locator` string, required — The locator of the signer - object — Configuration for a server signer - `type` 'server', required — Identifier for server signer type - `address` string, required — The blockchain address of the server signer - `locator` string, required — The locator of the signer - object — Configuration for a custodial signer managed by Crossmint. Contact sales (https://www.crossmint.com/contact/sales) for access. - `type` 'api-key', required — Identifier for API key signer type - `address` union, required — The blockchain address of the custodial signer - string — The recipient address for this transaction call - string — The Solana address of the signer - string - `locator` string, required — The locator of the signer - object — Configuration for an email signer - `type` 'email', required — Identifier for email signer type - `email` string, required — The email address for the signer - `locator` string, required — The locator of the signer - `address` union, required — The address of the signer - string — The recipient address for this transaction call - string - object — Configuration for a phone signer - `type` 'phone', required — Identifier for phone signer type - `phone` string, required — The phone number for the signer in E164 format - `locator` string, required — The locator of the signer - `address` union, required — The address of the signer - string — The recipient address for this transaction call - string - object — Quorum (m-of-n multisig) admin signer - `type` 'quorum', required - `threshold` integer, required - `locator` string, required — The locator of the quorum signer (read-only, derived from threshold + members) - `signers` union[], required - union - … - `delegatedSigners` union[] — Optional array of additional signers for the wallet - union - object — Complete delegated signer response including the signer and authorization transaction - `type` 'passkey', required — Identifier for the Passkey signer type - `id` string, required — Credential ID from the WebAuthn registration response - `name` string, required — Human-readable name for the passkey - `publicKey` object, required — The public key coordinates from the WebAuthn credential - … - `validatorContractVersion` string, required — ERC-7579 webAuthn validator contract version - `locator` string, required — Unique identifier for locating this passkey signer - `scopes` object[] — Optional array of scopes restricting the signer's capabilities - … - `expiresAt` union — The expiry date of the signer in ISO 8601 format - … - `transaction` object — The transaction for the signer - … - object — Complete delegated signer response including the signer and authorization transaction - `type` 'api-key', required — Identifier for API key signer type - `address` union, required — The blockchain address of the custodial signer - … - `locator` string, required — The locator of the signer - `scopes` object[] — Optional array of scopes restricting the signer's capabilities - … - `expiresAt` union — The expiry date of the signer in ISO 8601 format - … - `transaction` object — The transaction for the signer - … - object — Complete delegated signer response including the signer and authorization transaction - `type` 'external-wallet', required — Identifier for external wallet signer type - `address` string, required — The blockchain address of the external wallet - `locator` string, required — The locator of the signer - `scopes` object[] — Optional array of scopes restricting the signer's capabilities - … - `expiresAt` union — The expiry date of the signer in ISO 8601 format - … - `transaction` object — The transaction for the signer - … - object — Complete delegated signer response including the signer and authorization transaction - `type` 'server', required — Identifier for server signer type - `address` string, required — The blockchain address of the server signer - `locator` string, required — The locator of the signer - `scopes` object[] — Optional array of scopes restricting the signer's capabilities - … - `expiresAt` union — The expiry date of the signer in ISO 8601 format - … - `transaction` object — The transaction for the signer - … - object — Complete delegated signer response including the signer and authorization transaction - `type` 'email', required — Identifier for email signer type - `email` string, required — The email address for the signer - `locator` string, required — The locator of the signer - `address` union, required — The address of the signer - … - `scopes` object[] — Optional array of scopes restricting the signer's capabilities - … - `expiresAt` union — The expiry date of the signer in ISO 8601 format - … - `transaction` object — The transaction for the signer - … - object — Complete delegated signer response including the signer and authorization transaction - `type` 'phone', required — Identifier for phone signer type - `phone` string, required — The phone number for the signer in E164 format - `locator` string, required — The locator of the signer - `address` union, required — The address of the signer - … - `scopes` object[] — Optional array of scopes restricting the signer's capabilities - … - `expiresAt` union — The expiry date of the signer in ISO 8601 format - … - `transaction` object — The transaction for the signer - … - object — Complete delegated signer response including the signer and authorization transaction - `type` 'device', required — Identifier for device signer type - `publicKey` object, required — The p256 public key of the device signer - … - `locator` string, required — The locator of the signer - `name` string — Optional human-readable name for the device signer - `scopes` object[] — Optional array of scopes restricting the signer's capabilities - … - `expiresAt` union — The expiry date of the signer in ISO 8601 format - … - `transaction` object — The transaction for the signer - … - `address` string, required — The onchain address of the wallet - `owner` string — The user that owns this wallet in format : - `createdAt` union — ISO timestamp of when the wallet was created - number — ISO timestamp when the signature was created - string - `alias` string — The wallet alias - object - `chainType` 'aptos', required — The blockchain type of the wallet - `type` 'smart' | 'mpc', required — The wallet type (smart or mpc) - `config` unknown - `address` string, required — The onchain address of the wallet - `owner` string — The user that owns this wallet in format : - `createdAt` union — ISO timestamp of when the wallet was created - number — ISO timestamp when the signature was created - string - `alias` string — The wallet alias - object - `chainType` 'sui', required — The blockchain type of the wallet - `type` 'smart' | 'mpc', required — The wallet type (smart or mpc) - `config` unknown - `address` string, required — The onchain address of the wallet - `owner` string — The user that owns this wallet in format : - `createdAt` union — ISO timestamp of when the wallet was created - number — ISO timestamp when the signature was created - string - `alias` string — The wallet alias - object - `chainType` 'stellar', required — The blockchain type of the wallet - `type` 'smart' | 'mpc', required — The wallet type (smart or mpc) - `config` object — Stellar wallet type specific configuration settings - `adminSigner` union, required - object — Configuration for an external wallet signer - `type` 'external-wallet', required — Identifier for external wallet signer type - `address` string, required — The blockchain address of the external wallet - `locator` string, required — The locator of the signer - object — Configuration for a server signer - `type` 'server', required — Identifier for server signer type - `address` string, required — The blockchain address of the server signer - `locator` string, required — The locator of the signer - object — Configuration for an email signer - `type` 'email', required — Identifier for email signer type - `email` string, required — The email address for the signer - `locator` string, required — The locator of the signer - `address` union, required — The address of the signer - string — The recipient address for this transaction call - string - object — Configuration for a phone signer - `type` 'phone', required — Identifier for phone signer type - `phone` string, required — The phone number for the signer in E164 format - `locator` string, required — The locator of the signer - `address` union, required — The address of the signer - string — The recipient address for this transaction call - string - object — Configuration for a custodial signer managed by Crossmint. Contact sales (https://www.crossmint.com/contact/sales) for access. - `type` 'api-key', required — Identifier for API key signer type - `address` union, required — The blockchain address of the custodial signer - string — The recipient address for this transaction call - string — The Solana address of the signer - string - `locator` string, required — The locator of the signer - object — Quorum (m-of-n multisig) admin signer - `type` 'quorum', required - `threshold` integer, required - `locator` string, required — The locator of the quorum signer (read-only, derived from threshold + members) - `signers` union[], required - union - … - `delegatedSigners` union[] — Optional array of additional signers for the wallet - union - object — Complete delegated signer response including the signer and authorization transaction - `type` 'passkey', required — Identifier for the Passkey signer type - `id` string, required — Credential ID from the WebAuthn registration response - `name` string, required — Human-readable name for the passkey - `publicKey` object, required — The public key coordinates from the WebAuthn credential - … - `validatorContractVersion` string, required — ERC-7579 webAuthn validator contract version - `locator` string, required — Unique identifier for locating this passkey signer - `scopes` object[] — Optional array of scopes restricting the signer's capabilities - … - `expiresAt` union — The expiry date of the signer in ISO 8601 format - … - `transaction` object — The transaction for the signer - … - object — Complete delegated signer response including the signer and authorization transaction - `type` 'api-key', required — Identifier for API key signer type - `address` union, required — The blockchain address of the custodial signer - … - `locator` string, required — The locator of the signer - `scopes` object[] — Optional array of scopes restricting the signer's capabilities - … - `expiresAt` union — The expiry date of the signer in ISO 8601 format - … - `transaction` object — The transaction for the signer - … - object — Complete delegated signer response including the signer and authorization transaction - `type` 'external-wallet', required — Identifier for external wallet signer type - `address` string, required — The blockchain address of the external wallet - `locator` string, required — The locator of the signer - `scopes` object[] — Optional array of scopes restricting the signer's capabilities - … - `expiresAt` union — The expiry date of the signer in ISO 8601 format - … - `transaction` object — The transaction for the signer - … - object — Complete delegated signer response including the signer and authorization transaction - `type` 'server', required — Identifier for server signer type - `address` string, required — The blockchain address of the server signer - `locator` string, required — The locator of the signer - `scopes` object[] — Optional array of scopes restricting the signer's capabilities - … - `expiresAt` union — The expiry date of the signer in ISO 8601 format - … - `transaction` object — The transaction for the signer - … - object — Complete delegated signer response including the signer and authorization transaction - `type` 'email', required — Identifier for email signer type - `email` string, required — The email address for the signer - `locator` string, required — The locator of the signer - `address` union, required — The address of the signer - … - `scopes` object[] — Optional array of scopes restricting the signer's capabilities - … - `expiresAt` union — The expiry date of the signer in ISO 8601 format - … - `transaction` object — The transaction for the signer - … - object — Complete delegated signer response including the signer and authorization transaction - `type` 'phone', required — Identifier for phone signer type - `phone` string, required — The phone number for the signer in E164 format - `locator` string, required — The locator of the signer - `address` union, required — The address of the signer - … - `scopes` object[] — Optional array of scopes restricting the signer's capabilities - … - `expiresAt` union — The expiry date of the signer in ISO 8601 format - … - `transaction` object — The transaction for the signer - … - object — Complete delegated signer response including the signer and authorization transaction - `type` 'device', required — Identifier for device signer type - `publicKey` object, required — The p256 public key of the device signer - … - `locator` string, required — The locator of the signer - `name` string — Optional human-readable name for the device signer - `scopes` object[] — Optional array of scopes restricting the signer's capabilities - … - `expiresAt` union — The expiry date of the signer in ISO 8601 format - … - `transaction` object — The transaction for the signer - … - `plugins` string[] — Optional array of plugins used for the wallet - `address` string, required — The onchain address of the wallet - `owner` string — The user that owns this wallet in format : - `createdAt` union — ISO timestamp of when the wallet was created - number — ISO timestamp when the signature was created - string - `alias` string — The wallet alias ## Other responses - `404` — Returns an error if a wallet with the specified locator not found --- [API](https://skmtc.net/crossmint/apis/onramp.md) · [All operations](https://skmtc.net/crossmint/apis/onramp/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crossmint/onramp/revisions/e2143d192130/schema)