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
categoriesTags the client groups and filters by. Mixes cuisine names from the
store's category metadata with synthetic system tags computed at
request time:
Synthetic tags are best-effort on search-mode results — index data
is sufficient for cuisine + Popular but Savings/Exclusive are skipped
when not derivable from the search hit.Closest — in the closest cluster by distance.Popular — high average rating.Savings — currently runs a meaningful discount.Exclusive — catalog set is partner-supplied (no discount).
deliveryAllowedWhether this store supports delivery fulfillment.
nameStore display name
Per-store capability flags. Unlike availability (Gett.Service.Marketfront.DTOs.Store.DeliveryAllowed/ Gett.Service.Marketfront.DTOs.Store.PickupAllowed), options describe how the store can be interacted with. Extension point for future capabilities (min-order, scheduling modes, …).
pickupAllowedWhether this store supports pickup fulfillment.
stemURL-safe slug used to navigate to the store page: /store/{stem}.
storeIdUnique store identifier
Physical address for external/partner-facing APIs. Excludes internal references (AddressId).
Weekly opening-hours pattern. Null when the store does not publish availability windows. The server treats null/empty as "closed" when computing Gett.Service.Marketfront.DTOs.Store.IsAcceptingOrders — partners should rely on that flag rather than deriving open-state from this field.
catalogSetIdID for fetching the store's catalog
descriptionStore description
distanceMilesDistance from search location in miles
Highlighted versions of text fields, with match tokens wrapped in
«…» sentinels. Populated only for search-mode results so the
UI can bold the matched substring.
imageUrlStore hero image
isAcceptingOrdersWhether the store is accepting orders right now. Computed server-side by intersecting the request instant with Gett.Service.Marketfront.DTOs.Store.Availability in the store's Gett.Service.Marketfront.DTOs.Store.TimeZone. False when the store is disabled, has no catalog, has no published windows, or has no zone.
Dishes on this store's menu that matched the query. Populated only when the search query surfaced the store through a dish hit (e.g. "pad thai" landing you on a restaurant whose name has no mention of Thai food).
priceLevelPrice tier (1=cheap … 4=expensive).
ratingAverage rating (1-5)
reviewCountNumber of reviews
savingsActive discount as a percentage (0–100). Null when no discount is running. The "Savings" entry in Gett.Service.Marketfront.DTOs.Store.Categories is the presentation flag; this is the underlying number for display (e.g. "SAVE 11%").
timeZoneIANA timezone of the store's address (e.g. "America/Los_Angeles"). Used by the client to interpret Gett.Service.Marketfront.DTOs.Store.Availability windows against the user's clock.