List Coverage Options
GET/api/v2/inventory-allocations/product/:productId/coverage-options
Lists the open PO lines a product's allocation can be manually covered by — used to populate the 'Change PO Coverage' picker.
orders:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Returns non-draft / non-closed / non-cancelled / non-voided PO lines with unreceived quantity remaining, sorted by earliest resolved ETA first (lines with no resolvable ETA sort last, by creation order). resolved_eta is the inbound-shipment expected arrival date, falling back to the PO header's estimated delivery date.
covered_quantity is the quantity backorders already hold on the line (allocations awaiting receipt), and uncovered_quantity is what is left to allocate (unreceived_quantity minus covered_quantity, never below 0).
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 — 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.