Bulk look up products by ID

Fetch a specific set of products by product_id and/or variant_id,
returning the same payload shape as Full catalogue filtered to the
IDs you asked for. Designed to be called in response to a
CatalogueUpdated webhook so you
only refetch the rows that changed instead of the entire catalogue.

  • At least one of product_ids or variant_ids must be non-empty.
  • The combined list cap is 500 IDs per request.
  • Matched products are returned in full (all of their variants),
    not just the matched variant — so a single response is enough to
    rebuild your local cache row.
  • IDs that don't resolve to anything currently associated with the
    location are silently omitted; treat their absence as "deleted from
    this storefront" and remove them from your cache.
  • Stock control still applies — out_of_stock is per online location,
    consistent with Full catalogue.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int64
required

An online_location.id from GET /stores.

Body Params
product_ids
array of int64s

Up to 500 product_ids to look up.

product_ids
variant_ids
array of int64s

Up to 500 variant_ids to look up.

variant_ids
Responses

Language
Credentials
Bearer
token
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json