Get Inventory

Returns the current stock count for every item Deliveroo holds inventory data for at the given site, paginated.

This endpoint is the quantity-aware companion to Get Unavailabilities: rather than a flat list of unavailable items, it returns a list of {item_id, quantity, last_sold_at, updated_at} rows. Items with no inventory record at the site are omitted from the response (rather than being returned with a zero quantity) — use the Lookup Inventory endpoint when you need to query a specific set of item IDs and distinguish "0 in stock" from "no record".

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.

Pagination

Results are returned in pages of up to 100 items. To fetch subsequent pages, pass the next_cursor value from the previous response back as the cursor query parameter. The next_cursor field is omitted from the response when there are no more pages.

  • limit (optional, default 100, max 100): number of items per page.
  • cursor (optional): opaque pagination token from a previous response. Treat it as a string — do not parse or construct it on the partner side.

Rate Limit

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

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
string
required
string
required
Query Params
integer
1 to 100
Defaults to 100

Number of items per page (max 100).

string

Opaque pagination token from the previous response's next_cursor. Omit on the first page. Treat the value as opaque — do not construct or persist it on the partner side; always pass back the most recent next_cursor returned by the server.

Responses

Language
Credentials
OAuth2
URL
LoadingLoading…
Response
Choose an example:
application/json