iOS

iOS Apps API

The Apps API from iOS — 84 operation(s) for apps.

GitHub OpenAPI

Operations 86

GET /v1/apps List Apps #
GET /v1/apps/{id} Get Apps #
PATCH /v1/apps/{id} Update Apps #
GET /v1/apps/{id}/relationships/accessibilityDeclarations List Related Apps / Accessibility Declarations #
GET /v1/apps/{id}/accessibilityDeclarations List Related Apps / Accessibility Declarations #
GET /v1/apps/{id}/relationships/alternativeDistributionKey Get Related Apps / Alternative Distribution Key #
GET /v1/apps/{id}/alternativeDistributionKey Get Related Apps / Alternative Distribution Key #
GET /v1/apps/{id}/relationships/analyticsReportRequests List Related Apps / Analytics Report Requests #
GET /v1/apps/{id}/analyticsReportRequests List Related Apps / Analytics Report Requests #
GET /v1/apps/{id}/relationships/androidToIosAppMappingDetails List Related Apps / Android to Ios App Mapping Details #
GET /v1/apps/{id}/androidToIosAppMappingDetails List Related Apps / Android to Ios App Mapping Details #
GET /v1/apps/{id}/relationships/appAvailabilityV2 Get Related Apps / App Availability V2 #
GET /v1/apps/{id}/appAvailabilityV2 Get Related Apps / App Availability V2 #
GET /v1/apps/{id}/relationships/appClips List Related Apps / App Clips #
GET /v1/apps/{id}/appClips List Related Apps / App Clips #
GET /v1/apps/{id}/relationships/appCustomProductPages List Related Apps / App Custom Product Pages #
GET /v1/apps/{id}/appCustomProductPages List Related Apps / App Custom Product Pages #
GET /v1/apps/{id}/relationships/appEncryptionDeclarations List Related Apps / App Encryption Declarations #
GET /v1/apps/{id}/appEncryptionDeclarations List Related Apps / App Encryption Declarations #
GET /v1/apps/{id}/relationships/appEvents List Related Apps / App Events #
GET /v1/apps/{id}/appEvents List Related Apps / App Events #
GET /v1/apps/{id}/relationships/appInfos List Related Apps / App Infos #
GET /v1/apps/{id}/appInfos List Related Apps / App Infos #
GET /v1/apps/{id}/relationships/appPricePoints List Related Apps / App Price Points #
GET /v1/apps/{id}/appPricePoints List Related Apps / App Price Points #
GET /v1/apps/{id}/relationships/appPriceSchedule Get Related Apps / App Price Schedule #
GET /v1/apps/{id}/appPriceSchedule Get Related Apps / App Price Schedule #
GET /v1/apps/{id}/relationships/appStoreVersionExperimentsV2 List Related Apps / App Store Version Experiments V2 #
GET /v1/apps/{id}/appStoreVersionExperimentsV2 List Related Apps / App Store Version Experiments V2 #
GET /v1/apps/{id}/relationships/appStoreVersions List Related Apps / App Store Versions #
GET /v1/apps/{id}/appStoreVersions List Related Apps / App Store Versions #
GET /v1/apps/{id}/relationships/appTags List Related Apps / App Tags #
GET /v1/apps/{id}/appTags List Related Apps / App Tags #
GET /v1/apps/{id}/relationships/backgroundAssets List Related Apps / Background Assets #
GET /v1/apps/{id}/backgroundAssets List Related Apps / Background Assets #
GET /v1/apps/{id}/relationships/betaAppLocalizations List Related Apps / Beta App Localizations #
GET /v1/apps/{id}/betaAppLocalizations List Related Apps / Beta App Localizations #
GET /v1/apps/{id}/relationships/betaAppReviewDetail Get Related Apps / Beta App Review Detail #
GET /v1/apps/{id}/betaAppReviewDetail Get Related Apps / Beta App Review Detail #
GET /v1/apps/{id}/relationships/betaFeedbackCrashSubmissions List Related Apps / Beta Feedback Crash Submissions #
GET /v1/apps/{id}/betaFeedbackCrashSubmissions List Related Apps / Beta Feedback Crash Submissions #
GET /v1/apps/{id}/relationships/betaFeedbackScreenshotSubmissions List Related Apps / Beta Feedback Screenshot Submissions #
GET /v1/apps/{id}/betaFeedbackScreenshotSubmissions List Related Apps / Beta Feedback Screenshot Submissions #
GET /v1/apps/{id}/relationships/betaGroups List Related Apps / Beta Groups #
GET /v1/apps/{id}/betaGroups List Related Apps / Beta Groups #
GET /v1/apps/{id}/relationships/betaLicenseAgreement Get Related Apps / Beta License Agreement #
GET /v1/apps/{id}/betaLicenseAgreement Get Related Apps / Beta License Agreement #
DELETE /v1/apps/{id}/relationships/betaTesters Remove Related Apps / Beta Testers #
GET /v1/apps/{id}/relationships/buildUploads List Related Apps / Build Uploads #
GET /v1/apps/{id}/buildUploads List Related Apps / Build Uploads #
GET /v1/apps/{id}/relationships/builds List Related Apps / Builds #
GET /v1/apps/{id}/builds List Related Apps / Builds #
GET /v1/apps/{id}/relationships/ciProduct Get Related Apps / Ci Product #
GET /v1/apps/{id}/ciProduct Get Related Apps / Ci Product #
GET /v1/apps/{id}/customerReviewSummarizations List Related Apps / Customer Review Summarizations #
GET /v1/apps/{id}/relationships/customerReviews List Related Apps / Customer Reviews #
GET /v1/apps/{id}/customerReviews List Related Apps / Customer Reviews #
GET /v1/apps/{id}/relationships/endUserLicenseAgreement Get Related Apps / End User License Agreement #
GET /v1/apps/{id}/endUserLicenseAgreement Get Related Apps / End User License Agreement #
GET /v1/apps/{id}/relationships/gameCenterDetail Get Related Apps / Game Center Detail #
GET /v1/apps/{id}/gameCenterDetail Get Related Apps / Game Center Detail #
GET /v1/apps/{id}/relationships/gameCenterEnabledVersions List Related Apps / Game Center Enabled Versions #
GET /v1/apps/{id}/gameCenterEnabledVersions List Related Apps / Game Center Enabled Versions #
GET /v1/apps/{id}/relationships/inAppPurchases List Related Apps / in App Purchases #
GET /v1/apps/{id}/inAppPurchases List Related Apps / in App Purchases #
GET /v1/apps/{id}/relationships/inAppPurchasesV2 List Related Apps / in App Purchases V2 #
GET /v1/apps/{id}/inAppPurchasesV2 List Related Apps / in App Purchases V2 #
GET /v1/apps/{id}/relationships/marketplaceSearchDetail Get Related Apps / Marketplace Search Detail #
GET /v1/apps/{id}/marketplaceSearchDetail Get Related Apps / Marketplace Search Detail #
GET /v1/apps/{id}/perfPowerMetrics List Related Apps / Perf Power Metrics #
GET /v1/apps/{id}/relationships/preReleaseVersions List Related Apps / Pre Release Versions #
GET /v1/apps/{id}/preReleaseVersions List Related Apps / Pre Release Versions #
GET /v1/apps/{id}/relationships/promotedPurchases List Related Apps / Promoted Purchases #
PATCH /v1/apps/{id}/relationships/promotedPurchases Replace Related Apps / Promoted Purchases #
GET /v1/apps/{id}/promotedPurchases List Related Apps / Promoted Purchases #
GET /v1/apps/{id}/relationships/reviewSubmissions List Related Apps / Review Submissions #
GET /v1/apps/{id}/reviewSubmissions List Related Apps / Review Submissions #
GET /v1/apps/{id}/relationships/searchKeywords List Related Apps / Search Keywords #
GET /v1/apps/{id}/searchKeywords List Related Apps / Search Keywords #
GET /v1/apps/{id}/relationships/subscriptionGracePeriod Get Related Apps / Subscription Grace Period #
GET /v1/apps/{id}/subscriptionGracePeriod Get Related Apps / Subscription Grace Period #
GET /v1/apps/{id}/relationships/subscriptionGroups List Related Apps / Subscription Groups #
GET /v1/apps/{id}/subscriptionGroups List Related Apps / Subscription Groups #
GET /v1/apps/{id}/relationships/webhooks List Related Apps / Webhooks #
GET /v1/apps/{id}/webhooks List Related Apps / Webhooks #
GET /v1/apps/{id}/metrics/betaTesterUsages Get Metrics Apps / Beta Tester Usages #

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-apps-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-apps-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-apps-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: App Store Connect AccessibilityDeclarations Apps 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. It covers apps, builds, TestFlight, in-app purchases, subscriptions, Game Center, Xcode Cloud, provisioning, pricing and availability, and the full reporting surface (analytics, sales and trends, financial reports, power and performance). This spec is the official OpenAPI 3.0 document published by Apple at https://developer.apple.com/app-store-connect/api/ — mirrored here unmodified except for title-cased operation summaries.
servers:
- url: https://api.appstoreconnect.apple.com/
security:
- itc-bearer-token: []
tags:
- name: Apps
paths:
  /v1/apps:
    get:
      tags:
      - Apps
      operationId: apps_getCollection
      parameters:
      - name: filter[name]
        in: query
        description: filter by attribute 'name'
        schema:
          type: array
          items:
            type: string
        style: form
        explode: false
        required: false
      - name: filter[bundleId]
        in: query
        description: filter by attribute 'bundleId'
        schema:
          type: array
          items:
            type: string
        style: form
        explode: false
        required: false
      - name: filter[sku]
        in: query
        description: filter by attribute 'sku'
        schema:
          type: array
          items:
            type: string
        style: form
        explode: false
        required: false
      - name: filter[appStoreVersions.appStoreState]
        in: query
        description: filter by attribute 'appStoreVersions.appStoreState'
        schema:
          type: array
          items:
            type: string
            enum:
            - ACCEPTED
            - DEVELOPER_REMOVED_FROM_SALE
            - DEVELOPER_REJECTED
            - IN_REVIEW
            - INVALID_BINARY
            - METADATA_REJECTED
            - PENDING_APPLE_RELEASE
            - PENDING_CONTRACT
            - PENDING_DEVELOPER_RELEASE
            - PREPARE_FOR_SUBMISSION
            - PREORDER_READY_FOR_SALE
            - PROCESSING_FOR_APP_STORE
            - READY_FOR_REVIEW
            - READY_FOR_SALE
            - REJECTED
            - REMOVED_FROM_SALE
            - WAITING_FOR_EXPORT_COMPLIANCE
            - WAITING_FOR_REVIEW
            - REPLACED_WITH_NEW_VERSION
            - NOT_APPLICABLE
        style: form
        explode: false
        required: false
        deprecated: true
      - name: filter[appStoreVersions.platform]
        in: query
        description: filter by attribute 'appStoreVersions.platform'
        schema:
          type: array
          items:
            type: string
            enum:
            - IOS
            - MAC_OS
            - TV_OS
            - VISION_OS
        style: form
        explode: false
        required: false
      - name: filter[appStoreVersions.appVersionState]
        in: query
        description: filter by attribute 'appStoreVersions.appVersionState'
        schema:
          type: array
          items:
            type: string
            enum:
            - ACCEPTED
            - DEVELOPER_REJECTED
            - IN_REVIEW
            - INVALID_BINARY
            - METADATA_REJECTED
            - PENDING_APPLE_RELEASE
            - PENDING_DEVELOPER_RELEASE
            - PREPARE_FOR_SUBMISSION
            - PROCESSING_FOR_DISTRIBUTION
            - READY_FOR_DISTRIBUTION
            - READY_FOR_REVIEW
            - REJECTED
            - REPLACED_WITH_NEW_VERSION
            - WAITING_FOR_EXPORT_COMPLIANCE
            - WAITING_FOR_REVIEW
        style: form
        explode: false
        required: false
      - name: filter[reviewSubmissions.state]
        in: query
        description: filter by attribute 'reviewSubmissions.state'
        schema:
          type: array
          items:
            type: string
            enum:
            - READY_FOR_REVIEW
            - WAITING_FOR_REVIEW
            - IN_REVIEW
            - UNRESOLVED_ISSUES
            - CANCELING
            - COMPLETING
            - COMPLETE
        style: form
        explode: false
        required: false
      - name: filter[reviewSubmissions.platform]
        in: query
        description: filter by attribute 'reviewSubmissions.platform'
        schema:
          type: array
          items:
            type: string
            enum:
            - IOS
            - MAC_OS
            - TV_OS
            - VISION_OS
        style: form
        explode: false
        required: false
      - name: filter[appStoreVersions]
        in: query
        description: filter by id(s) of related 'appStoreVersions'
        schema:
          type: array
          items:
            type: string
        style: form
        explode: false
        required: false
      - name: filter[id]
        in: query
        description: filter by id(s)
        schema:
          type: array
          items:
            type: string
        style: form
        explode: false
        required: false
      - name: exists[gameCenterEnabledVersions]
        in: query
        description: filter by existence or non-existence of related 'gameCenterEnabledVersions'
        schema:
          type: boolean
        style: form
        explode: false
        required: false
        deprecated: true
      - name: sort
        in: query
        description: comma-separated list of sort expressions; resources will be sorted as specified
        schema:
          type: array
          items:
            type: string
            enum:
            - name
            - -name
            - bundleId
            - -bundleId
            - sku
            - -sku
        style: form
        explode: false
        required: false
      - name: fields[apps]
        in: query
        description: the fields to include for returned resources of type apps
        schema:
          type: array
          items:
            type: string
            enum:
            - accessibilityUrl
            - name
            - bundleId
            - sku
            - primaryLocale
            - isOrEverWasMadeForKids
            - subscriptionStatusUrl
            - subscriptionStatusUrlVersion
            - subscriptionStatusUrlForSandbox
            - subscriptionStatusUrlVersionForSandbox
            - contentRightsDeclaration
            - streamlinedPurchasingEnabled
            - accessibilityDeclarations
            - appEncryptionDeclarations
            - appStoreIcon
            - ciProduct
            - betaTesters
            - betaGroups
            - appStoreVersions
            - appTags
            - preReleaseVersions
            - betaAppLocalizations
            - builds
            - betaLicenseAgreement
            - betaAppReviewDetail
            - appInfos
            - appClips
            - appPricePoints
            - endUserLicenseAgreement
            - appPriceSchedule
            - appAvailabilityV2
            - inAppPurchases
            - subscriptionGroups
            - gameCenterEnabledVersions
            - perfPowerMetrics
            - appCustomProductPages
            - inAppPurchasesV2
            - promotedPurchases
            - appEvents
            - reviewSubmissions
            - subscriptionGracePeriod
            - customerReviews
            - customerReviewSummarizations
            - gameCenterDetail
            - appStoreVersionExperimentsV2
            - alternativeDistributionKey
            - analyticsReportRequests
            - marketplaceSearchDetail
            - buildUploads
            - backgroundAssets
            - betaFeedbackScreenshotSubmissions
            - betaFeedbackCrashSubmissions
            - searchKeywords
            - webhooks
            - androidToIosAppMappingDetails
        style: form
        explode: false
        required: false
      - name: fields[appEncryptionDeclarations]
        in: query
        description: the fields to include for returned resources of type appEncryptionDeclarations
        schema:
          type: array
          items:
            type: string
            enum:
            - appDescription
            - createdDate
            - usesEncryption
            - exempt
            - containsProprietaryCryptography
            - containsThirdPartyCryptography
            - availableOnFrenchStore
            - platform
            - uploadedDate
            - documentUrl
            - documentName
            - documentType
            - appEncryptionDeclarationState
            - codeValue
            - app
            - builds
            - appEncryptionDeclarationDocument
        style: form
        explode: false
        required: false
      - name: fields[buildIcons]
        in: query
        description: the fields to include for returned resources of type buildIcons
        schema:
          type: array
          items:
            type: string
            enum:
            - iconAsset
            - iconType
            - masked
            - name
        style: form
        explode: false
        required: false
      - name: fields[ciProducts]
        in: query
        description: the fields to include for returned resources of type ciProducts
        schema:
          type: array
          items:
            type: string
            enum:
            - name
            - createdDate
            - productType
            - app
            - bundleId
            - workflows
            - primaryRepositories
            - additionalRepositories
            - buildRuns
        style: form
        explode: false
        required: false
      - name: fields[betaGroups]
        in: query
        description: the fields to include for returned resources of type betaGroups
        schema:
          type: array
          items:
            type: string
            enum:
            - name
            - createdDate
            - isInternalGroup
            - hasAccessToAllBuilds
            - publicLinkEnabled
            - publicLinkId
            - publicLinkLimitEnabled
            - publicLinkLimit
            - publicLink
            - feedbackEnabled
            - iosBuildsAvailableForAppleSiliconMac
            - iosBuildsAvailableForAppleVision
            - app
            - builds
            - betaTesters
            - betaRecruitmentCriteria
            - betaRecruitmentCriterionCompatibleBuildCheck
        style: form
        explode: false
        required: false
      - name: fields[appStoreVersions]
        in: query
        description: the fields to include for returned resources of type appStoreVersions
        schema:
          type: array
          items:
            type: string
            enum:
            - platform
            - versionString
            - appStoreState
            - appVersionState
            - copyright
            - reviewType
            - releaseType
            - earliestReleaseDate
            - usesIdfa
            - downloadable
            - createdDate
            - app
            - appStoreVersionLocalizations
            - build
            - appStoreVersionPhasedRelease
            - gameCenterAppVersion
            - routingAppCoverage
            - appStoreReviewDetail
            - appStoreVersionSubmission
            - appClipDefaultExperience
            - appStoreVersionExperiments
            - appStoreVersionExperimentsV2
            - customerReviews
            - alternativeDistributionPackage
        style: form
        explode: false
        required: false
      - name: fields[preReleaseVersions]
        in: query
        description: the fields to include for returned resources of type preReleaseVersions
        schema:
          type: array
          items:
            type: string
            enum:
            - version
            - platform
            - builds
            - app
        style: form
        explode: false
        required: false
      - name: fields[betaAppLocalizations]
        in: query
        description: the fields to include for returned resources of type betaAppLocalizations
        schema:
          type: array
          items:
            type: string
            enum:
            - feedbackEmail
            - marketingUrl
            - privacyPolicyUrl
            - tvOsPrivacyPolicy
            - description
            - locale
            - app
        style: form
        explode: false
        required: false
      - name: fields[builds]
        in: query
        description: the fields to include for returned resources of type builds
        schema:
          type: array
          items:
            type: string
            enum:
            - version
            - uploadedDate
            - expirationDate
            - expired
            - minOsVersion
            - lsMinimumSystemVersion
            - computedMinMacOsVersion
            - computedMinVisionOsVersion
            - iconAssetToken
            - processingState
            - buildAudienceType
            - usesNonExemptEncryption
            - preReleaseVersion
            - individualTesters
            - betaGroups
            - betaBuildLocalizations
            - appEncryptionDeclaration
            - betaAppReviewSubmission
            - app
            - buildBetaDetail
            - appStoreVersion
            - icons
            - buildBundles
            - buildUpload
            - perfPowerMetrics
            - diagnosticSignatures
        style: form
        explode: false
        required: false
      - name: fields[betaLicenseAgreements]
        in: query
        description: the fields to include for returned resources of type betaLicenseAgreements
        schema:
          type: array
          items:
            type: string
            enum:
            - agreementText
            - app
        style: form
        explode: false
        required: false
      - name: fields[betaAppReviewDetails]
        in: query
        description: the fields to include for returned resources of type betaAppReviewDetails
        schema:
          type: array
          items:
            type: string
            enum:
            - contactFirstName
            - contactLastName
            - contactPhone
            - contactEmail
            - demoAccountName
            - demoAccountPassword
            - demoAccountRequired
            - notes
            - app
        style: form
        explode: false
        required: false
      - name: fields[appInfos]
        in: query
        description: the fields to include for returned resources of type appInfos
        schema:
          type: array
          items:
            type: string
            enum:
            - appStoreState
            - state
            - appStoreAgeRating
            - australiaAgeRating
            - brazilAgeRating
            - brazilAgeRatingV2
            - franceAgeRating
            - koreaAgeRating
            - kidsAgeBand
            - app
            - ageRatingDeclaration
            - appInfoLocalizations
            - primaryCategory
            - primarySubcategoryOne
            - primarySubcategoryTwo
            - secondaryCategory
            - secondarySubcategoryOne
            - secondarySubcategoryTwo
            - territoryAgeRatings
        style: form
        explode: false
        required: false
      - name: fields[appClips]
        in: query
        description: the fields to include for returned resources of type appClips
        schema:
          type: array
          items:
            type: string
            enum:
            - bundleId
            - app
            - appClipDefaultExperiences
            - appClipAdvancedExperiences
        style: form
        explode: false
        required: false
      - name: fields[endUserLicenseAgreements]
        in: query
        description: the fields to include for returned resources of type endUserLicenseAgreements
        schema:
          type: array
          items:
            type: string
            enum:
            - agreementText
            - app
            - territories
        style: form
        explode: false
        required: false
      - name: fields[inAppPurchases]
        in: query
        description: the fields to include for returned resources of type inAppPurchases
        schema:
          type: array
          items:
            type: string
            enum:
            - referenceName
            - productId
            - inAppPurchaseType
            - state
            - apps
            - name
            - reviewNote
            - familySharable
            - contentHosting
            - inAppPurchaseLocalizations
            - pricePoints
            - content
            - appStoreReviewScreenshot
            - promotedPurchase
            - iapPriceSchedule
            - inAppPurchaseAvailability
            - images
            - offerCodes
        style: form
        explode: false
        required: false
      - name: fields[subscriptionGroups]
        in: query
        description: the fields to include for returned resources of type subscriptionGroups
        schema:
          type: array
          items:
            type: string
            enum:
            - referenceName
            - subscriptions
            - subscriptionGroupLocalizations
        style: form
        explode: false
        required: false
      - name: fields[gameCenterEnabledVersions]
        in: query
        description: the fields to include for returned resources of type gameCenterEnabledVersions
        schema:
          type: array
          items:
            type: string
            enum:
            - platform
            - versionString
            - iconAsset
            - compatibleVersions
            - app
        style: form
        explode: false
        required: false
        deprecated: true
      - name: fields[appCustomProductPages]
        in: query
        description: the fields to include for returned resources of type appCustomProductPages
        schema:
          type: array
          items:
            type: string
            enum:
            - name
            - url
            - visible
            - app
            - appCustomProductPageVersions
        style: form
        explode: false
        required: false
      - name: fields[promotedPurchases]
        in: query
        description: the fields to include for returned resources of type promotedPurchases
        schema:
          type: array
          items:
            type: string
            enum:
            - visibleForAllUsers
            - enabled
            - state
            - inAppPurchaseV2
            - subscription
        style: form
        explode: false
        required: false
      - name: fields[appEvents]
        in: query
        description: the fields to include for returned resources of type appEvents
        schema:
          type: array
          items:
            type: string
            enum:
            - referenceName
            - badge
            - eventState
            - deepLink
            - purchaseRequirement
            - primaryLocale
            - priority
            - purpose
            - territorySchedules
            - archivedTerritorySchedules
            - localizations
        style: form
        explode: false
        required: false
      - name: fields[reviewSubmissions]
        in: query
        description: the fields to include for returned resources of type reviewSubmissions
        schema:
          type: array
          items:
            type: string
            enum:
            - platform
            - submittedDate
            - state
            - app
            - items
            - appStoreVersionForReview
            - submittedByActor
            - lastUpdatedByActor
        style: form
        explode: false
        required: false
      - name: fields[subscriptionGracePeriods]
        in: query
        description: the fields to include for returned resources of type subscriptionGracePeriods
        schema:
          type: array
          items:
            type: string
            enum:
            - optIn
            - sandboxOptIn
            - duration
            - renewalType
        style: form
        explode: false
        required: false
      - name: fields[gameCenterDetails]
        in: query
        description: the fields to include for returned resources of type gameCenterDetails
        schema:
          type: array
          items:
            type: string
            enum:
            - arcadeEnabled
            - challengeEnabled
            - app
            - gameCenterAppVersions
            - gameCenterGroup
            - gameCenterLeaderboards
            - gameCenterLeaderboardsV2
            - gameCenterLeaderboardSets
            - gameCenterLeaderboardSetsV2
            - gameCenterAchievements
            - gameCenterAchievementsV2
            - gameCenterActivities
            - gameCenterChallenges
            - defaultLeaderboard
            - defaultLeaderboardV2
            - defaultGroupLeaderboard
            - defaultGroupLeaderboardV2
            - achievementReleases
            - activityReleases
            - challengeReleases
            - leaderboardReleases
            - leaderboardSetReleases
            - challengesMinimumPlatformVersions
        style: form
        explode: false
        required: false
      - name: fields[appStoreVersionExperiments]
        in: query
        description: the fields to include for returned resources of type appStoreVersionExperiments
        schema:
          type: array
          items:
            type: string
            enum:
            - name
            - platform
            - trafficProportion
            - state
            - reviewRequired
            - startDate
            - endDate
            - app
            - latestControlVersion
            - controlVersions
            - appStoreVersionExperimentTreatments
        style: form
        explode: false
        required: false
      - name: fields[androidToIosAppMappingDetails]
        in: query
        description: the fields to include for returned resources of type androidToIosAppMappingDetails
        schema:
          type: array
          items:
            type: string
            enum:
            - packageName
            - appSigningKeyPublicCertificateSha256Fingerprints
        style: form
        explode: false
        required: false
      - name: limit
        in: query
        description: maximum resources per page
        schema:
          type: integer
          maximum: 200
        style: form
      - name: include
        in: query
        description: comma-separated list of relationships to include
        schema:
          type: array
          items:
            type: string
            enum:
            - appEncryptionDeclarations
            - appStoreIcon
            - ciProduct
            - betaGroups
            - appStoreVersions
            - preReleaseVersions
            - betaAppLocalizations
            - builds
            - betaLicenseAgreement
            - betaAppReviewDetail
            - appInfos
            - appClips
            - endUserLicenseAgreement
            - inAppPurchases
            - subscriptionGroups
            - gameCenterEnabledVersions
            - appCustomProductPages
            - inAppPurchasesV2
            - promotedPurchases
            - appEvents
            - reviewSubmissions
            - subscriptionGracePeriod
            - gameCenterDetail
            - appStoreVersionExperimentsV2
            - androidToIosAppMappingDetails
        style: form
        explode: false
        required: false
      - name: limit[androidToIosAppMappingDetails]
        in: query
        description: maximum number of related androidToIosAppMappingDetails returned (when they are included)
        schema:
          type: integer
          maximum: 50
        style: form
        required: false
      - name: limit[appClips]
        in: query
        description: maximum number of related appClips returned (when they are included)
        schema:
          type: integer
          maximum: 50
        style: form
        required: false
      - name: limit[appCustomProductPages]
        in: query
        description: maximum number of related appCustomProductPages returned (when they are included)
        schema:
          type: integer
          maximum: 50
        style: form
        required: false
      - name: limit[appEncryptionDeclarations]
        in: query
        description: maximum number of related appEncryptionDeclarations returned (when they are included)
        schema:
          type: integer
          maximum: 50
        style: form
        required: false
      - name: limit[appEvents]
        in: query
        description: maximum number of related appEvents returned (when they are included)
        schema:
          type: integer
          maximum: 50
        style: form
        required: false
      - name: limit[appInfos]
        in: query
        description: maximum number of related appInfos returned (when they are included)
        schema:
          type: integer
          maximum: 50
        style: form
        required: false
      - name: limit[appStoreVersionExperimentsV2]
        in: query
        description: maximum number of related appStoreVersionExperimentsV2 returned (when they are included)
        schema:
          type: integer
          maximum: 50
        style: form
        required: false
      - name: limit[appStoreVersions]
        in: query
        description: maximum number of related appStoreVersions returned (when they are included)
        schema:
          type: integer
          maximum: 50
        style: form
        required: false
      - name: limit[betaAppLocalizations]
        in: query
        description: maximum number of related betaAppLocalizations returned (when they are included)
        schema:
          type: integer
          maximum: 50
        style: form
        required: false
      - name: limit[betaGroups]
        in: query
        description: maximum number of related betaGroups returned (when they are included)
        schema:
          type: integer
          maximum: 50
        style: form
        required: false
      - name: limit[builds]
        in: query
        description: maximum number of related builds returned (when they are included)
        schema:
          type: integer
          maximum: 50
        style: form
        required: false
      - name: limit[gameCenterEnabledVersions]
        in: query
        description: maximum number of related gameCenterEnabledVersions returned (when they are included)
        schema:
          type: integer
          maximum: 50
        style: form
        required: false
        deprecated: true
      - name: limit[inAppPurchases]
        in: query
        description: maximum number of related inAppPurchases returned (when they are included)
        schema:
          type: integer
          maximum: 50
        style: form
        required: false
        deprecated: true
      - name: limit[inAppPurchasesV2]
        in: query
        description: maximum number of related inAppPurchasesV2 returned (when they are included)
        schema:
          type: integer
          maximum: 50
        style: form
        required: false
      - name: limit[preReleaseVersions]
        in: query
        description: maximum number of related preReleaseVersions returned (when they are included)
        schema:
          type: integer
          maximum: 50
        style: form
        required: false
      - name: limit[promotedPurchases]
        in: query
        description: maximum number of related promotedPurchases returned (when they are included)
        schema:
          type: integer
          maximum: 50
        style: form
        required: false
      - name: limit[reviewSubmissions]
        in: query
        description: maximum number of related reviewSubmissions returned (when they are included)
        schema:
          type: integer
          maximum: 50
        style: form
        required: false
      - name: limit[subscriptionGroups]
        in: query
        description: maximum number of related subscriptionGroups returned (when they are included)
        schema:
          type: integer
          maximum: 50
        style: form
        required: false
      responses:
        '400':
          description: Parameter error(s)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized error(s)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '200':
          description: List of Apps
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AppsResponse'
        '429':
          description: Rate limit exceeded error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: List Apps
  /v1/apps/{id}:
    parameters:
    - name: id
      in: path
      description: the id of the requested resource
      schema:
        type: string
      style: simple
      required: true
    get:
      tags:
      - Apps
      operationId: apps_getInstance
      parameters:
      - name: fields[apps]
        in: query
        description: the fields to include for returned resources of type apps
        schema:
          type: array
          items:
            type: string
            enum:
            - accessibilityUrl
            - name
            - bundleId
            - sku
            - primaryLocale
            - isOrEverWasMadeForKids
            - subscriptionStatusUrl
            - subscriptionStatusUrlVersion
            - subscriptionStatusUrlForSandbox
            - subscriptionStatusUrlVersionForSandbox
            - contentRightsDeclaration
            - streamlinedPurchasingEnabled
            - accessibilityDeclarations
            - appEncryptionDeclarations
            - appStoreIcon
            - ciProduct
            - betaTesters
            - betaGroups
            - appStoreVersions
            - appTags
            - preReleaseVersions
            - betaAppLocalizations
            - builds
            - betaLicenseAgreement
            - betaAppReviewDetail
            - appInfos
            - appClips
            - appPricePoints
            - endUserLicenseAgreement
            - appPriceSchedule
            - appAvailabilityV2
            - inAppPurchases
            - subscriptionGroups
            - gameCenterEnabledVersions
            - perfPowerMetrics
            - appCustomProductPages
            - inAppPurchasesV2
            - promotedPurchases
            - appEvents
            - reviewSubmissions
            - subscriptionGracePeriod
            - customerReviews
            - customerReviewSummarizations
            - gameCenterDetail
            - appStoreVersionExperimentsV2
            - alternativeDistributionKey
            - analyticsReportRequests
            - marketplaceSearchDetail
            - buildUploads
            - backgroundAssets
            - betaFeedbackScreenshotSubmissions
            - betaFeedbackCrashSubmissions
            - searchKeywords
            - webhooks
            - androidToIosAppMappingDetails
        style: form
        explode: false
        required: false
      - name: fields[appEncryptionDeclarations]
        in: query
        description: the fields to include for returned resources of type appEncryptionDeclarations
        schema:
          type: array
          items:
            type: string
            enum:
            - appDescription
            - createdDate
            - usesEncryption
            - exempt
            - containsProprietaryCryptography
            - containsThirdPartyCryptography
            - availableOnFrenchStore
            - platform
            - uploadedDate
            - documentUrl
            - documentNa

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