Use this endpoint to fetch the full details of a single customer by their unique ID. The response includes the customer’s current verification profile status, which tells you exactly which KYC/KYB criteria remain outstanding before the customer can initiate a transfer. You can also inspect attached bank accounts and wallets through this record.
Endpoint GET https://api.spherepay.co/v2/customer/{id}
Authentication All requests require a Bearer token in the Authorization header.
Authorization: Bearer <token>
Path parameters The unique customer ID, prefixed with customer_ (e.g. customer_f31121c389624d3697cbf3ea8830b7a4).
-H "Authorization: Bearer $SPHEREPAY_API_KEY "
Response fields Unique customer identifier, prefixed with customer_.
Customer type: individual or business.
Registered email address.
Registered phone number in E.164 format.
First name (individual customers only).
Last name (individual customers only).
Array of verification profiles describing the customer’s KYC or KYB status. Show verificationProfile properties
Profile identifier (e.g. kyc_profile_a).
Overall profile status. Possible values:
incomplete — Required criteria have not yet been submitted.pending — Under review by SpherePay.approved — The customer has passed verification and is eligible for transfers.rejected — Verification was declined. Granular breakdown of each verification step. Steps that have been satisfied (e.g. email_address, phone_number, residential_address, tax_identification_number).
Steps currently under manual review.
Steps still needed before the customer can be submitted for review (e.g. identity_document, liveness_report_document).
Steps that encountered an error or were rejected and require remediation.
Arbitrary key-value metadata associated with the customer.
ISO 8601 timestamp of when the customer record was created.
ISO 8601 timestamp of the most recent update to the customer record.
"id" : "customer_f31121c389624d3697cbf3ea8830b7a4" , "type" : "individual" , "email" : "jane.smith@example.com" , "phone" : "+14155550123" , "firstName" : "Jane" , "lastName" : "Smith" , "verificationProfiles" : [ { "name" : "kyc_profile_a" , "status" : "incomplete" , "criteria" : { "complete" : [ "email_address" , "phone_number" , "residential_address" , "tax_identification_number" ], "pending" : [], "required" : [ "identity_document" , "liveness_report_document" ], "errors" : [] } } ], "meta" : {}, "createdAt" : "2026-03-09T20:46:31.305Z" , "updatedAt" : "2026-03-09T20:46:31.305Z" }
Error codes Status Code Description 400address/invalidThe request is malformed. 404resource/not-foundNo customer exists with the given ID. 422validation/failedThe provided ID did not pass format validation.
