iOS

iOS SubscriptionPromotionalOffers API

The SubscriptionPromotionalOffers API from iOS — 4 operation(s) for subscriptionpromotionaloffers.

GitHub OpenAPI
Business capability
Discount & Promotion Management BC-440.30

Operations 6

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v1/subscriptionPromotionalOffers Create a subscription promotional offer · Create Subscription Promotional Offers #
Ask an LLM
“How do I create a promotional offer for an auto-renewable subscription?”
“Can I set territory prices when creating a promo offer?”
Tell an agent
Create a subscription promotional offer with {data}.
Set up a promo offer using {data} and the price records {included}.
GET /v1/subscriptionPromotionalOffers/{id} Get a subscription promotional offer · Get Subscription Promotional Offers #
Ask an LLM
“Can I look up a single promotional offer by ID?”
“What duration, mode and code does a promo offer have?”
Tell an agent
Show promotional offer {id}.
Fetch subscription promo offer {id} including {include}.
PATCH /v1/subscriptionPromotionalOffers/{id} Update a promotional offer's prices · Update Subscription Promotional Offers #
Ask an LLM
“Can I change the prices of an existing promotional offer?”
“How do I edit a subscription promo offer after it exists?”
Tell an agent
Update promotional offer {id} with {data}.
Change promo offer {id} using {data} and new price records {included}.
DELETE /v1/subscriptionPromotionalOffers/{id} Delete a subscription promotional offer · Delete Subscription Promotional Offers #
Ask an LLM
“How do I remove a promotional offer from a subscription?”
“Can I delete a promo offer I no longer want to give?”
Tell an agent destructive · confirm first
Delete promotional offer {id}.
Remove subscription promo offer {id}.
GET /v1/subscriptionPromotionalOffers/{id}/relationships/prices List IDs of a promo offer's prices · List Related Subscription Promotional Offers / Prices #
Ask an LLM
“Can I get just the price IDs attached to a promotional offer?”
“Which price identifiers belong to a promo offer?”
Tell an agent
Give me the price IDs for promotional offer {id}.
Return {limit} price linkages for promo offer {id}.
GET /v1/subscriptionPromotionalOffers/{id}/prices List a promo offer's prices by territory · List Related Subscription Promotional Offers / Prices #
Ask an LLM
“What does my promotional offer cost in each country?”
“Can I see a promo offer's price in one specific territory?”
Tell an agent
Show the prices for promotional offer {id}.
Show the price of promo offer {id} in territory {territory}.

Documentation

📖
Documentation
https://developer.apple.com/documentation/appstoreconnectapi
📖
APIReference
https://developer.apple.com/documentation/appstoreconnectapi
📖
GettingStarted
https://developer.apple.com/documentation/appstoreconnectapi/creating-api-keys-for-app-store-connect-api
📖
Authentication
https://developer.apple.com/documentation/appstoreconnectapi/generating-tokens-for-api-requests

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/ios/refs/heads/main/openapi/ios-subscriptionpromotionaloffers-api-openapi.yml

Other Resources

🔗
ReleaseNotes
https://developer.apple.com/documentation/appstoreconnectapi/app-store-connect-api-release-notes
🔗
SDKs
https://github.com/apple/app-store-server-library-swift
🔗
SDKs
https://github.com/apple/app-store-server-library-java
🔗
SDKs
https://github.com/apple/app-store-server-library-python
🔗
SDKs
https://github.com/apple/app-store-server-library-node

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/ios:ios-subscriptionpromotionaloffers-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

ios-subscriptionpromotionaloffers-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: App Store Connect Subscription Promotional Offers API
  version: 4.3.1
  x-platforms:
    app_store_connect_api: App Store Connect API
  description: The App Store Connect API is the standards-based REST API Apple provides to automate tasks across App Store Connect, Xcode, and Certificates, Identifiers & Profiles.
servers:
- url: https://api.appstoreconnect.apple.com/
security:
- itc-bearer-token: []
tags:


# --- truncated at 32 KB (37 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/ios/refs/heads/main/openapi/ios-subscriptionpromotionaloffers-api-openapi.yml