---
title: "Get a client by ID"
method: GET
path: "/Clients/{id}"
tags: ["Clients"]
---

# Get a client by ID

`GET /Clients/{id}`

## Path parameters

- `id` string, required

## Response `200`

OK

- ClientResponseDto
  - `id` string
  - `email` string, nullable
  - `phoneNumber` string, nullable
  - `firstName` string
  - `lastName` string
  - `address` string, nullable
  - `addressLine2` string, nullable — Apartment / suite / unit. Second address line.
  - `city` string, nullable
  - `state` string, nullable
  - `zipCode` string, nullable
  - `countryCode` string, nullable — ISO 3166-1 alpha-2 country code (e.g. "US", "GB"). Defaults to clinic's region if null.
  - `dateOfBirth` string, date-time, nullable
  - `accountStatus` integer
  - `emergencyContact` EmergencyContactDto
    - `name` string, nullable
    - `phone` string, nullable
    - `email` string, nullable
    - `relationship` string, nullable
  - `secondaryEmergencyContact` SecondaryEmergencyContactDto — A client's secondary (backup) emergency contact — free-text, same shape as the primary one (PAW-650). Backed by the `SecondaryEmergencyContact*` columns on the client.
    - `name` string, nullable
    - `phone` string, nullable
    - `email` string, nullable
    - `relationship` string, nullable
  - `communicationPreferences` CommunicationPreferencesDto
    - `preferredMethod` integer
    - `allowAppointmentReminders` boolean
    - `allowEmailMarketing` boolean
    - `allowPhoneCalls` boolean
    - `allowSmsMarketing` boolean
    - `notes` string, nullable
  - `preferredLanguage` string, nullable
  - `referralSource` string, nullable — Marketing attribution — "how did you hear about us". Staff/client entered.
  - `createdVia` string, nullable — Read-only provenance — the channel that created the record (ITE-419).
  - `allowHouseAccount` boolean — House account (ITE-670): approved to charge invoices to their account. Changed only via PUT /clients/{id}/house-account (settings permission).
  - `paymentTermsDays` union — Payment terms in days (0 = due on receipt); null = tenant default.
    - integer
    - string, int32
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `404` — Not Found

## Changes

- **2026-09-17** `d4ae30be0619` — 3 info
  - added the optional property `addressLine2` to the response with the `200` status (media type: text/plain)
  - added the optional property `addressLine2` to the response with the `200` status (media type: application/json)
  - added the optional property `addressLine2` to the response with the `200` status (media type: text/json)
- **2026-09-11** `503cd0546309` — 6 info
  - added the optional property `allowHouseAccount` to the response with the `200` status (media type: text/plain)
  - added the optional property `allowHouseAccount` to the response with the `200` status (media type: application/json)
  - added the optional property `allowHouseAccount` to the response with the `200` status (media type: text/json)
  - added the optional property `paymentTermsDays` to the response with the `200` status (media type: text/plain)
  - …2 more
- **2026-08-19** `d8d7501dde48` — 3 info
  - added the optional property `createdVia` to the response with the `200` status (media type: text/plain)
  - added the optional property `createdVia` to the response with the `200` status (media type: application/json)
  - added the optional property `createdVia` to the response with the `200` status (media type: text/json)

[Change history](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/changes/Clients/:id/get.md)

---

[API](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1.md) · [All operations](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/revisions/652ff1990675?raw)
