Skip to main content

Get Contribution Margin by Product

GET 
/api/reporting/contribution-margin/by-product

Contribution margin measures profitability after both cost of goods sold and allocated operating costs:

  • Gross Profit = Revenue − COGS
  • Contribution Dollars = Gross Profit − Allocated Costs
  • Contribution Margin % = Contribution Dollars ÷ Revenue × 100
Required scope: reports:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Revenue and COGS come from per-order-line financial records that are kept current by background financial calculations. Allocated costs come from the cost allocation system (cost entries prorated across products, orders, brands, suppliers, or sales channels).

Returns a profitability breakdown per product. Each row includes the product's SKU, brand, and default supplier alongside revenue, COGS, allocated costs, gross profit, contribution dollars, and margin percentages. Products that received cost allocations but had no sales in the period also appear, with zero revenue and negative contribution — so allocated spend never silently disappears from the report.

With include_ad_metrics=true, each row also carries Amazon Ads spend, ad-attributed sales, ACoS (ad spend ÷ attributed sales), TACoS (ad spend ÷ total revenue), and break-even ACoS (the ACoS at which the product's contribution reaches zero).

Date filtering: date_from and date_to must BOTH be provided for date filtering to apply — if either is omitted the report covers all available history. Sales figures are filtered by order date; allocated costs are matched by their allocation period when one is set (any overlap with the requested range counts), otherwise by their allocation date.

Authentication: Requires Bearer token. Scope: reports (read/write).

Request​

Responses​

OK

Response Headers
    Content-Type