Skip to main content
GET
/
ramp
/
wallet
/
{wallet_id}
Get wallet details
curl --request GET \
  --url https://api.etherfuse.com/ramp/wallet/{wallet_id} \
  --header 'Authorization: <api-key>'
{
  "walletId": "123e4567-e89b-12d3-a456-426614174000",
  "customerId": "123e4567-e89b-12d3-a456-426614174001",
  "createdAt": "2024-01-01T00:00:00Z",
  "updatedAt": "2024-01-01T00:00:00Z",
  "publicKey": "9Qx7r...",
  "blockchain": "solana",
  "isAuthenticated": true,
  "kycStatus": "approved",
  "kycOnChain": true,
  "claimedOwnership": true
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Pass the key directly (e.g., Authorization: your-api-key). Do not use a Bearer prefix.

Path Parameters

​
wallet_id
string<uuid>
required

ID of the wallet to retrieve

Response

Wallet details retrieved successfully

​
walletId
string<uuid>

Unique identifier for the wallet

​
customerId
string<uuid>

ID of the customer who owns this wallet

​
createdAt
string<date-time>

Timestamp when the wallet was created

​
updatedAt
string<date-time>

Timestamp when the wallet was last updated

​
deletedAt
string<date-time> | null

Timestamp when the wallet was deleted (if applicable)

​
displayName
string | null

Display name for the wallet

​
publicKey
string

Public key of the wallet

​
blockchain
enum<string>

Blockchain type

Available options:
solana,
stellar,
base,
polygon,
monad
​
isAuthenticated
boolean

Whether the wallet is authenticated

​
kycStatus
enum<string> | null

Current KYC verification status for the wallet. The approved_chain_deploying status indicates the user is approved but waiting for on-chain marking (Solana only).

Available options:
not_started,
proposed,
approved,
approved_chain_deploying,
rejected
​
kycOnChain
boolean | null

Whether KYC is marked on-chain for the wallet. Only present for Solana wallets; for other blockchain types this field is omitted as on-chain KYC marking does not apply.

​
claimedOwnership
boolean | null

Whether the wallet has active claimed ownership by the organization. When true and the organization is approved, the wallet is treated as compliant without requiring individual KYC. Only present when claimed ownership has been set.