Get Channel Category Map
GET/api/v2/sales-channels/:salesChannel/category-map
The channel's product type → category map: one row per active leaf product type, path-ordered. Each row carries the type, how many active products carry it, the channel category it maps to (or null), category_missing (true when a taxonomy re-sync removed the mapped category — the row counts as unmapped until it is re-mapped), the mapped category's default template and how many templates that category has.
products:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
include=suggestions adds up to 3 suggested categories to each unmapped row, matched from the type's name and a sample of its products' names (confidence 0–1, source). Suggestions are cached for a day.
version is a concurrency token for the whole map — send it back with Replace Channel Category Map. taxonomy_synced is false when the channel's categories have not been synced yet, in which case no row can be mapped.
Authentication: Requires Bearer token.
Requires permission: listings.index
Request
Responses
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.