---
title: "Lookup a client by email or phone (for existing client booking flow)"
method: POST
path: "/public/widget/clients/lookup"
tags: ["Widget"]
---

# Lookup a client by email or phone (for existing client booking flow)

`POST /public/widget/clients/lookup`

## Request body

- ClientLookupRequest
  - `clinicId` string, required
  - `email` string, nullable
  - `phone` string, nullable

## Response `200`

OK

- ClientLookupResponse
  - `found` boolean
  - `clientId` string, nullable
  - `clientName` string, nullable
  - `clientEmail` string, nullable
  - `clientPhone` string, nullable
  - `patients` PatientSummaryDto[]
    - `id` string — Unique patient identifier
    - `name` string — The patient's name
    - `species` string — The species name. References a species from GET /species endpoint.
    - `speciesId` string, nullable — The species ID for programmatic lookups.
    - `breed` string — The breed name
    - `sex` string — The patient's sex
    - `dateOfBirth` string, date-time, nullable — Date of birth, if known
    - `isEstimatedAge` boolean
    - `fixed` boolean — Whether the patient is spayed/neutered
    - `treatmentAcceptanceRate` union
      - number, double
      - string, double

---

[API](https://skmtc.net/clinicos/apis/pawthosx-business-api-v1.md) · [All operations](https://skmtc.net/clinicos/apis/pawthosx-business-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clinicos/pawthosx-business-api-v1/revisions/d8d7501dde48/schema)