# API version Open API v2 stops working

Calls to /v2/* on Etsy Open API stopped working on April 3, 2023.

On April 3, 2023, Open API v2 was turned off. This retirement affected all calls to /v2/* endpoints. After this date, any requests sent to these endpoints fail.

## What to use instead

Use Open API v3 (/v3/application/...) with OAuth 2.0 tokens and an x-api-key header. The transition requires more than updating an identifier, as Open API v3 uses different endpoints and requires new OAuth 2.0 authorization from every connected shop.

Open API v3 has other endpoints and needs OAuth 2.0 authorization from every connected shop again.

- API: Etsy Open API (openapi.etsy.com)
- Kind: Version retirement
- Takes effect: April 3, 2023
- Calls after that day: fail
- Calls it hits: `/v2/*`
- Source: [Announcement](https://github.com/etsy/open-api/discussions/920)
- Verified: November 6, 2026, against Etsy Open API's own pages
- Page: https://www.okapi.bot/providers/etsy-open-api/breaking-changes/api-version-open-api-v2-stops-working/

## Etsy Open API's words

> As of Monday, April 3, 2023 v2 will be turned off and any requests to v2 endpoints will fail.

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