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

# Get a client

`GET /clients/{id}`

## Request

- Base URL: `https://api.heffl.com/api/v1`
- URL: `https://api.heffl.com/api/v1/clients/{id}`
- Auth: API key in header `x-api-key`

Returns a single client by its public ID.

## Path parameters

- `id` string, required: Client public ID

## Response `200`

OK

- object
  - `id` string, required: Client public ID
  - `number` string, required: Auto-generated client number
  - `name` string, required: Client name
  - `type` 'company' | 'contact', required: Client type
  - `firstName` string, nullable: First name (for contacts)
  - `lastName` string, nullable: Last name (for contacts)
  - `email` string, nullable: Email address
  - `phone` string, nullable: Phone number
  - `website` string, nullable: Website URL
  - `stageId` string, nullable: Client stage public ID
  - `createdAt` string, date-time, required: When the client was created
  - `customFields` object, nullable: Custom field values

---

[API](https://skmtc.dev/heffl/apis/heffl-public-api-legacy-v1.md) · [All operations](https://skmtc.dev/heffl/apis/heffl-public-api-legacy-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/heffl/apis/heffl-public-api-legacy-v1/revisions/9bdb229223a2?raw)