Themes built on the Twig templating engine are now deprecated and require migration to Vitrin to ensure continued support and compatibility with Zid.
- 🗂️ Overview
- 🚀 Start Here
- Create your First App
- Responses
- Rate Limiting
- Authorization
- StoreFront Events
- Zid MUI
- Zid SDKs
- Our custom MCP server
- Merchant APIs
- Account
- Orders
- Reverse Orders
- Abandoned Carts
- Products
- Inventories
- Shipping
- Marketing
- Customers
- Store Settings
- Countries and Cities
- Webhooks
- App Management
Primary Customer List
GET
https://api.zid.sa/v1/managers/store/customers/primary-data-list
🔑Scopes
third_customers_read - Customers ReadRequest
Query Params
Header Params
Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.zid.sa/v1/managers/store/customers/primary-data-list?page=1&per_page=15' \
--header 'Authorization: {{Autherization}}' \
--header 'X-Manager-Token: {{Access-Token}}' \
--header 'Accept-Language: en'Responses
🟢200OK
application/json
Bodyapplication/json
Example
{
"status": "object",
"customers": [
{
"id": 23862,
"name": "Mohammed AlGhannam 01",
"email": "os1987@yahoo.com",
"mobile": "966569817190",
"gender": "female",
"birth_date": "2025-04-01",
"verified": true,
"is_active": true,
"is_cod_enabled": true,
"type": "business",
"business_name": "زد",
"tax_number": null,
"commercial_registration": "000000",
"source": null,
"points": 0,
"order_total_payments": "59559.48772970700000",
"last_order_date": "2026-02-25 16:31:27",
"created_at": "2017-11-26T13:39:38.000000Z",
"updated_at": "2026-03-03T10:50:23.000000Z",
"city": null,
"order_counts": 57
},
{
"id": 21063,
"name": "Abdulaziz",
"email": "",
"mobile": "966570633122",
"gender": null,
"birth_date": null,
"verified": true,
"is_active": false,
"is_cod_enabled": true,
"type": "individual",
"business_name": null,
"tax_number": null,
"commercial_registration": null,
"source": null,
"points": 0,
"order_total_payments": "19674.33620000000000",
"last_order_date": "2023-10-26 15:39:20",
"created_at": "2017-11-26T18:16:20.000000Z",
"updated_at": "2025-09-01T19:23:45.000000Z",
"city": null,
"order_counts": 10
},
{
"id": 17234,
"name": "Jawaherr",
"email": "Jawaher-khaled@hotmail.com",
"mobile": "966583233443",
"gender": null,
"birth_date": "2023-06-15",
"verified": true,
"is_active": true,
"is_cod_enabled": true,
"type": "individual",
"business_name": null,
"tax_number": null,
"commercial_registration": null,
"source": null,
"points": 0,
"order_total_payments": "30646.22115258900000",
"last_order_date": "2026-01-26 11:13:19",
"created_at": "2018-05-31T17:25:11.000000Z",
"updated_at": "2026-04-20T14:28:02.000000Z",
"city": null,
"order_counts": 49
},
{
"id": 59292,
"name": "new test sokolov 6",
"email": "b.alenezi@zid.sa",
"mobile": "966591555966",
"gender": null,
"birth_date": null,
"verified": true,
"is_active": true,
"is_cod_enabled": true,
"type": "individual",
"business_name": null,
"tax_number": null,
"commercial_registration": null,
"source": null,
"points": 0,
"order_total_payments": "3072.99166179620000",
"last_order_date": "2026-02-25 00:32:59",
"created_at": "2018-08-07T15:01:54.000000Z",
"updated_at": "2026-04-19T13:36:38.000000Z",
"city": null,
"order_counts": 26
},
{
"id": 125505,
"name": "shopzy",
"email": "osama@zid.sa",
"mobile": "966502150655",
"gender": null,
"birth_date": null,
"verified": true,
"is_active": true,
"is_cod_enabled": true,
"type": "individual",
"business_name": null,
"tax_number": null,
"commercial_registration": null,
"source": null,
"points": 0,
"order_total_payments": "10008382.55000000000000",
"last_order_date": "2025-03-19 18:39:40",
"created_at": "2018-09-27T13:08:26.000000Z",
"updated_at": "2025-09-01T19:23:47.000000Z",
"city": null,
"order_counts": 15
},
{
"id": 86113,
"name": "lamia alothman",
"email": "lamiasu9@gmail.com",
"mobile": "966568263780",
"gender": "male",
"birth_date": null,
"verified": true,
"is_active": true,
"is_cod_enabled": true,
"type": "individual",
"business_name": null,
"tax_number": null,
"commercial_registration": null,
"source": null,
"points": 0,
"order_total_payments": "853.47500000000000",
"last_order_date": "2026-03-12 10:25:00",
"created_at": "2018-10-31T09:35:56.000000Z",
"updated_at": "2026-03-29T10:26:41.000000Z",
"city": null,
"order_counts": 11
},
{
"id": 142413,
"name": "gamal",
"email": "aa@zid.com",
"mobile": "966502312345",
"gender": "female",
"birth_date": "2023-10-04",
"verified": true,
"is_active": true,
"is_cod_enabled": true,
"type": "individual",
"business_name": null,
"tax_number": null,
"commercial_registration": null,
"source": null,
"points": 0,
"order_total_payments": "612.50000000000000",
"last_order_date": "2023-07-10 12:47:57",
"created_at": "2018-11-01T08:45:51.000000Z",
"updated_at": "2025-09-01T19:23:47.000000Z",
"city": null,
"order_counts": 7
},
{
"id": 134728,
"name": "sara",
"email": "mm@test.com",
"mobile": "966557917355",
"gender": null,
"birth_date": "2023-06-06",
"verified": true,
"is_active": true,
"is_cod_enabled": true,
"type": "individual",
"business_name": null,
"tax_number": null,
"commercial_registration": null,
"source": null,
"points": 0,
"order_total_payments": "2411.20000000000000",
"last_order_date": "2023-07-10 13:05:09",
"created_at": "2018-11-03T19:59:48.000000Z",
"updated_at": "2025-09-01T19:23:47.000000Z",
"city": null,
"order_counts": 4
},
{
"id": 109912,
"name": "غادة",
"email": "ghadahsl95@gmail.com",
"mobile": "966544664243",
"gender": null,
"birth_date": null,
"verified": true,
"is_active": true,
"is_cod_enabled": true,
"type": "individual",
"business_name": null,
"tax_number": null,
"commercial_registration": null,
"source": null,
"points": 0,
"order_total_payments": "1141.40000000000000",
"last_order_date": "2025-06-23 19:56:33",
"created_at": "2018-11-03T21:17:44.000000Z",
"updated_at": "2025-09-01T19:23:47.000000Z",
"city": null,
"order_counts": 14
},
{
"id": 148345,
"name": "Ahmad Hatahet",
"email": "drahmadhatahet@gmail.com",
"mobile": "966558368748",
"gender": null,
"birth_date": null,
"verified": true,
"is_active": true,
"is_cod_enabled": true,
"type": "individual",
"business_name": null,
"tax_number": null,
"commercial_registration": null,
"source": null,
"points": 0,
"order_total_payments": "633.20000000000000",
"last_order_date": "2025-01-24 19:47:52",
"created_at": "2018-11-12T11:22:07.000000Z",
"updated_at": "2025-09-01T19:23:47.000000Z",
"city": null,
"order_counts": 4
},
{
"id": 35350,
"name": "Nujood Ahmed",
"email": "n.bayahya@zid.sa",
"mobile": "966509195721",
"gender": null,
"birth_date": null,
"verified": true,
"is_active": true,
"is_cod_enabled": true,
"type": "individual",
"business_name": null,
"tax_number": null,
"commercial_registration": null,
"source": null,
"points": 0,
"order_total_payments": "2681.78000000000000",
"last_order_date": "2019-07-03 13:41:29",
"created_at": "2018-11-12T21:35:45.000000Z",
"updated_at": "2025-09-01T19:23:46.000000Z",
"city": null,
"order_counts": 7
},
{
"id": 93,
"name": "Abdulrhman",
"email": "abdulrhman.aissa@zid.sa",
"mobile": "966555555555",
"gender": "female",
"birth_date": "2009-08-07",
"verified": true,
"is_active": true,
"is_cod_enabled": true,
"type": "individual",
"business_name": null,
"tax_number": null,
"commercial_registration": null,
"source": null,
"points": 0,
"order_total_payments": "465.65000000000000",
"last_order_date": "2025-04-24 13:49:50",
"created_at": "2018-11-14T15:25:12.000000Z",
"updated_at": "2025-09-01T19:23:44.000000Z",
"city": null,
"order_counts": 16
},
{
"id": 149704,
"name": "jkl",
"email": "",
"mobile": "96654444444",
"gender": null,
"birth_date": null,
"verified": true,
"is_active": true,
"is_cod_enabled": true,
"type": "individual",
"business_name": null,
"tax_number": null,
"commercial_registration": null,
"source": null,
"points": 0,
"order_total_payments": "0.00000000000000",
"last_order_date": null,
"created_at": "2018-11-14T15:26:37.000000Z",
"updated_at": "2025-09-01T19:23:47.000000Z",
"city": null,
"order_counts": 0
},
{
"id": 166626,
"name": "محمد عبد الرحمن",
"email": "m.basideq@zid.sa",
"mobile": "969534358103",
"gender": null,
"birth_date": null,
"verified": true,
"is_active": true,
"is_cod_enabled": true,
"type": "individual",
"business_name": null,
"tax_number": null,
"commercial_registration": null,
"source": null,
"points": 0,
"order_total_payments": "6798.55250000000000",
"last_order_date": "2024-10-14 07:06:40",
"created_at": "2018-12-19T16:47:14.000000Z",
"updated_at": "2025-09-01T19:23:48.000000Z",
"city": null,
"order_counts": 16
},
{
"id": 169061,
"name": "hamad alshahrani",
"email": "hamad@maxsys.sa",
"mobile": "966500372573",
"gender": null,
"birth_date": null,
"verified": true,
"is_active": true,
"is_cod_enabled": true,
"type": "individual",
"business_name": null,
"tax_number": null,
"commercial_registration": null,
"source": null,
"points": 0,
"order_total_payments": "223.18015846719000",
"last_order_date": "2023-12-31 17:56:01",
"created_at": "2019-01-06T17:11:10.000000Z",
"updated_at": "2025-09-01T19:23:48.000000Z",
"city": null,
"order_counts": 3
},
{
"id": 284941,
"name": "محمد",
"email": "m.basiddeq@gmail.com",
"mobile": "966534458113",
"gender": null,
"birth_date": null,
"verified": true,
"is_active": true,
"is_cod_enabled": true,
"type": "individual",
"business_name": null,
"tax_number": null,
"commercial_registration": null,
"source": null,
"points": 0,
"order_total_payments": "14970.09933044200000",
"last_order_date": "2020-02-11 09:52:41",
"created_at": "2019-04-17T17:29:18.000000Z",
"updated_at": "2025-09-01T19:23:50.000000Z",
"city": null,
"order_counts": 48
},
{
"id": 299598,
"name": "J zid account",
"email": "iam@jerais.com",
"mobile": "966569466594",
"gender": null,
"birth_date": null,
"verified": true,
"is_active": true,
"is_cod_enabled": true,
"type": "individual",
"business_name": null,
"tax_number": null,
"commercial_registration": null,
"source": null,
"points": 0,
"order_total_payments": "27.60000000000000",
"last_order_date": "2019-05-08 10:34:50",
"created_at": "2019-04-22T23:59:43.000000Z",
"updated_at": "2025-09-01T19:23:50.000000Z",
"city": null,
"order_counts": 1
},
{
"id": 329040,
"name": "lamia",
"email": "",
"mobile": "966568263788",
"gender": null,
"birth_date": null,
"verified": true,
"is_active": true,
"is_cod_enabled": true,
"type": "individual",
"business_name": null,
"tax_number": null,
"commercial_registration": null,
"source": null,
"points": 0,
"order_total_payments": "0.00000000000000",
"last_order_date": null,
"created_at": "2019-04-29T08:36:30.000000Z",
"updated_at": "2025-09-01T19:23:51.000000Z",
"city": null,
"order_counts": 0
},
{
"id": 144957,
"name": "SHAYA",
"email": "shaya89@hotmail.com",
"mobile": "966554554918",
"gender": null,
"birth_date": null,
"verified": true,
"is_active": true,
"is_cod_enabled": true,
"type": "individual",
"business_name": null,
"tax_number": null,
"commercial_registration": null,
"source": null,
"points": 0,
"order_total_payments": "1763.21000000000000",
"last_order_date": "2021-01-14 10:12:27",
"created_at": "2019-05-13T20:17:51.000000Z",
"updated_at": "2025-09-01T19:23:47.000000Z",
"city": null,
"order_counts": 7
},
{
"id": 105002,
"name": "Sabah",
"email": "sab.al-sheikh@hotmail.com",
"mobile": "966501517180",
"gender": null,
"birth_date": null,
"verified": true,
"is_active": true,
"is_cod_enabled": true,
"type": "individual",
"business_name": null,
"tax_number": null,
"commercial_registration": null,
"source": null,
"points": 0,
"order_total_payments": "868.63100000000000",
"last_order_date": "2020-01-22 11:28:45",
"created_at": "2019-05-26T09:30:12.000000Z",
"updated_at": "2025-09-01T19:23:47.000000Z",
"city": null,
"order_counts": 10
}
],
"message": {
"type": "object",
"code": null,
"name": null,
"description": null
}
}🟠401Unauthorized
🔴500Internal Server error
Modified at 2026-05-18 13:26:50