# The Deals API v1 is deprecated

HubSpot API deprecated /deals/v1/* without giving a shutdown date yet.

- API: HubSpot API (api.hubapi.com)
- Kind: Version retirement
- Announced: September 15, 2026
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `/deals/v1/*`
- Source: [Announcement](https://developers.hubspot.com/changelog/legacy-apis-and-legacy-apps-whats-going-unsupported-and-when)
- Page: https://www.okapi.bot/providers/hubspot-api/breaking-changes/the-deals-api-v1-is-deprecated/

## What to use instead

Move to the Deals API on date-based versioning (/crm/objects/2026-09/deals).

HubSpot has not finalized every legacy endpoint's date-based replacement yet; it documents them in its March 2027 release.

## HubSpot API's words

> Endpoints using numbered version paths, /v1/ , /v2/ , and /v3/ , will move to unsupported status. HubSpot will no longer release bug fixes, reliability improvements, or security updates for these versions.