Download Inventory Feed
GET/api/portal/feed/inventory
The reseller inventory feed: one flat row per product resolvable in the active account's catalog, decorated with the buyer's own B2B unit price and holdback-aware availability. Scoped exactly like the catalog — include/exclude rules, the account's availability display mode (available_qty is only populated in exact mode), and the tenant-wide inventory holdback all apply, so the feed can never expose more than the buyer's portal session could. Intended for programmatic consumption by resellers (poll it, or schedule a CSV pull); throttled to 12 requests/minute. Feeds larger than 10,000 products are truncated and flagged via meta.truncated.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Authenticate either with a bearer token or with a feed link key in the key query parameter (see Generate Feed Link). A key is pinned to the location it was issued for and stops working the moment it is revoked or regenerated, or the buyer is deactivated or unassigned from that location.
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.