List till menus

GET/v1/sites/{siteId}/till-menus

A site's till menus, with their sections and buttons. A page at a time; retired ones only with includeInactive.

Needs Catalogue: read

Path

• siteIdrequired

  The site, from GET /v1/sites.

  string

Query

• limit

  How many records to return, at most.

  integer · ≥ 1 · ≤ 200 · default 50

• cursor

  nextCursor from the previous page. Omit for the first page.

  string

• updatedSince

  Only records changed at or after this time (RFC 3339). For a sync, pass the time your previous sync started.

  string · date-time

• includeInactive

  Include retired records (active false). Off by default.

  boolean

Headers

• Authorizationrequired

  An API key from Automation > Access in the Dnero portal, sent as Authorization: Bearer <key>.

  string

Responses

• 200OK
• 400Bad Requestbad_requestinvalid_cursoridempotency_key_required
• 401Unauthorizedmissing_keyinvalid_keykey_expired+1 more
• 403Forbiddenkey_revokedassistant_keykey_without_access+7 more
• 404Not Foundsite_not_foundnot_found
• 422Unprocessable Entityinvalid_requestnot_a_modifier_group
• 429Too Many Requestsrate_limited
• 500Internal Server Errorserver_error
• 502Bad Gatewayupstream_unavailable

200 OK

• datarequired

  The records, in a stable order.

  array of objects

  8 fields in each

  • activerequired

    False for a retired till menu.

    boolean

  • availabilityrequired

    When the tills offer it. Empty is always.

    array of objects

    3 fields in each

    • daysrequired

      The days it applies on, monday to sunday.

      array of string

    • endsAt

      Until, as HH:MM in the site's time. Absent is to the end of the day.

      string

    • startsAt

      From, as HH:MM in the site's time. Absent is from the start of the day.

      string

  • coderequired

    The till menu's code.

    string

  • namerequired

    The till menu's name, as staff see it.

    string

  • orderrequired

    Where it sits among the site's till menus, lowest first.

    integer

  • publishedrequired

    Whether the tills receive it. An unpublished menu exists but is not in use.

    boolean

  • sectionsrequired

    Its sections, in order.

    array of objects

    4 fields in each

    • buttonsrequired

      Its buttons, in order.

      array of objects

      4 fields in each

      • typerequired

        What the button does. A folder opens its children.

        string · one of "product", "modifier", "folder", "promotion", "orderType", "screen", "blank"

      • children

        For a folder: the buttons inside it.

        array of objects

        The same fields as its parent.

      • name

        The button's label, when it is not the product's name.

        string

      • productCode

        For a product or modifier button: the product, by code.

        string

    • coderequired

      The section's code, within its menu.

      string

    • namerequired

      The section's name.

      string

    • colour

      The section tab's colour, #RRGGBB.

      string

  • updatedAt

    When it last changed.

    string · date-time

• nextCursor

  Pass as cursor to get the next page. Absent on the last page.

  string

curlJavaScriptPython

curl "https://api.dev.dnerohq.com/v1/sites/9a3c74c2-741e-48c3-ad9e-b137ec1c7243/till-menus" \
  -H "Authorization: Bearer $DNERO_API_KEY"

const response = await fetch('https://api.dev.dnerohq.com/v1/sites/9a3c74c2-741e-48c3-ad9e-b137ec1c7243/till-menus', {
  headers: {
    Authorization: `Bearer ${process.env.DNERO_API_KEY}`,
  },
})
const data = await response.json()

import os
import requests

response = requests.get(
    "https://api.dev.dnerohq.com/v1/sites/9a3c74c2-741e-48c3-ad9e-b137ec1c7243/till-menus",
    headers={"Authorization": f"Bearer {os.environ['DNERO_API_KEY']}"},
)
data = response.json()

200OKapplication/json

{
  "data": [
    {
      "active": true,
      "availability": [
        {
          "days": [
            "monday",
            "tuesday"
          ],
          "endsAt": "15:00",
          "startsAt": "11:00"
        }
      ],
      "code": "5a9e3c17-2d4b-4f80-a6c1-8b7d0e2f4a96",
      "name": "Lunch",
      "order": 1,
      "published": true,
      "sections": [
        {
          "buttons": [
            {
              "children": [],
              "name": "Flat white",
              "productCode": "7b3e9c14-2a6f-4d08-8b5e-c1f4a7d2e936",
              "type": "product"
            }
          ],
          "code": "s-9c2d",
          "colour": "#15803d",
          "name": "Hot drinks"
        }
      ],
      "updatedAt": "2026-10-20T03:15:00Z"
    }
  ],
  "nextCursor": "NmFkN2JjODU3ZWE1NzNiNGQ1NDEyNTg4"
}

400Bad Requestapplication/problem+json

{
  "type": "https://developers.dnerohq.com/guides/errors/#bad_request",
  "title": "Bad Request",
  "status": 400,
  "detail": "The request could not be read, for example malformed JSON.",
  "code": "bad_request"
}

401Unauthorizedapplication/problem+json

{
  "type": "https://developers.dnerohq.com/guides/errors/#missing_key",
  "title": "Unauthorized",
  "status": 401,
  "detail": "No API key was sent.",
  "code": "missing_key"
}

403Forbiddenapplication/problem+json

{
  "type": "https://developers.dnerohq.com/guides/errors/#key_revoked",
  "title": "Forbidden",
  "status": 403,
  "detail": "The key was revoked or switched off in the Dnero portal.",
  "code": "key_revoked"
}

404Not Foundapplication/problem+json

{
  "type": "https://developers.dnerohq.com/guides/errors/#site_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "The key does not reach that site, or there is no such site.",
  "code": "site_not_found"
}

422Unprocessable Entityapplication/problem+json

{
  "type": "https://developers.dnerohq.com/guides/errors/#invalid_request",
  "title": "Unprocessable Entity",
  "status": 422,
  "detail": "The request was read but is not valid.",
  "code": "invalid_request"
}

429Too Many Requestsapplication/problem+json

{
  "type": "https://developers.dnerohq.com/guides/errors/#rate_limited",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "The key has used its requests for this minute.",
  "code": "rate_limited"
}

500Internal Server Errorapplication/problem+json

{
  "type": "https://developers.dnerohq.com/guides/errors/#server_error",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "Something went wrong on Dnero's side. It has been logged.",
  "code": "server_error"
}

502Bad Gatewayapplication/problem+json

{
  "type": "https://developers.dnerohq.com/guides/errors/#upstream_unavailable",
  "title": "Bad Gateway",
  "status": 502,
  "detail": "Something Dnero depends on did not answer in time.",
  "code": "upstream_unavailable"
}

Examples use this site's API host. Keep the key in $DNERO_API_KEY; never paste it into code.