Skip to main content
Use this endpoint to retrieve a single registered wallet by its ID. The response includes the wallet address, its blockchain network, and the ID of the owning customer.

​
Endpoint

GET https://api.spherepay.co/v2/wallet/{id}

​
Authentication

All requests require a Bearer token in the Authorization header. 
Authorization: Bearer <token>

​
Path parameters

​
id
string
required
The wallet ID returned when the wallet was registered (e.g., "wallet_ce745ef7f3df4b9a8bff1301ce24b045").
  -H "Authorization: Bearer $SPHERE_API_KEY"

​
Response fields

​
id
string
Unique identifier for the wallet.
​
address
string
The blockchain address that was registered.
​
network
string
The network code this wallet is registered on (e.g., "sol", "ethereum", "polygon").
​
customerId
string
ID of the customer who owns this wallet.
​
created
string
ISO 8601 timestamp of when the wallet was registered.
​
updated
string
ISO 8601 timestamp of the most recent update.
  "id": "wallet_ce745ef7f3df4b9a8bff1301ce24b045",
  "address": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "network": "sol",
  "customerId": "customer_66c4168d418a410eae282b83883bdc39",
  "created": "2025-01-01T00:00:00.000Z",
  "updated": "2025-01-01T00:00:00.000Z"
}

​
Error responses

StatusCodeDescription
400address/invalidThe request is malformed or the ID format is invalid.
404resource/not-foundNo wallet with the specified ID exists.
422validation/failedValidation failed. The response includes a per-field errors array.
Last modified on May 12, 2026