Looks up stock counts for a specific set of partner item IDs at a given site, in a single call.

Use this endpoint when you need to refresh the in-stock view for a known list of items — for example, after recording sales in your POS, or before pushing prices for items that may have gone out of stock. Unlike Get Inventory, which returns a paginated list of every item with an inventory record, this endpoint returns exactly the items you ask about and a per-item error for any unknown IDs.

Since stock can differ for every site, both the Catalogue ID (provided during catalogue upload) and the specific Site ID are required when using this endpoint.

Please note that this API is currently being rolled out gradually. Before launching with this integration, please contact your Deliveroo Technical Integration Manager for approval and enablement support, as the integration will not work until access has been granted.

Request shape

• version is required and currently must be inventory-v2.
• item_ids is a list of up to 500 partner item IDs to look up. IDs that don't exist in the catalogue are returned as per-item errors rather than failing the whole request.

Response shape

• items is always present (an empty array [] when no IDs match) and contains one entry per item that was found, with the same shape as Get Inventory.
• errors is omitted on full success, and present (with one entry per failed lookup) on 207 Multi-Status responses.

Rate Limit

This endpoint is rate-limited at 100 requests per minute per site per brand.