Export Product Stock Coverage
GET/api/reporting/products/:product/stock-coverage/export
Download the month-by-month Stock Coverage series as a spreadsheet. Columns: Month, Units Sold (that calendar month), DAC (units/day, trailing-window daily average), On Hand (month-end), Days of Stock (on-hand / DAC). Honors the same 'months' span as the JSON endpoint.
Authentication: Requires Bearer token (scope: reports)
Path parameter:
- product: the product ID
Query parameters:
- months: trailing-month count or 'all' (default 12)
- format: 'xlsx' or 'csv' (default xlsx)
Returns a file download (Content-Type application/vnd.openxmlformats-officedocument.spreadsheetml.sheet for xlsx, text/csv for csv), not JSON. Filename: stock-coverage-{sku}-{timestamp}.{format}.
Request
Responses
- 200
- 401
- 403
- 404
- 429
Successful response
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 — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
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.