Stores

The Stores endpoint is your entry point to the Gett marketfront. It discovers stores available for delivery or pickup at a given location, with optional filtering by search terms, cuisine types, and other criteria.

Key Concepts

Store Discovery

The /stores endpoint consolidates all store search and discovery functionality:

POST /stores

Whether you need to find stores by location, search by name, filter by cuisine, or show only open stores - use the same endpoint with different parameters.

Always Fetch Fresh Data

Do Not Cache Store Results

Store results reflect real-time state that can change at any moment:

• Stores can close early or go offline
• Delivery times fluctuate based on order volume
• Stores may temporarily stop accepting orders

Always fetch fresh results when displaying stores to users.

Request Parameters

Parameter	Type	Description
location.address	string	Street address to search near
location.latitude	number	Latitude coordinate (alternative to address)
location.longitude	number	Longitude coordinate (alternative to address)
searchTerms	string	Search query for store names, cuisines, menu items
cuisineTypes	string[]	Filter by cuisine types (e.g., ["Italian", "Pizza"])
fulfillmentType	string	Filter by "delivery" or "pickup"
openNow	boolean	Only show stores currently accepting orders
limit	number	Maximum results to return (for pagination)
offset	number	Results to skip (for pagination)

Response Structure

Each store in the response includes everything needed to display a store card:

interface Store {
  storeId: string;           // Unique identifier
  catalogSetId: string;      // Use this to fetch the CatalogSet
  name: string;
  description?: string;
  imageUrl?: string;
  logoUrl?: string;
  cuisineTypes: string[];
  rating?: number;           // 1-5 scale
  reviewCount?: number;
  address: StoreAddress;
  distance?: number;         // Miles from search location
  isOpen: boolean;
  isAcceptingOrders: boolean;
  fulfillmentTypes: ('delivery' | 'pickup')[];
  deliveryInfo?: {
    fee: number;
    minimum?: number;
    estimatedMinutes: string;  // e.g., "25-35"
  };
  pickupInfo?: {
    estimatedMinutes: string;
  };
}

Store States

isOpen	isAcceptingOrders	What to Show
true	true	Store is available - show "Order Now"
true	false	Store is busy - show "Temporarily Unavailable"
false	false	Store is closed - show hours or "Closed"

Pagination Response

{
  "stores": [...],
  "totalCount": 150,
  "hasMore": true
}

Next Steps

Once you have a store, use the catalogSetId to fetch its menu. See CatalogSets for details.

API Reference

For complete request/response schemas, see the Stores endpoint in the API Reference.