---
title: List app categories
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/get-v1-appcategories
---

# List app categories

List all categories on the App Store, including the category and subcategory hierarchy.

## URL

GET https://api.appstoreconnect.apple.com/v1/appCategories

## Query Parameters

exists[parent]: Filter the returned app categories to include only those that have a parent category (true) or are top-level categories (false). fields[appCategories]: Additional fields to include for each App Categories resource returned by the response. filter[platforms]: Filter the returned app categories by platform. include: The relationship data to include in the response. limit: The maximum number of app category resources to return. limit[subcategories]: The maximum number of related subcategory resources to return.

## Response Codes

200 OK: 400 Bad Request: An error occurred with your request. 401 Unauthorized: 403 Forbidden: Request not authorized. 429 :

## Discussion

Discussion Use this endpoint to retrieve the list of available App Store categories and subcategories. Associate an app with categories using the Modify an app info endpoint. The first example retrieves the full category and subcategory hierarchy in one request. The second example retrieves just the top-level categories for macOS apps. Get All App Categories and Subcategories Get All Top-Level Categories that Apply to macOS Apps

## See Also

### Listing Categories and Subcategories

- [List all subcategories for an app category](appstoreconnectapi/get-v1-appcategories-_id_-subcategories.md)
- [List subcategory IDs for an app category](appstoreconnectapi/get-v1-appcategories-_id_-relationships-subcategories.md)