Themes built on the Twig templating engine are now deprecated and require migration to Vitrin to ensure continued support and compatibility with Zid.

FInd Customer By Phone Number

GET

https://api.zid.sa/v1/managers/store/customers/by-phone/{customerPhone}

Retrieves a customer by mobile number

🔑Scopes

third_customers_read - Customers Read

Request

Path Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.zid.sa/v1/managers/store/customers/by-phone/966503187421' \
--header 'Authorization: {{Autherization}}' \
--header 'X-Manager-Token: {{Access-Token}}' \
--header 'Accept-Language: en'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "status": "object",
    "customer": {
        "id": 37,
        "name": "Osama Khaled",
        "email": "osamakhaled2010@gmail.com",
        "mobile": "966503187423",
        "gender": "male",
        "birth_date": "1987-05-05",
        "verified": true,
        "is_active": true,
        "is_cod_enabled": true,
        "type": "individual",
        "business_name": null,
        "source": null,
        "order_counts": 973,
        "total_payments": 627930.2961553979,
        "orders_cost_average": 645.3548778575517,
        "last_order_data": {
            "id": 68558762,
            "order_total_string": "267.35 SAR",
            "created_at": "2026-04-27"
        }
    },
    "message": {
        "type": "object",
        "code": null,
        "name": null,
        "description": null
    }
}

🟠401Unauthorized

🔴500Internal Server error

Modified at 2026-05-19 14:56:46

Primary Customer List

Customer Profile