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

# Get a client by ID

`GET /v2/clients/{id}`

Returns a single client including full contact details, service and billing addresses, tags, ad group, notes, additional contacts, and custom field values.

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required

## Response `200`

The requested client.

- ResponseClientV2Dto
  - `id` string — The ID of the client (prefix `CL-`).
  - `serialId` number — The serial ID of the client.
  - `firstName` string — The first name of the client.
  - `lastName` string — The last name of the client.
  - `fullName` string — The full name of the client.
  - `companyName` string — The company name of the client.
  - `email` string — The email address of the client.
  - `primaryExt` string — The primary phone extension of the client.
  - `primaryPhone` string — The primary phone of the client.
  - `secondaryExt` string — The secondary phone extension of the client.
  - `secondaryPhone` string — The secondary phone of the client.
  - `country` string — The country of the client.
  - `state` string — The state of the client.
  - `city` string — The city of the client.
  - `zipcode` string — The zipcode of the client.
  - `unit` string — The unit of the client.
  - `address` string — The address of the client.
  - `serviceAddress` string — The service address of the client.
  - `billingAddress` string — The billing address of the client.
  - `allowBilling` boolean — Whether the client allows billing.
  - `adGroup` ResponseGenericAdGroupV2Dto
    - `id` string — The ID of the ad group (prefix `AG-`).
    - `name` string — The name of the ad group.
  - `tags` ResponseOneTagV2Dto[] — The tags of the client.
    - `id` string — The ID of the tag (prefix `TAG-`).
    - `name` string — The name of the tag.
    - `color` string — The color of the tag.
  - `parentClient` ResponseOneBaseClientV2Dto
    - `id` string — The ID of the client (prefix `CL-`).
    - `serialId` number — The serial ID of the client.
    - `firstName` string — The first name of the client.
    - `lastName` string — The last name of the client.
    - `fullName` string — The full name of the client.
    - `companyName` string — The company name of the client.
    - `email` string — The email address of the client.
    - `primaryExt` string — The primary phone extension of the client.
    - `primaryPhone` string — The primary phone of the client.
    - `secondaryExt` string — The secondary phone extension of the client.
    - `secondaryPhone` string — The secondary phone of the client.
    - `country` string — The country of the client.
    - `state` string — The state of the client.
    - `city` string — The city of the client.
    - `zipcode` string — The zipcode of the client.
    - `unit` string — The unit of the client.
    - `address` string — The address of the client.
    - `serviceAddress` string — The service address of the client.
    - `billingAddress` string — The billing address of the client.
    - `allowBilling` boolean — Whether the client allows billing.
  - `clientContacts` ResponseOneClientContactV2Dto[] — The contacts of the client.
    - `id` string — The ID of the client contact (prefix `CLC-`).
    - `firstName` string — The first name of the contact.
    - `lastName` string — The last name of the contact.
    - `fullName` string — The full name of the contact.
    - `email` string — The email address of the contact.
    - `primaryPhone` string — The primary phone number of the contact.
    - `secondaryPhone` string — The secondary phone number of the contact.
    - `country` string — The country of the contact.
    - `state` string — The state of the contact.
    - `city` string — The city of the contact.
    - `zipcode` string — The zip code of the contact.
    - `address` string — The address of the contact.
    - `role` string — The job title or role of the contact.
    - `note` string — A free-text note about the contact.
  - `notes` ResponseOneClientNoteV2Dto[] — The notes of the client.
    - `id` string — The ID of the client note (prefix `CLN-`).
    - `note` string — The note content.
    - `techName` string — The name of the user who created the note.
    - `createdAt` string, date-time — The date and time the note was created.
  - `customFields` ResponseGenericCustomFieldV2Dto[] — A list of Client Custom Fields.
    - `id` string — The ID of the custom field (prefix `CF-`).
    - `fieldName` string — The name of the custom field.
    - `value` union — The value of the custom field. Can be string, number, boolean, date string, or an array of file objects.
      - string — A string value.
      - number — A number value.
      - boolean — A boolean value.
      - object[]
        - `name` string — The name of the file.
        - `url` string — The URL of the file.
  - `created` string — The creation date of the client.

## Other responses

- `400` — The provided ID is not a valid client ID.
- `401` — Missing or invalid authentication token.
- `404` — No client with the given ID exists for this account.

---

[API](https://skmtc.net/workiz/apis/developer-api.md) · [All operations](https://skmtc.net/workiz/apis/developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/workiz/developer-api/revisions/14666f4db0f8/schema)