List brands
Your brands (menu concepts), the top of the identity map.
Cross-reference with fetchLocations and fetchStores via ids.
Scope: brands owned by the organization your API key resolves to. Retired brands are included, with Brand.deactivatedAt set, so an id you recorded last year still resolves.
Paging: sorted by name ascending, so the order is stable across calls. Loop until nextCursor is absent.
Safe to retry: this operation is read-only and idempotent.
Request
- pagePageRequest
Cursor pagination.
{
"page": {
"limit": 50,
"cursor": "<cursor>"
}
}Responses
Headers
- x-mealco-tx-idstringoptional
The correlation id for this call, returned on every response that an operation produces, successful or not. Quote it when you report a problem so that we can trace the request. You may send your own x-mealco-tx-id on the request and it is used as the id. It is optional in the schema because a request with a malformed JSON body is rejected before an id is assigned, so that one response carries neither this header nor the txId field of the error body.
- brandsBrand[]
The page of brands, sorted by
nameascending. - nextCursorstring
Opaque cursor for the next page. Absent means the last page. End your loop on an absent cursor, not on an empty array.
{
"brands": [
{
"id": "00000000-0000-0000-0000-000000000000",
"code": "<code>",
"name": "<name>",
"displayName": "<displayName>",
"organizationId": "00000000-0000-0000-0000-000000000000",
"deactivatedAt": "2026-01-01T00:00:00Z"
}
],
"nextCursor": "<nextCursor>"
}About Stores
The places you operate and the brands you operate there.
Sous Chef models a restaurant business in three layers, and every other section of this API assumes them. A brand is a menu concept: what a customer sees on a delivery app. A location is a physical address with a kitchen in it. A store is one storefront: a single brand, at a single location, on a single platform. A location running two brands on three platforms has six stores, each with its own menu, hours and pause state.
The directory reads join on ids, never on display names: every store carries its location.id and brand.id, and a location carries the id of each brand it runs.
Start here. A location carries the timezone that every schedule, report window and business day elsewhere on this API is interpreted in.
Every operation is scoped to the organization your API key resolves to, and nothing here calls out to a delivery platform live. The directory reads (fetchLocations, fetchBrands, fetchStores, fetchStore, fetchStoreHours, fetchStoreMenus) never mutate; setLocationHours and setLocationSpecialHours write a location you own.
Whether a storefront is currently taking orders is not in this section. fetchStoreStatuses, pauseStores, unpauseStores and the store.status.changed webhook are in the Store status section. This section describes what you operate. That one describes whether it is open right now, and whether the platform agrees.