--- title: Query Business Categories framework: Apple Ads Platform API role: symbol role_heading: Web Service Endpoint platforms: [apple ads platform api 1.0+] path: apple-ads-platform-api/query-categories --- # Query Business Categories Retrieve a paginated list of business categories using filters and sorting. ## URL POST https://api.ads.apple.com/v1/business-categories/query ## Header Parameters X-Ap-Context: ## Response Codes 200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 Too Many Requests: 500 Internal Server Error: ## Discussion Discussion This endpoint returns a paginated list of business categories from the Maps taxonomy. Categories classify brands and locations. You use them to scope targeting and discovery within Apple Maps campaigns. An empty request body returns all categories with default pagination. Each category has a qualifiedId using a dot to separate each level of the taxonomy hierarchy (for example, dining.restaurant). A single hierarchy level’s own name can itself contain underscores (for example, association_or_organization), so a dot always marks a hierarchy boundary, but an underscore doesn’t. Use the text value on a CATEGORY match-type Keyword to target Apple Maps searches within that category. See QueryFilterOperator for the full set of supported comparison operators. Filterable Fields | | | | | | | | Only name is confirmed filterable; other category fields (id, qualifiedId, eligibility) aren’t documented as query filters. The request body is a QueryRequest composed of QueryFilter conditions and QuerySort directives (QuerySortOrder), controlled by QueryPagination. Request Body See QueryRequest. Each category record returned includes the following fields: | | | | | | | | | | | | | | The qualifiedId format and eligibility status both carry specific rules: | | | Payload Examples ## See Also - [Query Brands](apple-ads-platform-api/query-brands.md) - [Get Brand by ID](apple-ads-platform-api/get-brand-by-id.md) - [Get Business Category](apple-ads-platform-api/get-category-by-id.md) - [Query Rejection Reasons for Brands](apple-ads-platform-api/query-policy-assignments-(rejection-reasons)-for-external-consumers.md)