status argument to scope the list; only ACTIVE categories are returned by default.
Use this query to populate category pickers and navigation, then fetch a single category with category or list its tokens with categoryTokens. To filter or exclude categories directly on token discovery queries, use the categories filter (TokenCategoryFilter) on filterTokens.
Returns
Arguments
Filter by category kind.
See CategoryType
Filter by lifecycle status. Defaults to
ACTIVE.
See CategoryStatusExample
Test this query in the Explorer →Usage Guidelines
- This is a lightweight call. Fetch once and cache client-side; category membership changes slowly.
shortNameis optional and does not fall back toname. Use it for compact surfaces (pills, badges) and fall back tonameyourself when it is null.