---
title: "Changes to Retrieve Contacts"
method: GET
path: "/v1/contacts"
---

# Changes to Retrieve Contacts

`GET /v1/contacts`

> Every recorded change to this operation, newest first.
> 46 revisions in range; 1 not diffed.

## Timeline

Changed in 10 of 46 revisions.

- **2026-10-22** `ff9df8ba8977`: 50 info
- **2026-09-24** `1a2c2b1d560f`: 3 breaking
- **2026-09-21** `09a5f5bf0a85`: 1 info
- **2026-09-03** `ac752c6c2be0`: 6 info
- **2026-09-02** `7a571092a308`: 3 breaking
- **2026-08-25** `eec8083439cb`: 2 info
- **2026-08-18** `e3b79e3bb5c3`: 1 info
- **2026-08-15** `f31998eea481`: 2 info
- **2026-07-31** `7dcb7b31d334`: 8 info
- **2026-07-13** `12ae8a6b9fad`: 1 breaking, 1 warning, 7 info

## Changes

- **2026-10-22** `ff9df8ba8977`: 50 info
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_connections/items/attributes/enrichment_available` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[#/components/schemas/CRMContactV1]/attributes/remote_id` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[#/components/schemas/CRMContactV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/attributes/email` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[#/components/schemas/CRMContactV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/attributes/remote_id` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[#/components/schemas/CRMContactV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/relationships/user` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[#/components/schemas/CRMLeadV1]/attributes/remote_id` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[#/components/schemas/CRMLeadV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/attributes/email` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[#/components/schemas/CRMLeadV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/attributes/remote_id` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[#/components/schemas/CRMLeadV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/relationships/user` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[#/components/schemas/CRMOrganizationV1]/attributes/remote_id` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[#/components/schemas/CRMOrganizationV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/attributes/email` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[#/components/schemas/CRMOrganizationV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/attributes/remote_id` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[#/components/schemas/CRMOrganizationV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/relationships/user` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[#/components/schemas/CRMConnectionV1]/attributes/enrichment_available` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[#/components/schemas/CRMConnectionV1]/relationships/crm_record/oneOf[#/components/schemas/CRMContactV1]/attributes/remote_id` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[#/components/schemas/CRMConnectionV1]/relationships/crm_record/oneOf[#/components/schemas/CRMContactV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/attributes/email` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[#/components/schemas/CRMConnectionV1]/relationships/crm_record/oneOf[#/components/schemas/CRMContactV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/attributes/remote_id` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[#/components/schemas/CRMConnectionV1]/relationships/crm_record/oneOf[#/components/schemas/CRMContactV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/relationships/user` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[#/components/schemas/CRMConnectionV1]/relationships/crm_record/oneOf[#/components/schemas/CRMLeadV1]/attributes/remote_id` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[#/components/schemas/CRMConnectionV1]/relationships/crm_record/oneOf[#/components/schemas/CRMLeadV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/attributes/email` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[#/components/schemas/CRMConnectionV1]/relationships/crm_record/oneOf[#/components/schemas/CRMLeadV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/attributes/remote_id` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[#/components/schemas/CRMConnectionV1]/relationships/crm_record/oneOf[#/components/schemas/CRMLeadV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/relationships/user` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[#/components/schemas/CRMConnectionV1]/relationships/crm_record/oneOf[#/components/schemas/CRMOrganizationV1]/attributes/remote_id` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[#/components/schemas/CRMConnectionV1]/relationships/crm_record/oneOf[#/components/schemas/CRMOrganizationV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/attributes/email` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[#/components/schemas/CRMConnectionV1]/relationships/crm_record/oneOf[#/components/schemas/CRMOrganizationV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/attributes/remote_id` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[#/components/schemas/CRMConnectionV1]/relationships/crm_record/oneOf[#/components/schemas/CRMOrganizationV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/relationships/user` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[#/components/schemas/CRMContactV1]/attributes/remote_id` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[#/components/schemas/CRMContactV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/attributes/email` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[#/components/schemas/CRMContactV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/attributes/remote_id` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[#/components/schemas/CRMContactV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/relationships/user` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[#/components/schemas/CRMLeadV1]/attributes/remote_id` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[#/components/schemas/CRMLeadV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/attributes/email` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[#/components/schemas/CRMLeadV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/attributes/remote_id` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[#/components/schemas/CRMLeadV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/relationships/user` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[#/components/schemas/CRMOrganizationV1]/attributes/remote_id` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[#/components/schemas/CRMOrganizationV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/attributes/email` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[#/components/schemas/CRMOrganizationV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/attributes/remote_id` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[#/components/schemas/CRMOrganizationV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/relationships/user` to the response with the `200` status
  - response property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[#/components/schemas/CRMContactV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/attributes/first_name` deprecated
  - response property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[#/components/schemas/CRMLeadV1]/relationships/crm_owner/oneOf[#/components/schemas/CRMUserV1]/attributes/first_name` deprecated
  - …10 more
- **2026-09-24** `1a2c2b1d560f`: 3 breaking
  - the response property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/attributes/industries/industry/items/name` became nullable for the status `200`
  - the response property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/attributes/industries/nace/items/name` became nullable for the status `200`
  - the response property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/attributes/industries/wz/items/name` became nullable for the status `200`
- **2026-09-21** `09a5f5bf0a85`: 1 info
  - added the required property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/icps/items/relationships` to the response with the `200` status
- **2026-09-03** `ac752c6c2be0`: 6 info
  - added the optional property `errors/items/source` to the response with the `400` status
  - added the optional property `errors/items/source` to the response with the `401` status
  - added the optional property `errors/items/source` to the response with the `403` status
  - added the optional property `errors/items/source` to the response with the `429` status
  - added the optional property `errors/items/source` to the response with the `500` status
  - added the optional property `errors/items/source` to the response with the `504` status
- **2026-09-02** `7a571092a308`: 3 breaking
  - the response property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/attributes/industries/industry/items/name` became nullable for the status `200`
  - the response property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/attributes/industries/nace/items/name` became nullable for the status `200`
  - the response property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/attributes/industries/wz/items/name` became nullable for the status `200`
- **2026-08-25** `eec8083439cb`: 2 info
  - added the optional property `data/items/relationships/buyer_personas/items/attributes/filters/location/items/type` to the response with the `200` status
  - added the optional property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/icps/items/attributes/filters/location/items/type` to the response with the `200` status
- **2026-08-18** `e3b79e3bb5c3`: 1 info
  - added the required property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/attributes/app_url` to the response with the `200` status
- **2026-08-15** `f31998eea481`: 2 info
  - removed the `unknown_department` enum value from the `data/items/attributes/departments/items/` response property for the response status `200`
  - removed the `unknown_hierarchy` enum value from the `data/items/attributes/hierarchy_level` response property for the response status `200`
- **2026-07-31** `7dcb7b31d334`: 8 info
  - added the required property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/web_visits/items/attributes/engagements/items/oneOf[subschema #1: page-view]/allOf[subschema #1]/id` to the response with the `200` status
  - added the required property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/web_visits/items/attributes/engagements/items/oneOf[subschema #1: page-view]/allOf[subschema #1]/time` to the response with the `200` status
  - added the required property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/web_visits/items/attributes/engagements/items/oneOf[subschema #2: form-submit]/allOf[subschema #1]/id` to the response with the `200` status
  - added the required property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/web_visits/items/attributes/engagements/items/oneOf[subschema #2: form-submit]/allOf[subschema #1]/time` to the response with the `200` status
  - added the required property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/web_visits/items/attributes/engagements/items/oneOf[subschema #3: file-download]/allOf[subschema #1]/id` to the response with the `200` status
  - added the required property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/web_visits/items/attributes/engagements/items/oneOf[subschema #3: file-download]/allOf[subschema #1]/time` to the response with the `200` status
  - added the required property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/web_visits/items/attributes/engagements/items/oneOf[subschema #4: video-view]/allOf[subschema #1]/id` to the response with the `200` status
  - added the required property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/relationships/web_visits/items/attributes/engagements/items/oneOf[subschema #4: video-view]/allOf[subschema #1]/time` to the response with the `200` status
- **2026-07-13** `12ae8a6b9fad`: 1 breaking, 1 warning, 7 info
  - the `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/attributes/industries/industry/items/` response's property type changed from no type to `object` for status `200`
  - added the new `legacy` enum value to the `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/attributes/register/status` response property for the response status `200`
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - the endpoint scheme security `OAuth2` was added to the API
  - added the non-success response with the status `401`
  - added the optional property `data/items/attributes/address/region` to the response with the `200` status
  - added the optional property `data/items/attributes/address/region_code` to the response with the `200` status
  - the response property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/attributes/industries/industry/items/name` became required for the status `200`
  - added the required property `data/items/relationships/company/oneOf[#/components/schemas/CompanyV1]/attributes/industries/industry/items/code` to the response with the `200` status

---

[Operation](https://skmtc.dev/leadfeeder/apis/leadfeeder-public-api/docs/v1/contacts/get.md) - [API](https://skmtc.dev/leadfeeder/apis/leadfeeder-public-api.md) - [Page](https://skmtc.dev/leadfeeder/apis/leadfeeder-public-api/changes/v1/contacts/get)
