---
title: "GET /v1/apps"
method: GET
path: "/v1/apps"
tags: ["Apps"]
---

# GET /v1/apps

`GET /v1/apps`

## Query parameters

- `filter[appStoreVersions.appStoreState]` string[]
- `filter[appStoreVersions.platform]` string[]
- `filter[bundleId]` string[]
- `filter[name]` string[]
- `filter[sku]` string[]
- `filter[appStoreVersions]` string[]
- `filter[id]` string[]
- `exists[gameCenterEnabledVersions]` string[]
- `sort` string[]
- `fields[apps]` string[]
- `limit` integer
- `include` string[]
- `fields[betaGroups]` string[]
- `fields[perfPowerMetrics]` string[]
- `fields[appInfos]` string[]
- `fields[appPreOrders]` string[]
- `fields[preReleaseVersions]` string[]
- `fields[appPrices]` string[]
- `fields[inAppPurchases]` string[]
- `fields[betaAppReviewDetails]` string[]
- `fields[territories]` string[]
- `fields[gameCenterEnabledVersions]` string[]
- `fields[appStoreVersions]` string[]
- `fields[builds]` string[]
- `fields[betaAppLocalizations]` string[]
- `fields[betaLicenseAgreements]` string[]
- `fields[endUserLicenseAgreements]` string[]
- `limit[appInfos]` integer
- `limit[appStoreVersions]` integer
- `limit[availableTerritories]` integer
- `limit[betaAppLocalizations]` integer
- `limit[betaGroups]` integer
- `limit[builds]` integer
- `limit[gameCenterEnabledVersions]` integer
- `limit[inAppPurchases]` integer
- `limit[preReleaseVersions]` integer
- `limit[prices]` integer

## Response `200`

List of Apps

- AppsResponse
  - `data` App[], required
    - `attributes` object
      - `availableInNewTerritories` boolean
      - `bundleId` string
      - `contentRightsDeclaration` 'DOES_NOT_USE_THIRD_PARTY_CONTENT' | 'USES_THIRD_PARTY_CONTENT'
      - `isOrEverWasMadeForKids` boolean
      - `name` string
      - `primaryLocale` string
      - `sku` string
    - `id` string, required
    - `links` ResourceLinks, required
      - `self` string, uri-reference, required
    - `relationships` object
      - `appInfos` object
        - `data` object[]
          - `id` string, required
          - `type` 'appInfos', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
        - `meta` PagingInformation
          - `paging` object, required
            - `limit` integer, required
            - `total` integer, required
      - `appStoreVersions` object
        - `data` object[]
          - `id` string, required
          - `type` 'appStoreVersions', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
        - `meta` PagingInformation
          - `paging` object, required
            - `limit` integer, required
            - `total` integer, required
      - `availableTerritories` object
        - `data` object[]
          - `id` string, required
          - `type` 'territories', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
        - `meta` PagingInformation
          - `paging` object, required
            - `limit` integer, required
            - `total` integer, required
      - `betaAppLocalizations` object
        - `data` object[]
          - `id` string, required
          - `type` 'betaAppLocalizations', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
        - `meta` PagingInformation
          - `paging` object, required
            - `limit` integer, required
            - `total` integer, required
      - `betaAppReviewDetail` object
        - `data` object
          - `id` string, required
          - `type` 'betaAppReviewDetails', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
      - `betaGroups` object
        - `data` object[]
          - `id` string, required
          - `type` 'betaGroups', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
        - `meta` PagingInformation
          - `paging` object, required
            - `limit` integer, required
            - `total` integer, required
      - `betaLicenseAgreement` object
        - `data` object
          - `id` string, required
          - `type` 'betaLicenseAgreements', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
      - `builds` object
        - `data` object[]
          - `id` string, required
          - `type` 'builds', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
        - `meta` PagingInformation
          - `paging` object, required
            - `limit` integer, required
            - `total` integer, required
      - `endUserLicenseAgreement` object
        - `data` object
          - `id` string, required
          - `type` 'endUserLicenseAgreements', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
      - `gameCenterEnabledVersions` object
        - `data` object[]
          - `id` string, required
          - `type` 'gameCenterEnabledVersions', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
        - `meta` PagingInformation
          - `paging` object, required
            - `limit` integer, required
            - `total` integer, required
      - `inAppPurchases` object
        - `data` object[]
          - `id` string, required
          - `type` 'inAppPurchases', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
        - `meta` PagingInformation
          - `paging` object, required
            - `limit` integer, required
            - `total` integer, required
      - `preOrder` object
        - `data` object
          - `id` string, required
          - `type` 'appPreOrders', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
      - `preReleaseVersions` object
        - `data` object[]
          - `id` string, required
          - `type` 'preReleaseVersions', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
        - `meta` PagingInformation
          - `paging` object, required
            - `limit` integer, required
            - `total` integer, required
      - `prices` object
        - `data` object[]
          - `id` string, required
          - `type` 'appPrices', required
        - `links` object
          - `related` string, uri-reference
          - `self` string, uri-reference
        - `meta` PagingInformation
          - `paging` object, required
            - `limit` integer, required
            - `total` integer, required
    - `type` 'apps', required
  - `included` union[]
    - union
      - BetaGroup
        - `attributes` object
          - `createdDate` string, date-time
          - `feedbackEnabled` boolean
          - `isInternalGroup` boolean
          - `name` string
          - `publicLink` string
          - `publicLinkEnabled` boolean
          - `publicLinkId` string
          - `publicLinkLimit` integer
          - `publicLinkLimitEnabled` boolean
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `app` object
            - `data` object
              - …
            - `links` object
              - …
          - `betaTesters` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `builds` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
        - `type` 'betaGroups', required
      - AppStoreVersion
        - `attributes` object
          - `appStoreState` '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_SALE' | 'REJECTED' | 'REMOVED_FROM_SALE' | 'WAITING_FOR_EXPORT_COMPLIANCE' | 'WAITING_FOR_REVIEW' | 'REPLACED_WITH_NEW_VERSION'
          - `copyright` string
          - `createdDate` string, date-time
          - `downloadable` boolean
          - `earliestReleaseDate` string, date-time
          - `platform` 'IOS' | 'MAC_OS' | 'TV_OS'
          - `releaseType` 'MANUAL' | 'AFTER_APPROVAL' | 'SCHEDULED'
          - `usesIdfa` boolean
          - `versionString` string
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `ageRatingDeclaration` object
            - `data` object
              - …
            - `links` object
              - …
          - `app` object
            - `data` object
              - …
            - `links` object
              - …
          - `appStoreReviewDetail` object
            - `data` object
              - …
            - `links` object
              - …
          - `appStoreVersionLocalizations` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `appStoreVersionPhasedRelease` object
            - `data` object
              - …
            - `links` object
              - …
          - `appStoreVersionSubmission` object
            - `data` object
              - …
            - `links` object
              - …
          - `build` object
            - `data` object
              - …
            - `links` object
              - …
          - `idfaDeclaration` object
            - `data` object
              - …
            - `links` object
              - …
          - `routingAppCoverage` object
            - `data` object
              - …
            - `links` object
              - …
        - `type` 'appStoreVersions', required
      - PrereleaseVersion
        - `attributes` object
          - `platform` 'IOS' | 'MAC_OS' | 'TV_OS'
          - `version` string
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `app` object
            - `data` object
              - …
            - `links` object
              - …
          - `builds` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
        - `type` 'preReleaseVersions', required
      - BetaAppLocalization
        - `attributes` object
          - `description` string
          - `feedbackEmail` string
          - `locale` string
          - `marketingUrl` string
          - `privacyPolicyUrl` string
          - `tvOsPrivacyPolicy` string
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `app` object
            - `data` object
              - …
            - `links` object
              - …
        - `type` 'betaAppLocalizations', required
      - Build
        - `attributes` object
          - `expirationDate` string, date-time
          - `expired` boolean
          - `iconAssetToken` ImageAsset
            - `height` integer
            - `templateUrl` string
            - `width` integer
          - `minOsVersion` string
          - `processingState` 'PROCESSING' | 'FAILED' | 'INVALID' | 'VALID'
          - `uploadedDate` string, date-time
          - `usesNonExemptEncryption` boolean
          - `version` string
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `app` object
            - `data` object
              - …
            - `links` object
              - …
          - `appEncryptionDeclaration` object
            - `data` object
              - …
            - `links` object
              - …
          - `appStoreVersion` object
            - `data` object
              - …
            - `links` object
              - …
          - `betaAppReviewSubmission` object
            - `data` object
              - …
            - `links` object
              - …
          - `betaBuildLocalizations` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `buildBetaDetail` object
            - `data` object
              - …
            - `links` object
              - …
          - `icons` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `individualTesters` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `preReleaseVersion` object
            - `data` object
              - …
            - `links` object
              - …
        - `type` 'builds', required
      - BetaLicenseAgreement
        - `attributes` object
          - `agreementText` string
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `app` object
            - `data` object
              - …
            - `links` object
              - …
        - `type` 'betaLicenseAgreements', required
      - BetaAppReviewDetail
        - `attributes` object
          - `contactEmail` string
          - `contactFirstName` string
          - `contactLastName` string
          - `contactPhone` string
          - `demoAccountName` string
          - `demoAccountPassword` string
          - `demoAccountRequired` boolean
          - `notes` string
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `app` object
            - `data` object
              - …
            - `links` object
              - …
        - `type` 'betaAppReviewDetails', required
      - AppInfo
        - `attributes` object
          - `appStoreAgeRating` 'FOUR_PLUS' | 'NINE_PLUS' | 'TWELVE_PLUS' | 'SEVENTEEN_PLUS'
          - `appStoreState` '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_SALE' | 'REJECTED' | 'REMOVED_FROM_SALE' | 'WAITING_FOR_EXPORT_COMPLIANCE' | 'WAITING_FOR_REVIEW' | 'REPLACED_WITH_NEW_VERSION'
          - `brazilAgeRating` 'L' | 'TEN' | 'TWELVE' | 'FOURTEEN' | 'SIXTEEN' | 'EIGHTEEN'
          - `kidsAgeBand` 'FIVE_AND_UNDER' | 'SIX_TO_EIGHT' | 'NINE_TO_ELEVEN'
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `ageRatingDeclaration` object
            - `data` object
              - …
            - `links` object
              - …
          - `app` object
            - `data` object
              - …
            - `links` object
              - …
          - `appInfoLocalizations` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
          - `primaryCategory` object
            - `data` object
              - …
            - `links` object
              - …
          - `primarySubcategoryOne` object
            - `data` object
              - …
            - `links` object
              - …
          - `primarySubcategoryTwo` object
            - `data` object
              - …
            - `links` object
              - …
          - `secondaryCategory` object
            - `data` object
              - …
            - `links` object
              - …
          - `secondarySubcategoryOne` object
            - `data` object
              - …
            - `links` object
              - …
          - `secondarySubcategoryTwo` object
            - `data` object
              - …
            - `links` object
              - …
        - `type` 'appInfos', required
      - EndUserLicenseAgreement
        - `attributes` object
          - `agreementText` string
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `app` object
            - `data` object
              - …
            - `links` object
              - …
          - `territories` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
        - `type` 'endUserLicenseAgreements', required
      - AppPreOrder
        - `attributes` object
          - `appReleaseDate` string, date
          - `preOrderAvailableDate` string, date
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `app` object
            - `data` object
              - …
            - `links` object
              - …
        - `type` 'appPreOrders', required
      - AppPrice
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `app` object
            - `data` object
              - …
            - `links` object
              - …
          - `priceTier` object
            - `data` object
              - …
            - `links` object
              - …
        - `type` 'appPrices', required
      - Territory
        - `attributes` object
          - `currency` string
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `type` 'territories', required
      - InAppPurchase
        - `attributes` object
          - `inAppPurchaseType` 'AUTOMATICALLY_RENEWABLE_SUBSCRIPTION' | 'NON_CONSUMABLE' | 'CONSUMABLE' | 'NON_RENEWING_SUBSCRIPTION' | 'FREE_SUBSCRIPTION'
          - `productId` string
          - `referenceName` string
          - `state` 'CREATED' | 'DEVELOPER_SIGNED_OFF' | 'DEVELOPER_ACTION_NEEDED' | 'DELETION_IN_PROGRESS' | 'APPROVED' | 'DELETED' | 'REMOVED_FROM_SALE' | 'DEVELOPER_REMOVED_FROM_SALE' | 'WAITING_FOR_UPLOAD' | 'PROCESSING_CONTENT' | 'REPLACED' | 'REJECTED' | 'WAITING_FOR_SCREENSHOT' | 'PREPARE_FOR_SUBMISSION' | 'MISSING_METADATA' | 'READY_TO_SUBMIT' | 'WAITING_FOR_REVIEW' | 'IN_REVIEW' | 'PENDING_DEVELOPER_RELEASE'
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `apps` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
        - `type` 'inAppPurchases', required
      - GameCenterEnabledVersion
        - `attributes` object
          - `iconAsset` ImageAsset
            - `height` integer
            - `templateUrl` string
            - `width` integer
          - `platform` 'IOS' | 'MAC_OS' | 'TV_OS'
          - `versionString` string
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `relationships` object
          - `app` object
            - `data` object
              - …
            - `links` object
              - …
          - `compatibleVersions` object
            - `data` object[]
              - …
            - `links` object
              - …
            - `meta` PagingInformation
              - …
        - `type` 'gameCenterEnabledVersions', required
      - PerfPowerMetric
        - `attributes` object
          - `deviceType` string
          - `metricType` 'DISK' | 'HANG' | 'BATTERY' | 'LAUNCH' | 'MEMORY' | 'ANIMATION' | 'TERMINATION'
          - `platform` 'IOS'
        - `id` string, required
        - `links` ResourceLinks, required
          - `self` string, uri-reference, required
        - `type` 'perfPowerMetrics', required
  - `links` PagedDocumentLinks, required
    - `first` string, uri-reference
    - `next` string, uri-reference
    - `self` string, uri-reference, required
  - `meta` PagingInformation
    - `paging` object, required
      - `limit` integer, required
      - `total` integer, required

## Other responses

- `400` — Parameter error(s)
- `403` — Forbidden error

---

[API](https://skmtc.net/apple/apis/app-store-connect.md) · [All operations](https://skmtc.net/apple/apis/app-store-connect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apple/app-store-connect/versions/e085db5c8896/schema)