Introducing Starknet Network:   OffRamp and OnRamp USDC are now supported for Starknet network.  View changelog for details →.
Sphere Paysphere
Wallet

Get a Wallet by ID

GET
/v1/wallet/{wallet_id}
AuthorizationBearer <token>

In: header

Path Parameters

wallet_idstring

The customer's wallet id.

Response Body

curl -X GET "https://api.sandbox.spherepay.co/v1/wallet/{{wallet_account_id}}"
fetch("https://api.sandbox.spherepay.co/v1/wallet/{{wallet_account_id}}")
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://api.sandbox.spherepay.co/v1/wallet/{{wallet_account_id}}"

  req, _ := http.NewRequest("GET", url, nil)
  
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}
import requests

url = "https://api.sandbox.spherepay.co/v1/wallet/{{wallet_account_id}}"

response = requests.request("GET", url)

print(response.text)
{
  "ok": true,
  "object": "object",
  "statusCode": 200,
  "error": null,
  "message": "success",
  "data": {
    "wallet": {
      "id": "wallet_79ecc905aa7d428ea54b40cd64ed2782",
      "address": "0x9e30C2f0b5718F07F686108caFf67b3861740193",
      "network": "ethereum",
      "nickname": null,
      "risk": "low",
      "primary": false,
      "feePayer": false,
      "signed": false,
      "mock": false,
      "lookupKey": null,
      "customer": "customer_68f1c089703945e7bbff6f04bf1c5041",
      "owner": "customer",
      "exported": null,
      "created": "2025-04-08T22:51:29.232Z",
      "updated": "2025-04-08T23:43:07.411Z",
      "deleted": null
    }
  },
  "ts": "2025-04-13T22:05:05.343Z",
  "request": "request_3d819d1256f24f8586a552ae17b74261"
}
{
  "ok": false,
  "object": "error",
  "statusCode": 404,
  "error": "wallets/not-found",
  "message": "Wallet not found",
  "data": null,
  "ts": "2025-04-20T21:45:42.622Z",
  "request": "request_b19ab2a8d05148fa972624f97ffa4947"
}