Okapi Okapi

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

Deprecated, no dateSubscribe to App Store Connect APIShare

Apple has deprecated GET /v1/appTags/{id}/relationships/territories without a shutdown date. The change affects calls to the territories relationship on app tags, which will eventually fail. App Store Connect API noted that the relationship is now deprecated alongside endpoints that list territories and territory IDs for an app tag.


Calls it hits

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

What to use instead of these calls

Stop reading territories per app tag, as the territories of an app tag have no replacement endpoint. List app tags using GET /v1/apps/{id}/appTags without territories values.

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}/relationships/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.