The unique identifier of the customer to retrieve.
Authorizations
Access token obtained from /auth endpoint
Brand identifier
Venue identifier
Path Parameters
Customer 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
}
Retrieve a specific customer by their unique identifier.
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
}
{
"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
}
Access token obtained from /auth endpoint
Brand identifier
Venue identifier
Customer ID
Was this page helpful?