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

# Get a client contact by ID

`GET /clients/{id}`

## Request

- Base URL: `https://api.purplegrain.com/api/v1`
- URL: `https://api.purplegrain.com/api/v1/clients/{id}`
- Auth: HTTP bearer

Retrieve one saved client contact by its PurpleGrain client ID. Returns its name, mobile, email, location, task count and last task date; include can expand its owner or linked user. Requires permission to manage the owning account or organization, including write access in an assistant connection's grant. This lookup does not modify the contact or send messages.

## Path parameters

- `id` string, required

## Query parameters

- `include` string

## Response `200`

Successful. When the `include` query parameter is used, the response may contain an `included` array (JSON:API) or inlined related resources (application/json).

- ClientsShowResponseAttributes: Single client response for Accept application/json (attributes adapter).
  - `data` ClientModelAttributes: Single client in attributes-adapter shape (Accept application/json). id, type, and attribute fields at top level; no nested attributes/relationships. The owner/user relationship keys may appear when include is used.
    - `id` string
    - `type` string
    - `name` string
    - `mobile` string, nullable
    - `email` string, nullable
    - `location` string, nullable
    - `tasks_count` integer
    - `last_task_at` string, date-time, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `owner` object: Present when include=owner
    - `user` object: Present when include=user
  - `meta` PaginationMeta
    - `current_page` number
    - `next_page` number, nullable
    - `prev_page` number, nullable

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

---

[API](https://skmtc.dev/purplegrain/apis/purple-grain-api.md) · [All operations](https://skmtc.dev/purplegrain/apis/purple-grain-api/llms.txt) · [OpenAPI document](https://skmtc.dev/purplegrain/apis/purple-grain-api/revisions/4bedbc1c784c?raw)