Get Pricing Sync Profile Coverage
GET/api/v2/sales-channels/:integrationInstance/prices/profile-coverage
How the channel's listings are distributed across pricing sync profiles — for each profile that governs at least one listing on this channel, how many listings it reaches and by which route.
integrations:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token.
Requires the integrations.view permission (API tokens: integrations:read scope).
Response data:
- channel_default_profile_id (integer|null): the channel's default profile
- listings_total (integer): active listings on the channel
- inline_listings (integer): listings governed by no profile at any level — they push with the channel's inline settings
- profiles (array): one entry per profile in use on the channel —
- profile_id, name, summary
- is_default (boolean): this profile is the channel default
- is_archived (boolean): archived profiles still appear while they govern listings
- listings_direct (integer): listings that carry this profile themselves
- listings_via_product (integer): listings inheriting it from their product
- listings_inherit (integer): listings inheriting it as the channel default
- listings_total (integer): the sum of the three
The counts are cached for up to a minute; every assignment made through the API refreshes them.
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.