GET

Get Customer

Retrieve the complete details of a specific customer profile.

GET/v2/customer/{customer_id}

Use this endpoint to fetch detailed information about a customer, including their personal details, connected accounts, and compliance status.

Headers

HeaderRequiredDescription
AuthorizationYESBearer token containing your secret API key.

Path Parameters

ParameterTypeRequiredDescription
customer_idstringYESThe unique identifier (cus_...) of the customer you want to retrieve.

Example Request

cURL
curl -X GET "https://sandbox.hexcore.io/v2/customer/cus_8f92jdl29skw" \-H "Authorization: Bearer sk_test_your_secret_key"

Example Response

JSON (200 OK)
{"status": true,"message": "Customer retrieved successfully","data": {"customer_id": "cus_8f92jdl29skw","first_name": "Samuel","last_name": "Smith","email": "sam.smith@example.com","phone_number": "+2348098765432","dob": "1990-05-15","gender": "MALE","created_at": "2026-05-01T15:00:00Z","accounts": [ {"account_number": "1234567890","status": "ACTIVE"} ] } }