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

Get a Customer by ID

Gets information about the authenticated user.

GET
/v2/customer/{customer_id}
AuthorizationBearer <token>

In: header

Path Parameters

customer_idstring

Response Body

curl -X GET "https://api.sandbox.spherepay.co/v2/customer/{{customer_id}}"
fetch("https://api.sandbox.spherepay.co/v2/customer/{{customer_id}}")
package main

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

func main() {
  url := "https://api.sandbox.spherepay.co/v2/customer/{{customer_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/v2/customer/{{customer_id}}"

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

print(response.text)
{
  "id": "customer_2da22520a7e64bd2963c7dd6c807e875",
  "type": "individual",
  "email": "johndoe123@gmail.com",
  "firstName": "John",
  "lastName": "Doe",
  "verificationProfiles": [
    {
      "name": "kyc_profile_a",
      "status": "incomplete",
      "criteria": {
        "complete": [],
        "pending": [],
        "required": [
          "terms_of_service",
          "first_name",
          "last_name",
          "tax_identification_number",
          "email_address",
          "address_of_residence",
          "date_of_birth",
          "proof_of_address"
        ],
        "errors": [
          {
            "name": "identification_document",
            "message": "ID DOCS IS BLURRY"
          }
        ]
      }
    },
    {
      "name": "kyc_profile_b",
      "status": "incomplete",
      "complete": [],
      "pending": [],
      "required": [
        "terms_of_service",
        "first_name",
        "last_name",
        "tax_identification_number",
        "email_address",
        "address_of_residence",
        "date_of_birth",
        "proof_of_address"
      ],
      "errors": [
        {
          "name": "identification_document",
          "message": "ID DOCS IS BLURRY"
        }
      ]
    },
    {
      "name": "kyc_profile_c",
      "status": "approved"
    }
  ],
  "meta": {
    "string": "string"
  }
}
{
  "ts": "2025-04-20T19:29:51.768Z",
  "error": {
    "general": "Customer not found"
  }
}