---
title: "Changes to Translate Legacy List Id to Modern List Id"
method: GET
path: "/crm/v3/lists/idmapping"
---

# Changes to Translate Legacy List Id to Modern List Id

`GET /crm/v3/lists/idmapping`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 57 revisions.

- **2026-08-27** (v3) `2e56a90bc1ec` — 2 info
- **2026-08-17** (v3) `b30ec906b483` — 1 info
- **2026-07-13** (v3) `67789812a095` — 1 breaking
- **2026-05-22** (v3) `9dd2c1d75e65` — 2 info
- **2026-05-04** (v3) `d50f0570b85e` — 1 info

## Changes

- **2026-08-27** (v3) `2e56a90bc1ec` — 2 info
  - the security scope `crm.segments.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `crm.lists.read` was removed from the endpoint's security scheme `oauth2`
- **2026-08-17** (v3) `b30ec906b483` — 1 info
  - endpoint added
- **2026-07-13** (v3) `67789812a095` — 1 breaking
  - api path removed without deprecation
- **2026-05-22** (v3) `9dd2c1d75e65` — 2 info
  - the security scope `crm.lists.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `ils-lists-read` was removed from the endpoint's security scheme `oauth2`
- **2026-05-04** (v3) `d50f0570b85e` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/hubspot/apis/crm-lists/docs/crm/v3/lists/idmapping/get.md) · [API](https://skmtc.dev/hubspot/apis/crm-lists.md) · [Page](https://skmtc.dev/hubspot/apis/crm-lists/changes/crm/v3/lists/idmapping/get)