---
title: "Get a contact by id"
method: GET
path: "/contacts/{contactId}"
tags: ["Contacts"]
---

# Get a contact by id

`GET /contacts/{contactId}`

## Request

- Base URL: `https://messenger-public-api.cogfy.com`
- URL: `https://messenger-public-api.cogfy.com/contacts/{contactId}`
- Auth: API key in header `api-key`
- TypeScript: <https://skmtc.dev/indigohive/apis/cogfy-messenger-public-api/docs/contacts/:contactId/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `contactId` string, uuid, required

## Response `200`

Contact details

- object
  - `id` string, uuid, required
  - `waId` string, nullable, required: WhatsApp id of the contact
  - `waProfileName` string, nullable, required: Name in the WhatsApp profile of the contact
  - `firstName` string, nullable, required
  - `lastName` string, nullable, required
  - `fullName` string, nullable, required
  - `email` string, nullable, required
  - `phone` string, nullable, required
  - `occupation` string, nullable, required
  - `gender` string, nullable, required
  - `birthdate` string, nullable, required
  - `age` number, nullable, required
  - `notes` string, nullable, required
  - `tags` object[], required
    - `id` string, uuid, required
    - `name` string, required
  - `createDate` string, date-time, required
  - `updateDate` string, date-time, required
  - `customProperties` object, required: Values of the custom contact properties of the workspace, keyed by property name

## Other responses

- `401`: Unauthorized
- `404`: Contact not found

## Changes

- **2026-07-28** `8ccfb9a461e2`: 13 breaking, 3 warning, 23 info
  - added the pattern `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$` to the `path` request parameter `contactId`
  - for the `path` request parameter `contactId`, the format changed from no format to `uuid`
  - response property `age` list-of-types was widened by adding types `null and number` to media type `application/json` of response `200`
  - response property `customProperties/additionalProperties/` list-of-types was widened by adding types `boolean, null and number` to media type `application/json` of response `200`
  - …35 more
- **2026-01-27** `e21feba47bec`: 1 info
  - added the optional property `customProperties` to the response with the `200` status

[Operation history](https://skmtc.dev/indigohive/apis/cogfy-messenger-public-api/changes/contacts/:contactId/get.md)

---

[API](https://skmtc.dev/indigohive/apis/cogfy-messenger-public-api.md) - [All operations](https://skmtc.dev/indigohive/apis/cogfy-messenger-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/indigohive/apis/cogfy-messenger-public-api/revisions/30bd33ee45c9?raw)