Get SKU COGS Health Detail
GET/api/cogs/sku-health/:id
Returns detailed COGS health metrics for a specific product by product ID.
inventory:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Scope: The top-level metrics (cogs_avg, cogs_min, cogs_max, cogs_median, variation_pct, total_quantity, total_value, active_layer_count, init_cogs) cover the warehouse FIFO ledger only. Amazon FBA stock — which uses a separate WAC ledger and has no warehouse_id — is intentionally excluded so this matches the cache-backed inventory_avg_cost displayed on the product Overview page.
Amazon FBA inventory (if the product has any) is returned as a separate amazon_summary object with its own quantity-weighted average, min/max cost, layer count, and integration instance count. amazon_summary is null when the product has no Amazon FBA stock.
Authentication: Requires Bearer token.
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.