---
title: "Changes to Get a contact by id"
method: GET
path: "/contacts/{contactId}"
---

# Changes to Get a contact by id

`GET /contacts/{contactId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 9 revisions.

- **2026-07-28** `8ccfb9a461e2`: 13 breaking, 3 warning, 23 info
- **2026-01-27** `e21feba47bec`: 1 info

## 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`
  - response property `email` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `firstName` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `gender` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `lastName` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `notes` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `occupation` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `phone` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `waId` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `waProfileName` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - removed the optional property `birthDate` from the response with the `200` status
  - removed the optional property `statusId` from the response with the `200` status
  - removed the optional property `workspaceId` from the response with the `200` status
  - added the non-success response with the status `401`
  - added the non-success response with the status `404`
  - the response property `age` became required for the status `200`
  - the response property `createDate` became required for the status `200`
  - the response property `customProperties` became required for the status `200`
  - the response property `email` became required for the status `200`
  - the response property `firstName` became required for the status `200`
  - the response property `gender` became required for the status `200`
  - the response property `id` became required for the status `200`
  - the response property `lastName` became required for the status `200`
  - the response property `notes` became required for the status `200`
  - the response property `occupation` became required for the status `200`
  - the response property `phone` became required for the status `200`
  - the response property `updateDate` became required for the status `200`
  - the response property `waId` became required for the status `200`
  - the response property `waProfileName` became required for the status `200`
  - the `createDate` response's property pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$` was added for the status `200`
  - the `id` response's property 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)$` was added for the status `200`
  - the `updateDate` response's property pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$` was added for the status `200`
  - added 'propertyNames' constraint to the `customProperties` response property for the status `200`
  - added the required property `birthdate` to the response with the `200` status
  - added the required property `fullName` to the response with the `200` status
  - added the required property `tags` to the response with the `200` status
- **2026-01-27** `e21feba47bec`: 1 info
  - added the optional property `customProperties` to the response with the `200` status

---

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