Store discovery and detail. Use discoverStores to find stores available at a location (with optional free-text query and fulfillment filtering), and getStore to fetch a single store's full payload — including address, availability windows, categories, and the catalogSetId for the follow-up Catalog call.
Discover Stores
Discover stores available at a location with optional filtering.
Filtering
Use the query field for free-text search — it accepts anything from single keywords like "pizza" to natural language like "healthy lunch spots with outdoor seating". Combine with fulfillmentType to filter by delivery or pickup availability.
Pagination
Use offset and limit to paginate results. The response includes totalCount (total matching results) and hasMore (whether additional pages exist). Default limit is 50, maximum is 100.
Discover Stores › Request Body
Location to search near
fulfillmentTypeFilter by fulfillment method (delivery or pickup).
limitMaximum number of results to return
offsetOffset for pagination
queryFree-text search query. Accepts anything from single keywords like "pizza" to natural language requests like "healthy lunch spots with outdoor seating".
Discover Stores › Responses
Stores matching the discovery criteria
hasMoreWhether more results are available
Stores matching the discovery criteria.
totalCountTotal number of matching stores (for pagination)
Get Store
Fetch a single store by its canonical Guid id (the value returned by
discoverStores as storeId). Returns the full Store payload —
including address, availability windows, categories, and catalogSetId
for the follow-up getCatalogSet call.
path Parameters
storeIdCanonical Guid store identifier from discoverStores.
Get Store › Responses
Store details
categoriesLabels describing this store — a mix of cuisine types (e.g. Thai, Pizza)
and highlight tags such as Popular, Savings, Exclusive, and
Closest. Use them to group or filter stores in your UI.
fulfillmentModesFulfillment modes this store offers, as the same FulfillmentType values the
discovery filter and the order graph use (PICKUP, DELIVERY_BY_MERCHANT). Empty
only for a store that offers neither. Filter or badge stores off this set rather than
separate per-mode booleans.
nameStore display name
Per-store capability flags — e.g. whether the store accepts tips. Distinct from FulfillmentModes, which says which fulfillment modes are offered at all.
storeIdUnique store identifier
A postal address used across the order API.
On a request, supply the street fields; LatLong is ignored — the server geocodes coordinates from the street fields. On a response, the street fields are echoed alongside the server-geocoded LatLong.
Weekly opening-hours pattern, for display. Empty when the store does not publish availability windows. To decide whether the store can take an order right now, use IsAcceptingOrders rather than deriving open-state from these windows.
catalogSetIdID for fetching the store's catalog
descriptionStore description
distanceMilesDistance from search location in miles
imageUrlStore hero image
isAcceptingOrdersWhether the store is accepting orders right now. Prefer this flag over deriving open-state yourself from Availability — it already accounts for the store's hours, timezone, and catalog status.
priceLevelPrice tier (1=cheap … 4=expensive).
ratingAverage rating (1-5)
reviewCountNumber of reviews
savingsActive discount as a percentage (0–100), for display (e.g. "SAVE 11%"). Null when no discount is running.
timeZoneIANA timezone of the store's address (e.g. "America/Los_Angeles"). Used by the client to interpret Availability windows against the user's clock.