# /v1/* is deprecated

Circle CCTP API deprecated /v1/* without giving a shutdown date yet.

Deprecation of /v1/* begins on October 31, 2026, and completes on December 1, 2026, when these endpoints fail in favor of CCTP V2. All calls to /v1/* are affected across iris-api.circle.com.

## What to use instead

Use the CCTP V2 API by calling GET /v2/messages/{sourceDomainId}?transactionHash={hash} for messages and attestations, along with GET /v2/publicKeys. The transition requires more than updating endpoints, as CCTP V2 uses new contracts at new addresses, new ABIs, and a Fast Transfer fee.

CCTP V2 uses new contracts at new addresses, new ABIs and a Fast Transfer fee: the onchain integration moves too, not only the API calls.

- API: Circle CCTP API (iris-api.circle.com)
- Kind: Version retirement
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `/v1/*`
- Source: [Announcement](https://developers.circle.com/cctp/migration-from-v1-to-v2)
- Verified: October 27, 2026, against Circle CCTP API's own pages
- Page: https://www.okapi.bot/providers/circle-cctp-api/breaking-changes/v1-is-deprecated/

## Circle CCTP API's words

> CCTP V1 (Legacy) deprecation begins October 31, 2026 and completes on December 1, 2026, in favor of CCTP V2.

Okapi finds the calls this change hits in your repo and opens the pull request with the fix: https://github.com/apps/okapi-agent