Gett Developer Portal
  • Welcome
  • Distribution Partners
  • Brand Partners
  • Commerce Partners
  • Ecosystem Partners
  • Errors
  • API Reference
Documentation
  • Get Started
  • Marketfront SDK
  • API Reference
Resources
  • Payments
Company
  • Gett
  • Terms of Service
  • Privacy Policy

Copyright 2026 Gett. All rights reserved.

Information
Stores
    Discover StorespostGet Storeget
Catalog
    Get CatalogSetget
Orders
    Place orderpostValidate orderpost
Cart
    Add item to cartpostRemove item from cartpostUpdate item quantitypost
Schemas
powered by Zuplo
Gett Marketfront API
Gett Marketfront API

Catalog

Menu structure lookup. getCatalogSet returns the complete CatalogSet for a store using a normalized dictionary structure (id-to-object maps) for O(1) lookups and zero duplication.

CatalogSets are immutable — once created, they never change. When a restaurant updates their menu, a new CatalogSet is created with a new ID. Cache aggressively using catalogSetId as the cache key. Conditional requests via If-None-Match are supported.


Get CatalogSet

GET
https://api.gett-tech.com
/v1/marketplace/catalog-sets/{catalogSetId}

Retrieves the complete CatalogSet (menu) for a store. CatalogSets are immutable — once created, they never change. When a restaurant updates their menu, a new CatalogSet is created with a new ID. Cache aggressively using catalogSetId as the cache key.

Structure

The CatalogSet uses a normalized dictionary structure (id-to-object maps) rather than deep nesting for O(1) lookups and zero duplication.

ETag Caching

This endpoint supports conditional requests via If-None-Match.

For business rules, pricing logic, and detailed structure documentation, see the CatalogSet Guide.

Get CatalogSet › path Parameters

catalogSetId
​string · uuid · required

Canonical Guid CatalogSet ID from store discovery results (matches Store.catalogSetId).

Get CatalogSet › Headers

If-None-Match
​string

ETag from a previous response. If the catalog hasn't changed, returns 304 Not Modified.

Get CatalogSet › Responses

OK

Partner-facing CatalogSet. Excludes internal fields (ProviderMetadata).
ExternalCatalogSet
​null | object · required

Menus keyed by catalog ID

​null | object · required

Menu items keyed by item ID

​null | object · required

Modifier groups keyed by modifier group ID

​null | object · required

Menu sections keyed by section ID

catalogSetId
​string · uuid

Unique identifier for this catalog version

GET/v1/marketplace/catalog-sets/{catalogSetId}
curl --request GET \ --url https://api.gett-tech.com/v1/marketplace/catalog-sets/:catalogSetId
Example Responses
{ "catalogSetId": "00000000-0000-0000-0000-000000000000", "catalogs": { "key": { "availability": [ { "dayOfWeek": "Sunday", "end": "15:00:00", "start": "15:00:00" } ], "catalogId": "00000000-0000-0000-0000-000000000000", "name": "name", "sectionIds": [ "00000000-0000-0000-0000-000000000000" ] } }, "items": { "key": { "basePrice": 0, "compareAt": 0, "description": "description", "imageUrl": "imageUrl", "itemId": "00000000-0000-0000-0000-000000000000", "modifierGroupIds": [ "00000000-0000-0000-0000-000000000000" ], "name": "name", "startingAt": 0 } }, "modifierGroups": { "key": { "defaultItems": [ { "itemId": "00000000-0000-0000-0000-000000000000", "quantity": 0 } ], "enableDuplicateItems": true, "itemIds": [ "00000000-0000-0000-0000-000000000000" ], "maximumAllowed": 0, "minimumAllowed": 0, "modifierGroupId": "00000000-0000-0000-0000-000000000000", "name": "name", "tieredPricing": [ { "offset": 0, "price": 0 } ] } }, "sections": { "key": { "itemIds": [ "00000000-0000-0000-0000-000000000000" ], "name": "name", "sectionId": "00000000-0000-0000-0000-000000000000", "sectionIds": [ "00000000-0000-0000-0000-000000000000" ] } } }
json
application/json

StoresOrders