# GET /v1/appTags/{}/territories is deprecated

App Store Connect API deprecated GET /v1/appTags/{id}/territories without giving a shutdown date yet.

App Store Connect API deprecated the endpoint GET /v1/appTags/{id}/territories on September 22, 2026, without a shutdown date. App Store Connect API also marked the territories relationship on app tags as deprecated along with the related territory listing endpoints. Calls to this endpoint will eventually fail.

## What to use instead

Stop reading territories per app tag, and list app tags using GET /v1/apps/{id}/appTags without territories values instead. The territories of an app tag have no replacement endpoint, so this change requires adjusting workflows that rely on that data.

The territories of an app tag have no replacement endpoint.

- API: App Store Connect API (api.appstoreconnect.apple.com)
- Kind: Endpoint removal
- Announced: September 22, 2026
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `GET /v1/appTags/{id}/territories`
- Source: [Announcement](https://developer.apple.com/documentation/appstoreconnectapi/app-store-connect-api-4-5-release-notes.md)
- Verified: November 6, 2026, against App Store Connect API's own pages
- Page: https://www.okapi.bot/providers/app-store-connect-api/breaking-changes/get-v1-apptags-territories-is-deprecated/

## App Store Connect API's words

> The territories relationship on app tags is now deprecated, along with the List Territories for an App Tag and List territory IDs for an app tag endpoints.

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