--- title: List apps framework: appstoreconnectapi role: symbol role_heading: Web Service Endpoint path: appstoreconnectapi/get-v1-apps --- # List apps Find and list apps in App Store Connect. ## URL GET https://api.appstoreconnect.apple.com/v1/apps ## Query Parameters fields[apps]: Fields to return for included related types. fields[betaLicenseAgreements]: Fields to return for included related types. filter[bundleId]: Attributes, relationships, and IDs by which to filter. filter[id]: Attributes, relationships, and IDs by which to filter. filter[name]: Attributes, relationships, and IDs by which to filter. filter[sku]: Attributes, relationships, and IDs by which to filter. include: Relationship data to include in the response. limit: Number of resources to return. sort: Attributes by which to sort. fields[preReleaseVersions]: Fields to return for included related types. limit[preReleaseVersions]: Number of included related resources to return. fields[betaAppReviewDetails]: Fields to return for included related types. fields[betaAppLocalizations]: Fields to return for included related types. fields[builds]: Fields to return for included related types. fields[betaGroups]: Fields to return for included related types. limit[builds]: Number of included related resources to return. limit[betaGroups]: Number of included related resources to return. limit[betaAppLocalizations]: Number of included related resources to return. limit[appStoreVersions]: limit[appInfos]: fields[endUserLicenseAgreements]: Fields to return for included related types. fields[appStoreVersions]: Fields to return for included related types. Note: appStoreState is deprecated, use appVersionState instead. fields[appInfos]: Fields to return for included related types. filter[appStoreVersions]: Fields to return for included related types. filter[appStoreVersions.platform]: Fields to return for included related types. filter[appStoreVersions.appStoreState]: limit[gameCenterEnabledVersions]: fields[gameCenterEnabledVersions]: Fields to return for included related types. exists[gameCenterEnabledVersions]: limit[inAppPurchases]: fields[inAppPurchases]: Fields to return for included related types. fields[ciProducts]: Fields to return for included related types. limit[appClips]: fields[appClips]: fields[reviewSubmissions]: fields[appCustomProductPages]: fields[appEvents]: limit[appCustomProductPages]: limit[appEvents]: limit[reviewSubmissions]: fields[subscriptionGracePeriods]: fields[promotedPurchases]: fields[subscriptionGroups]: limit[inAppPurchasesV2]: limit[promotedPurchases]: limit[subscriptionGroups]: fields[appStoreVersionExperiments]: limit[appStoreVersionExperimentsV2]: fields[appEncryptionDeclarations]: limit[appEncryptionDeclarations]: fields[gameCenterDetails]: filter[appStoreVersions.appVersionState]: This filter is deprecated. fields[androidToIosAppMappingDetails]: filter[reviewSubmissions.platform]: filter[reviewSubmissions.state]: limit[androidToIosAppMappingDetails]: fields[buildIcons]: ## Response Codes 200 OK: 400 Bad Request: An error occurred with your request. 401 Unauthorized: 403 Forbidden: Request not authorized. 429 : ## Mentioned in Creating alternative distribution packages App Store Connect API 3.6 release notes Creating and configuring keys for web distribution Creating auto-renewable subscription groups Creating keys and establishing alternative marketplace connections Generating Tokens for API Requests ## Discussion Discussion Example Request and Response ## See Also ### Related Documentation - [Read app information](appstoreconnectapi/get-v1-apps-_id_.md) - [Modify an app](appstoreconnectapi/patch-v1-apps-_id_.md) - [Read an app’s encryption declarations](appstoreconnectapi/get-v1-apps-_id_-appencryptiondeclarations.md) - [Read an app’s encryption declaration ids](appstoreconnectapi/get-v1-apps-_id_-relationships-appencryptiondeclarations.md) ### Getting and modifying app information - [Read app information](appstoreconnectapi/get-v1-apps-_id_.md) - [Modify an app](appstoreconnectapi/patch-v1-apps-_id_.md) - [Read an app’s encryption declarations](appstoreconnectapi/get-v1-apps-_id_-appencryptiondeclarations.md) - [Read an app’s encryption declaration ids](appstoreconnectapi/get-v1-apps-_id_-relationships-appencryptiondeclarations.md)