Download Lot Backfill Template (CSV)
GET/api/inventory-expiry/lot-backfill/template
Download the lot-data backfill CSV template so uploads start from the exact header layout the importer expects (Content-Type: text/csv).
Columns: sku, warehouse, batch, manufacture_date, expiry_date, quantity.
Without product_id: a header row plus one example row (filename: lot-data-backfill-template.csv).
With product_id: a header row plus one row per warehouse holding that product's un-lotted stock (no batch, no expiry), pre-filled with sku, warehouse and the un-lotted quantity so only batch and dates remain to fill in (filename: lot-data-backfill-{sku}.csv). A product with nothing left to backfill yields a single row carrying only its SKU. Use GET /api/v2/products/{product}/unlotted-stock to see the same quantities as JSON.
Authentication: Requires Bearer token. Scope: reports:read.
This is a file download — the response is CSV text, not JSON.
reports:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Request
Responses
- 200
- 401
- 403
- 422
- 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.
Unprocessable Entity
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.