---
title: "Changes to Read"
method: GET
path: "/crm/v3/objects/leads/{leadsId}"
---

# Changes to Read

`GET /crm/v3/objects/leads/{leadsId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 16 of 103 revisions.

- **2026-09-22** (v3) `6af2ebb37fe0`: 1 info
- **2026-07-13** (v3) `2a8d409d7f40`: 1 info
- **2026-07-13** (v3) `ef081db8be86`: 1 breaking
- **2026-06-23** (v3) `2a8d409d7f40`: 1 info
- **2026-06-15** (v3) `f564d79fa468`: 1 breaking, 1 warning
- **2026-06-15** (v3) `7a2f8905eec0`: 1 info
- **2026-06-15** (v3) `ee04ec7ad70c`: 2 info
- **2026-04-15** (v3) `03f92a212086`: 5 info
- **2026-04-11** (v3) `655c7ff9ed28`: 1 info
- **2026-04-09** (v3) `cece651dde26`: 5 info
- **2026-04-03** (v3) `a2db5a1982ba`: 1 info
- **2026-02-10** (v3) `87952be55451`: 1 info
- **2025-12-11** (v3) `ecbc03cc76f7`: 2 info
- **2025-12-10** (v3) `1dbab5598cdf`: 6 info
- **2025-12-09** (v3) `710cc5a6f48a`: 6 info
- **2025-11-21** (v3) `3b6d09f1e471`: 2 warning

## Changes

- **2026-09-22** (v3) `6af2ebb37fe0`: 1 info
  - the endpoint scheme security `oauth2` was removed from the API
- **2026-07-13** (v3) `2a8d409d7f40`: 1 info
  - endpoint added
- **2026-07-13** (v3) `ef081db8be86`: 1 breaking
  - api path removed without deprecation
- **2026-06-23** (v3) `2a8d409d7f40`: 1 info
  - added the optional property `warnings` to the response with the `200` status
- **2026-06-15** (v3) `f564d79fa468`: 1 breaking, 1 warning
  - removed the required property `associations/additionalProperties/results/items/associationSpec` from the response with the `200` status
  - removed the optional property `associations/additionalProperties/results/items/toOffset` from the response with the `200` status
- **2026-06-15** (v3) `7a2f8905eec0`: 1 info
  - the response property `associations/additionalProperties/results/items/associationSpec` became required for the status `200`
- **2026-06-15** (v3) `ee04ec7ad70c`: 2 info
  - added the optional property `associations/additionalProperties/results/items/associationSpec` to the response with the `200` status
  - added the optional property `associations/additionalProperties/results/items/toOffset` to the response with the `200` status
- **2026-04-15** (v3) `03f92a212086`: 5 info
  - the endpoint scheme security `app_cookie` was removed from the API
  - the endpoint scheme security `hapikey` was removed from the API
  - the endpoint scheme security `internal_cookie` was removed from the API
  - the endpoint scheme security `private_apps` was removed from the API
  - the endpoint scheme security `shhkey` was removed from the API
- **2026-04-11** (v3) `655c7ff9ed28`: 1 info
  - endpoint added
- **2026-04-09** (v3) `cece651dde26`: 5 info
  - api operation id `get-/crm/v3/objects/leads/{leadsId}` removed and replaced with `get-/crm/v3/objects/leads/{leadsId}_getById`
  - the endpoint scheme security `app_cookie` was added to the API
  - the endpoint scheme security `hapikey` was added to the API
  - the endpoint scheme security `internal_cookie` was added to the API
  - the endpoint scheme security `shhkey` was added to the API
- **2026-04-03** (v3) `a2db5a1982ba`: 1 info
  - api operation id `get-/crm/v3/objects/leads/{leadsId}_getById` removed and replaced with `get-/crm/v3/objects/leads/{leadsId}`
- **2026-02-10** (v3) `87952be55451`: 1 info
  - added the optional property `url` to the response with the `200` status
- **2025-12-11** (v3) `ecbc03cc76f7`: 2 info
  - the endpoint scheme security `oauth2_legacy` was removed from the API
  - the endpoint scheme security `private_apps_legacy` was removed from the API
- **2025-12-10** (v3) `1dbab5598cdf`: 6 info
  - the endpoint scheme security `oauth2_legacy` was added to the API
  - the security scope `crm.objects.leads.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.objects.leads.read` was added to the endpoint's security scheme `private_apps`
  - the security scope `contacts` was removed from the endpoint's security scheme `private_apps_legacy`
  - the security scope `crm.objects.deals.highly_sensitive.write` was removed from the endpoint's security scheme `private_apps`
  - the security scope `crm.objects.services.read` was removed from the endpoint's security scheme `oauth2`
- **2025-12-09** (v3) `710cc5a6f48a`: 6 info
  - the endpoint scheme security `oauth2_legacy` was removed from the API
  - the security scope `contacts` was added to the endpoint's security scheme `private_apps_legacy`
  - the security scope `crm.objects.listings.write` was added to the endpoint's security scheme `private_apps`
  - the security scope `crm.objects.orders.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.objects.leads.read` was removed from the endpoint's security scheme `oauth2`
  - the security scope `crm.objects.leads.read` was removed from the endpoint's security scheme `private_apps`
- **2025-11-21** (v3) `3b6d09f1e471`: 2 warning
  - deleted the `path` request parameter `objectId`
  - deleted the `path` request parameter `objectType`

---

[Operation](https://skmtc.dev/hubspot/apis/crm-leads/docs/crm/v3/objects/leads/:leadsId/get.md) - [API](https://skmtc.dev/hubspot/apis/crm-leads.md) - [Page](https://skmtc.dev/hubspot/apis/crm-leads/changes/crm/v3/objects/leads/:leadsId/get)
