Skip to main content
GET
/
customers
/
{id}
Get Customer by ID
curl --request GET \
  --url https://integrations.clopos.com/open-api/customers/{id} \
  --header 'x-brand: <api-key>' \
  --header 'x-token: <api-key>' \
  --header 'x-venue: <api-key>'
{
    "id": 9,
    "venue_id": 1,
    "cid": "ad1855aa-226c-465a-a322-a96cf231bda0",
    "group_id": 1,
    "balance_id": 2870,
    "name": "Rahid Akhundzada",
    "discount": 0,
    "email": null,
    "phones": [
        "+994705401040"
    ],
    "phone": "+994705401040",
    "address": null,
    "description": null,
    "addresses": [
        "test test"
    ],
    "address_data": [
        {
            "type": "plain",
            "source": "client",
            "formattedAddress": "test test"
        }
    ],
    "bonus_balance_id": null,
    "cashback_balance_id": 2896,
    "spent": 2684.47,
    "total_discount": 98.41,
    "total_bonus": 0,
    "receipt_count": 14,
    "gender": 1,
    "date_of_birth": null,
    "code": null,
    "created_at": "2024-07-19T19:18:19.000000Z",
    "updated_at": "2025-08-22T10:16:41.000000Z",
    "deleted_at": null,
    "source": "LOYALTY",
    "reference_id": "63d92187d2960bde1d66048c",
    "phone_verified_at": "2024-07-19 23:18:19",
    "status": true,
    "can_use_loyalty_system": true,
    "is_verified": true
}
This endpoint retrieves a specific customer by their unique ID.
id
integer
required
The unique identifier of the customer to retrieve.
{
    "id": 9,
    "venue_id": 1,
    "cid": "ad1855aa-226c-465a-a322-a96cf231bda0",
    "group_id": 1,
    "balance_id": 2870,
    "name": "Rahid Akhundzada",
    "discount": 0,
    "email": null,
    "phones": [
        "+994705401040"
    ],
    "phone": "+994705401040",
    "address": null,
    "description": null,
    "addresses": [
        "test test"
    ],
    "address_data": [
        {
            "type": "plain",
            "source": "client",
            "formattedAddress": "test test"
        }
    ],
    "bonus_balance_id": null,
    "cashback_balance_id": 2896,
    "spent": 2684.47,
    "total_discount": 98.41,
    "total_bonus": 0,
    "receipt_count": 14,
    "gender": 1,
    "date_of_birth": null,
    "code": null,
    "created_at": "2024-07-19T19:18:19.000000Z",
    "updated_at": "2025-08-22T10:16:41.000000Z",
    "deleted_at": null,
    "source": "LOYALTY",
    "reference_id": "63d92187d2960bde1d66048c",
    "phone_verified_at": "2024-07-19 23:18:19",
    "status": true,
    "can_use_loyalty_system": true,
    "is_verified": true
}

Authorizations

x-token
string
header
required

Access token obtained from /auth endpoint

x-brand
string
header
required

Brand identifier

x-venue
string
header
required

Venue identifier

Path Parameters

id
integer
required

Customer ID

Response

Customer retrieved successfully.

id
string
name
string
email
string<email>
phone
string
group_id
integer
balance
object
cashback_balance
object
group
object
created_at
string<date-time>