Okapi Okapi

App Store Connect API GET /v1/appTags/{id}/territories endpoint removal

Deprecated, no dateSubscribe to App Store Connect APIShare

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.


Calls it hits

  • GET /v1/appTags/{id}/territories

What to use instead of these calls

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.

In 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.

App Store Connect API, Announcement

Facts

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
Source
Announcement
Last updated
Verified
, against App Store Connect API's own pages

Questions

When does this change take effect?

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

Do these calls still work?

Yes, they still work: App Store Connect API has not given a shutdown date yet.

How do I find the calls this hits in my code?

Okapi reads your repository, finds the calls this change hits and opens a pull request with the fix. It never commits to your branches: every change comes as a pull request you review.


More from App Store Connect API 10

  1. No date /v1/appEventScreenshots/{id}Endpoint removal Deprecated, no date
  2. No date /v1/appEventVideoClips/{id}Endpoint removal Deprecated, no date
  3. No date /v1/appPreviews/{id}Endpoint removal Deprecated, no date
  4. No date /v1/appPreviewSets/{id}Endpoint removal Deprecated, no date
  5. No date /v1/appScreenshots/{id}Endpoint removal Deprecated, no date
  6. No date /v1/appScreenshotSets/{id}Endpoint removal Deprecated, no date
  7. No date /v1/inAppPurchaseLocalizations/{id}Endpoint removal Deprecated, no date
  8. No date /v1/subscriptionLocalizations/{id}Endpoint removal Deprecated, no date
  9. No date DELETE /v1/appStoreVersionExperiments/{id}Endpoint removal Deprecated, no date
  10. No date GET /v1/appStoreVersionExperiments/{id}Endpoint removal Deprecated, no date

Is your code calling this?

Okapi finds the calls this change hits in your repo and opens the pull request with the fix.

Add to GitHub

Get notifications

Subscribe to App Store Connect API

Hear about each breaking change App Store Connect API announces, in your feed reader, calendar or Slack.

1What to follow

Provider
  • App Store Connect API

2Where to get it

/breaking-changes/feed.xml

Paste it into Feedly, Inoreader, NetNewsWire or any reader. New changes show up as they're announced.