Skip to main content

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).

Required scope: reports:read

Grant 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. Rows and grand_totals carry cost_allocated (direct cost allocated to the order lines) and cogs_returned, so total_cost = cogs + cost_allocated − cogs_returned + indirect_cost reconciles; cost_allocated minus the cost line-type columns is allocated cost no line type explains. 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

Fee-source coverage — fee_source_coverage lists every sales channel that produced orders in the window, with orders_in_range, orders_with_fee_line, and a state of actual, estimated, pending, none, or unsupported. A channel in none produced revenue with no marketplace-fee cost at all, so its margin — and the blended contribution margin in grand_totals — is overstated by whatever that channel charged. marketplace_fee_financial_line_type_ids names the cost columns that caveat applies to. Use it to qualify the totals rather than reading a missing fee as a zero fee.

Request​

Responses​

OK

Response Headers
    Content-Type