> For the complete documentation index, see [llms.txt](https://developer.providusbank.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.providusbank.com/xpress-wallet-api/merchant/customers/find-customer-by-phone-number.md).

# Find Customer by Phone Number

Retrieve customer details using their phone number.

* **Endpoint**: `GET {{base-url}}/customer/phone?phoneNumber={phoneNumber}`
* **Query Parameters**:
  * `phoneNumber`: The customer's phone number (e.g., `08020245350`).
* **Headers**:

  ```json
  {
    "X-Access-Token": "{{access-token}}",
    "X-Refresh-Token": "{{refresh-token}}"
  }
  ```
* **Response**:
  * **200 OK**:

    ```json
    {
      "status": true,
      "customer": {
        "id": "1149d065-c5c9-4382-aec6-323090f31d9d",
        "firstName": "Emma",
        "lastName": "Godwin",
        "walletId": "0bea0968-c43a-47fe-a83a-f7b514194aba"
      }
    }
    ```
* **Sample Code (Dart)**:

  ```dart
  var headers = {
    'X-Access-Token': '{{access-token}}',
    'X-Refresh-Token': '{{refresh-token}}'
  };
  var request = http.Request('GET', Uri.parse('{{base-url}}/customer/phone?phoneNumber=08030223346'));
  request.headers.addAll(headers);
  http.StreamedResponse response = await request.send();
  if (response.statusCode == 200) {
    print(await response.stream.bytesToString());
  } else {
    print(response.reasonPhrase);
  }
  ```