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.
Match
^customer_[a-z0-9]+$
Response Body
curl -X GET "https://api.sandbox.spherepay.co/v2/customer/customer_1ab2c3d4"
{
"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"
}
}