Get Profitability Trend
GET/api/reporting/profitability/trend
Returns trend data (per-interval metrics) grouped by a dimension. When indirect costs are included (default), per-interval total cost and profit reflect cost-entry allocations; period allocations are day-prorated across intervals. Margin-ladder metrics are available: gross_profit / gross_margin (revenue minus COGS), contribution_margin / contribution_margin_pct (after channel and indirect costs), plus ad_spend and tacos for sku, brand, and supplier groupings.
reports:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Rows may include {interval}_indirect_cost keys and a 'Non-Product / Unallocated' row (is_unallocated: true) for amounts that cannot be attributed to the chosen grouping.
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.