Get Profitability Cost Breakdown
GET/api/reporting/profitability/cost-breakdown
Returns cost breakdown rows per dimension with financial line type columns, indirect costs (cost-entry allocations), and the margin ladder: gross_profit / gross_margin, contribution_margin / contribution_margin_pct, and company-level operating_profit (contribution margin minus unallocated indirect costs).
reports:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Indirect costs attribute direct dimension-target allocations plus product-target allocations rolled up to the grouping; unattributable amounts appear on the 'Non-Product / Unallocated' row so grand totals cover all allocations in range. For sku, brand, and supplier groupings, rows also carry ad_spend, acos, and tacos (a breakout of indirect costs — already included in the totals, never added twice).
Authentication: Requires Bearer token
Request
Responses
- 200
- 401
- 403
- 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.
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.