Get a Customer

GET

/customers/{uid}

Retrieves the full details of a single customer by their unique identifier (uid).

Use this endpoint to check a customer's current points balance, status, and profile information before performing point operations.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Responses

🟢200OK

application/json

Customer details retrieved successfully.

Body

🟠401Unauthorized

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/customers/cust_abc123def456' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "status": true,
    "message": "Customer fetched successfully",
    "data": {
        "uid": "cust_abc123def456",
        "email": "jane@example.com",
        "phone_number": "+2348012345678",
        "first_name": "Jane",
        "last_name": "Doe",
        "date_of_birth": "1995-06-15",
        "status": "active",
        "points_balance": 1500,
        "created_at": "2026-01-15T10:30:00.000Z"
    }
}

Modified at 2026-02-25 12:17:15

List Customers

Update a Customer