Customer
Get a Customer by ID
Gets information about a customer by ID.
AuthorizationBearer <token>
JWT Bearer token authentication
In: header
Path Parameters
customer_idstring
The customer's unique ID generated by SpherePay upon customer creation.
Pattern
"^customer_[a-z0-9]+$"Response Body
curl -X GET "https://api.sandbox.spherepay.co/v2/customer/customer_1ab2c3d4"fetch("https://api.sandbox.spherepay.co/v2/customer/customer_1ab2c3d4")package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.sandbox.spherepay.co/v2/customer/customer_1ab2c3d4"
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_1ab2c3d4"
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"
}
}