List Product Amazon Business Quantity Break Usages
GET/api/v2/products/:product/amazon-business-usages
List the Amazon accounts whose Amazon Business quantity discounts for this product are built from the product's quantity breaks, and the pricing level each one reads them from. Use it before changing a product's quantity breaks, to see which Amazon Business prices the change will move.
products:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token.
API tokens need the products:read scope.
An account is listed when, for at least one of the product's live listings on it, the policy in force (the listing's pricing sync profile, else the product's, else the channel's default; a profile with no Business policy of its own uses the channel's) has a Business price turned on and quantity discounts set to quantity_breaks. There is one row per account and pricing level; an empty data means no Amazon account uses this product's quantity breaks.
Response data[]:
- integration_instance_id (integer): the Amazon account (integration instance)
- name (string): the account's name
- tier_id (integer): the pricing level whose quantity breaks become the ladder
- tier_name (string|null): that level's name; null if it no longer exists
Returns 404 when the product does not exist.
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
Response Headers
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.