Appstore Connect

Register a new bundle ID in App Store Connect. The identifier must be unique and follow reverse-domain notation (e.g., com.example.app).

Add a locale with promotional text to a custom product page version. Fails if the locale already exists on that version.

Create a new version of a custom product page, optionally with a deep link. Add localizations with create_cpp_localization.

Create a custom product page for an app, with its first version and one localization (the app's primary locale unless locale is given).

Create an export compliance (encryption) declaration for an app. All four compliance answers are required.

Create a custom end user license agreement for an app, applied to the given territories (e.g. USA, GBR).

Create a custom redemption code for an offer code. The code string is redeemable immediately by anyone who knows it.

Create an in-app purchase offer code with a price per territory. Each price needs a territory ID and a price point ID from list_in_app_purchase_price_points.

Generate a batch of one-time-use redemption codes for an offer code. The generated codes are redeemable immediately.

Create a new in-app purchase. Defaults to NON_CONSUMABLE — a one-time 'lifetime' purchase that permanently unlocks the app. After creating, add a localization, set a price, and set availability before submitting for review. productId and type cannot be changed later.

Add a localized display name (and optional description) for an in-app purchase. At least one localization is required before submission.

Create an introductory offer for a subscription in one territory. Paid offers need pricePointId; free trials must omit it.

Create a phased release for an App Store version. Use update_phased_release to change its state afterwards.

Create an app preview set for one device type in an App Store version localization. Add videos to it with upload_app_preview.

Create a promotional offer for a subscription. Use offerMode FREE_TRIAL for a trial offer (prices optional: territories only, no price points). Use PAY_AS_YOU_GO or PAY_UP_FRONT for discounted paid offers and supply a price point per territory. The offerCode is the string customers redeem. Name, code, duration, mode, and periods cannot be changed later.

Create App Review details for a version that has none. contactFirstName and contactPhone are required.

Publish a developer response to a customer review. Apple replaces any existing response, and the text is public on the App Store.

Create a review submission for one platform of an app. Items are added afterwards with add_review_submission_item.

Create a screenshot set for one device display size in an App Store version localization. Add screenshots to it with upload_screenshot.

Create a new auto-renewable subscription within a subscription group.

Create a custom (vanity) redemption code for a subscription offer code, optionally with an expiration date.

Create a new subscription group for an app. A subscription group must be created before adding individual subscriptions to it.

Create a localization for a subscription group. Provides the localized group name shown to users on the App Store subscription management page.

Create a localized name and description for a subscription in a specific locale.

Create a subscription offer code. Paid offers (PAY_AS_YOU_GO, PAY_UP_FRONT) need at least one price; use list_subscription_price_points to find price point IDs.

Generate a batch of one-time use redemption codes for a subscription offer code. Use get_subscription_one_time_code_values to download them.

Set the price for a subscription in a specific territory. Use list_subscription_price_points to find the price point ID for the desired price tier. The price takes effect on startDate (or immediately if null).

Create a new localization for an App Store version. Add descriptions, keywords, and other metadata in a specific locale.

Create a win-back offer for lapsed subscribers, with one price entry per territory. Paid offers need a pricePointId on every price; free trials must omit it.

Delete an analytics report request. This stops report generation and removes access to existing reports.

Delete an app info localization.

Delete one app preview from its preview set.

Delete an App Store version. Only versions that were never submitted can be deleted.

Delete the TestFlight app details for one locale.

Delete the 'What to Test' notes of a build for one locale.

Delete a beta group.

Delete a beta tester from the account. The tester is removed from all beta groups and apps.

Delete a bundle ID. Note: This cannot be undone and may affect apps using this bundle ID.

Delete a custom product page localization by ID.

Delete a custom product page by ID.

Delete an app's custom end user license agreement.

Delete an in-app purchase. Only possible before it has been approved/sold.

Delete an in-app purchase localization.

Delete an introductory offer by ID.

Delete a phased release for an App Store version.

Delete an app preview set and every app preview in it.

Delete a promotional offer from a subscription.

Delete a developer response to a customer review. This removes the public reply from the App Store.

Delete one screenshot from its screenshot set.

Delete a screenshot set and every screenshot in it.

Delete an auto-renewable subscription. Only subscriptions in MISSING_METADATA or DEVELOPER_REMOVED_FROM_SALE state can be deleted.

Delete a localization for a subscription.

Delete a version localization. Cannot delete the primary locale.

Delete a win-back offer by ID.

Download and parse an analytics report segment from its pre-signed URL. The segment data is gzip-compressed TSV. Returns parsed headers and rows (as key-value objects). Use list_analytics_report_segments to get the download URL first.

Get the age rating questionnaire answers for an app info record.

Get details of a specific analytics report request.

Get detailed information about a specific app by its ID.

Get app availability information, including which territories the app is available in.

Get the primary and secondary App Store categories and subcategories of an app info record. Unset slots are null.

Get performance and power metrics for an app (e.g., launch time, memory, battery, hangs). Returns Xcode-style metrics data with values per device and percentile. Use this for app-level aggregate metrics across all builds.

Get the price schedule for an app, including pricing information.

Get detailed information about a specific app version.

Get the build attached to an App Store version (null when none is attached).

Get the TestFlight beta App Review details for an app: contact, demo account, and notes. The demo password is never returned; demoAccountPasswordSet shows whether one exists.

Get a beta group's settings, including its public TestFlight link.

Get details of a specific build.

Get the TestFlight settings and processing states for a build (auto-notify, internal and external state).

Get performance and power metrics for a specific build. Same metric types as get_app_perf_metrics but scoped to a single build. Useful for comparing performance between builds.

Get details of a specific bundle ID.

Get one custom product page by ID.

Get one customer review by ID, including its developer response when one exists.

Get details of a specific registered device.

Get one export compliance (encryption) declaration by ID.

Get the custom end user license agreement for an app. Returns null when the app has none.

Download and parse a finance report from App Store Connect. Returns financial report data as structured rows. Your vendor number can be found in App Store Connect under Settings > Agreements, Tax, and Banking. The regionCode is a 1-2 letter code representing the financial region (e.g., 'US' for United States, 'EU' for Europe, 'JP' for Japan, 'Z1' for rest of world). Report date must be in YYYY-MM format. Reports are typically available 30-45 days after the end of the fiscal month. Use FINANCIAL for revenue summary or FINANCE_DETAIL for line-item details.

Get one in-app purchase offer code by ID.

Get the redemption code values of a one-time-use batch as CSV, inline or (for large batches) to a new file via savePath, with the number of non-empty lines. The codes are sensitive.

Get details of a specific in-app purchase, including its state and product ID.

Get the territory availability of an in-app purchase, including which territories it is available in.

Get Apple's equivalent price points in other territories for an in-app purchase price point — the core Purchase Power Parity (PPP) data for one-time purchases. Use list_in_app_purchase_price_points to get a base price point ID, then feed the per-territory results into set_in_app_purchase_price.

Get the phased release (gradual rollout) of an App Store version. Returns null when the version has no phased release.

Get Apple's equivalent price points in other territories for a given price point. This is the core Purchase Power Parity (PPP) data — shows what Apple considers equivalent pricing across countries. Use list_app_price_points first to get a price point ID.

Get the App Review details for a version: contact, demo account, and review notes. The demo password is never returned; demoAccountPasswordSet shows whether one exists.

Get the developer response to a customer review (null when there is none).

Get a review submission with the items it contains. Each item lists the IDs of the resources it links to.

Download and parse a sales report from App Store Connect. Returns tab-delimited report data as structured rows. Your vendor number can be found in App Store Connect under Settings > Agreements, Tax, and Banking. Valid report type and sub-type combinations: SALES + SUMMARY (daily/weekly/monthly/yearly), SUBSCRIPTION + SUMMARY (daily), SUBSCRIPTION_EVENT + SUMMARY (daily), SUBSCRIBER + DETAILED (daily), PRE_ORDER + SUMMARY (daily/weekly/monthly). Report date format varies by frequency: DAILY = YYYY-MM-DD, WEEKLY = YYYY-MM-DD (Sunday start), MONTHLY = YYYY-MM, YEARLY = YYYY.

Get details of a specific auto-renewable subscription by its ID.

Get the territory availability configuration for a subscription — shows which territories it is available in and whether it is automatically available in new territories.

Get details of a specific subscription group by its ID.

Get a single subscription group localization by its ID. Returns the localized name, locale, custom app name, and description.

Get one subscription offer code by ID, including its code counts and state.

Download the redemption codes of a one-time use code batch as CSV, inline or (for large batches) to a new file via savePath. The codes are sensitive: treat the output as secret.

Get details of a specific team user.

Get detailed information about a specific version localization.

Send an existing beta tester an invitation to test an app.

List report instances (dated snapshots) for an analytics report. Each instance represents data for a specific processing date. Can filter by granularity (DAILY, WEEKLY, MONTHLY) and processing date.

List all analytics report requests for an app. Shows whether each request is active or stopped due to inactivity.

List downloadable segments for a report instance. Each segment contains a URL for downloading the report data, along with its checksum and size.

List analytics reports available for a report request. Can filter by category (APP_STORE_ENGAGEMENT, COMMERCE, APP_USAGE, FRAMEWORKS_USAGE, PERFORMANCE).

List all app categories available in the App Store. Can filter by platform.

List all localizations for an app info. Returns app name, subtitle, and privacy policy info for each locale.

List app info records for an app. Use this to get the appInfoId needed for localization operations.

List available price points for an app. Each price point represents a possible price tier showing customer price and developer proceeds in local currency. Filter by territory to see prices for a specific country.

List the subcategories of an App Store category, for example the subcategories of GAMES.

List all App Store versions for an app. Can filter by platform and version state.

List all apps in your App Store Connect account. Returns app IDs, names, bundle IDs, and SKUs.

List the TestFlight app details (description, feedback email, URLs) for an app, one per locale.

List the TestFlight 'What to Test' notes for a build, one per locale. Use list_builds to find build IDs.

List the builds available to a beta group.

List all beta groups for an app. Returns group names, public link info, and settings.

List the TestFlight beta App Review submissions for a build, optionally filtered by review state.

List all beta testers in a specific beta group.

List all builds for an app.

List all bundle IDs registered in App Store Connect. Can filter by platform.

List the per-locale localizations of a custom product page version, optionally filtered by locale.

List the versions of a custom product page, optionally filtered by review state.

List the custom product pages of an app, optionally filtered by visibility.

List customer reviews for an app, each with its developer response when one exists. Newest first by default.

List all registered devices in App Store Connect. Can filter by platform and status.

List diagnostic logs for a specific diagnostic signature. Returns individual log entries for a given performance issue. Use list_diagnostic_signatures first to get a signature ID.

List power and performance diagnostic signatures for a build. Signatures represent recurring performance issues (disk writes, hangs, slow launches) grouped by call stack. Use list_diagnostic_logs with a signature ID to get detailed logs.

List export compliance (encryption) declarations for an app.

List the custom redemption codes for an offer code, with redemption counts and expiry dates.

List the offer codes configured for an in-app purchase. Returns names, eligibility, active state, and code counts.

List the one-time-use code batches generated for an offer code, with counts and expiry dates.

List the localized display names and descriptions for an in-app purchase.

List available price points for an in-app purchase, showing customer price and developer proceeds. Filter by territory to find a price point ID for set_in_app_purchase_price. Supports offset-based pagination.

List the current per-territory prices set for an in-app purchase, with resolved customer price and territory. Returns developer-set (manual) prices by default; set includeAutomatic to also include Apple's auto-equalized prices. Use this to read existing pricing or verify a set_in_app_purchase_price change.

List in-app purchases for an app. Covers one-time purchases — non-consumable (a 'lifetime' unlock), consumable, and non-renewing. Optionally filter by type.

List introductory offers for a subscription, with territory and price point IDs. Optionally filter by territory.

List the TestFlight pre-release versions (version string and platform) of an app.

List the app preview sets (one per device type) in an App Store version localization.

List the app previews (videos) in an app preview set.

List the prices set for a promotional offer, with resolved price tier and territory details.

List all promotional offers configured for a subscription. Promotional offers target existing or previously subscribed customers via offer codes.

List review submissions for an app, optionally filtered by state or platform. Use the returned IDs with get_review_submission.

List all screenshot sets for a version localization. Each set represents a different display type (device size).

List all screenshots in a screenshot set.

List the custom codes created for a subscription offer code.

List the localizations for a subscription group. These provide the localized name shown to users on the subscription management page.

List all subscription groups for an app. Subscription groups contain auto-renewable subscriptions and define upgrade/downgrade relationships.

List all localizations (translated names and descriptions) for a subscription.

List the offer codes for a subscription, optionally filtered by territory codes such as USA.

List the one-time use code batches generated for a subscription offer code.

List available price points for a subscription, showing customer price and developer proceeds. Optionally filter by territory. Use offset to paginate beyond the first 200 results.

List the current prices set for a subscription, including price tier and territory details. Use this to read existing pricing before making changes.

List all auto-renewable subscriptions within a subscription group.

List all App Store territories (countries/regions) with their currencies. Useful for understanding which markets are available for pricing.

List all users in your App Store Connect team. Can filter by roles.

List all localizations for an App Store version. Returns description, keywords, what's new, and URLs for each locale.

List the per-territory prices of a win-back offer, with territory and price point IDs. Optionally filter by territory.

List win-back offers for a subscription.

Release an App Store version that is approved and waiting for developer release (PENDING_DEVELOPER_RELEASE). The version becomes available to users.

Remove a beta tester from a beta group.

Remove one or more builds from a beta group. The builds themselves are kept, and testers in the group lose access to them.

Remove an item from a review submission. Get item IDs from get_review_submission.

Set the display order of the app previews in a preview set. previewIds must list every current preview in the set exactly once, in the new order; get the IDs with list_previews.

Set the display order of the screenshots in a set. screenshotIds must list every current screenshot in the set exactly once, in the new order; get the IDs with list_screenshots.

Set or clear App Store categories and subcategories on an app info record. Only the slots provided are changed (at least one); pass null to clear a slot, e.g. remove the secondary category.

Set per-territory manual pricing for an app (Purchase Power Parity). WARNING: This replaces the entire price schedule — include ALL territory prices, not just changes. The base territory price must be included in manualPrices. Use list_app_price_points and get_price_point_equalizations to find price point IDs first.

Attach a build to an App Store version. The build must have finished processing (VALID); use list_builds to find build IDs.

Set the territory availability of an in-app purchase. Set availableInNewTerritories to auto-enable future App Store territories, and optionally restrict to a specific list of territories.

Set pricing for an in-app purchase. WARNING: This replaces the entire price schedule. Provide only the base territory to let Apple auto-equalize all other territories, or provide a full per-territory list for manual Purchase Power Parity (PPP) pricing. Use list_in_app_purchase_price_points to find price point IDs. The base territory's price point must be included in manualPrices.

Set the territory availability for a subscription. Controls which countries/regions the subscription is available in, and whether it is automatically available in new territories Apple adds.

Submit a build to TestFlight beta App Review so it can be shared with external testers.

Submit an in-app purchase to App Review. This is an outward-facing action: the purchase must already have metadata, a localization, a price, and availability set. App Store Connect also typically requires a review screenshot on the in-app purchase before it can pass review; upload one with upload_iap_review_screenshot. Can be submitted independently of an app version.

Submit a review submission to App Review. It is refused unless its items exactly match expectedItemIds; nothing is removed or added.

Update age rating questionnaire answers. Only the attributes provided are changed; socialMedia cannot be true while userGeneratedContent is false.

Update an app info localization. Use this to change app name, subtitle, or privacy policy URL for a locale.

Update an App Store version's version string, copyright, release type, or scheduled release date. Only the fields provided are changed.

Update the TestFlight app details for one locale. Only the fields provided are changed.

Update the TestFlight beta App Review details (contact, demo account, notes). Only the fields provided are changed. Get the ID from get_beta_app_review_detail.

Replace the 'What to Test' notes of a build localization. Get the ID from list_beta_build_localizations.

Update a beta group's settings. Only the fields provided are changed; the group's internal flag and build access cannot be changed here.

Update a build's usesNonExemptEncryption flag, its encryption declaration, or expire it. Expiring ends TestFlight testing of the build and requires confirmExpire=true.

Turn automatic tester notifications on or off for a build. Get the ID from get_build_beta_detail.

Update a bundle ID's name. Note: The identifier cannot be changed.

Set the promotional text of a custom product page localization. Pass null to clear it.

Update a custom product page's name or visibility. Only the fields provided are changed.

Update an app's custom EULA text and/or territories. Only the fields provided are changed; territories replaces the current list.

Activate or deactivate an in-app purchase offer code. Deactivating stops new redemptions of its codes.

Update an in-app purchase's reference name, Family Sharing setting, or review note. productId and type are immutable.

Update the display name or description of an in-app purchase localization.

Change the end date of an introductory offer. Pass null as endDate to remove the end date.

Change a phased release to ACTIVE, PAUSED, or COMPLETE. COMPLETE releases the version to all users immediately and requires confirmReleaseToAll=true.

Replace a promotional offer's per-territory price list. Apple allows no other changes: to change the name, code, duration, mode, or periods, delete the offer and create a new one.

Update App Review details (contact, demo account, notes). Only the fields provided are changed. Get the ID from get_review_detail.

Update the metadata of an existing auto-renewable subscription.

Update the reference name of a subscription group.

Update an existing subscription group localization. Can update the group name, custom app name, or custom app description.

Update the localized name or description for a subscription localization.

Activate or deactivate a subscription offer code. Deactivating stops new redemptions and cannot be undone for customers who already hold the code.

Update an existing version localization. Only provided fields will be updated.

Update a win-back offer's eligibility, dates, priority, or promotion intent. Only the fields provided are changed.

Upload a .mov, .m4v, or .mp4 video as an app preview. A preview set holds at most 3 previews.

Upload the App Review screenshot for an in-app purchase from a local file.

Upload a new screenshot to a screenshot set. Provide the local file path, and this tool will handle the multi-step upload process.

Upload the App Review screenshot for a subscription from a local file.