The reservation book, as an API.

# everything that changed since your last sync
curl https://api.nomnom-app.net/api/v1/reservations \
  -H "Authorization: Bearer $NOMNOM_KEY" \
  -G -d updated_since=2026-08-13T18:30:00 \
     -d limit=100

var url = "https://api.nomnom-app.net/api/v1/reservations"
        + "?updated_since=2026-08-13T18:30:00&limit=100";

var page = await http.GetFromJsonAsync<Page>(url);
foreach (var r in page.Data)
    tillBook.Upsert(r.Id, r.Date, r.Time, r.State);

const url = new URL('https://api.nomnom-app.net/api/v1/reservations');
url.searchParams.set('updated_since', lastSync);
url.searchParams.set('limit', '100');

const { data, has_more, next_cursor } =
  await (await fetch(url, { headers })).json();

r = requests.get(
    "https://api.nomnom-app.net/api/v1/reservations",
    headers={"Authorization": f"Bearer {api_key}"},
    params={"updated_since": last_sync, "limit": 100},
)
page = r.json()

Authorization: Bearer nn_live_a1b2c3d4e5f6g7h8i9j0klmnopqrstuv

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "The API key provided is not valid.",
    "param": "",
    "request_id": "req_8f2a41"
  }
}

{
  "error": {
    "type": "permission_error",
    "code": "insufficient_scope",
    "message": "This API key does not have the
                 required scope: reservations:write"
  }
}

// A 19:00 booking in Europe/London on 20 Aug
// is 18:00 UTC - British Summer Time.
const instant = Temporal.ZonedDateTime.from(
  `${r.date}T${r.time}[${r.timezone}]`
);

instant.toInstant().toString();
// 2026-08-20T18:00:00Z

{
  "date":     "2026-08-20",
  "time":     "19:00",
  "timezone": "Europe/London",

  "created_at": "2026-08-01T10:15:00",
  "updated_at": "2026-08-13T18:30:12"
}

let cursor = '', all = [];

do {
  const u = new URL(base + '/api/v1/reservations');
  u.searchParams.set('updated_since', lastSync);
  if (cursor) u.searchParams.set('cursor', cursor);

  const page = await (await fetch(u, { headers })).json();
  all.push(...page.data);
  cursor = page.next_cursor;
} while (cursor);

cursor, all_rows = "", []

while True:
    params = {"updated_since": last_sync}
    if cursor:
        params["cursor"] = cursor

    page = requests.get(url, headers=h, params=params).json()
    all_rows += page["data"]
    cursor = page["next_cursor"]
    if not cursor:
        break

{
  "error": {
    "type":       "invalid_request_error",
    "code":       "invalid_parameter",
    "message":    "date_from must be YYYY-MM-DD.",
    "param":      "date_from",
    "request_id": "req_8f2a41"
  }
}

if (!res.ok) {
  const { error } = await res.json();

  switch (error.code) {
    case 'rate_limited':
      return retryAfter(res.headers.get('Retry-After'));
    case 'revoked_api_key':
      return alertOps(error.request_id);
    default:
      throw new Error(`${error.code}: ${error.message}`);
  }
}

curl https://api.nomnom-app.net/api/v1/reservations \
  -H "Authorization: Bearer $NOMNOM_KEY" \
  -G -d date=2026-08-20 \
     -d limit=50

var q = "?date=2026-08-20&limit=50";
var page = await http.GetFromJsonAsync<Page>(
    $"https://api.nomnom-app.net/api/v1/reservations{q}");

const u = new URL(base + '/api/v1/reservations');
u.searchParams.set('date', '2026-08-20');
u.searchParams.set('limit', '50');

const page = await (await fetch(u, { headers })).json();

{
  "data": [ { /* reservation objects */ } ],
  "has_more": true,
  "next_cursor": "djF8MjAyNi0wOC0xMyAxODozMDoxMnxyZXNf..."
}

curl https://api.nomnom-app.net/api/v1/reservations/res_9c41e0 \
  -H "Authorization: Bearer $NOMNOM_KEY"

{
  "error": {
    "type": "invalid_request_error",
    "code": "not_found",
    "message": "No reservation found with that id."
  }
}

{
  "id": "res_9c41e0",
  "reference": "NN-4831",
  "state": "booked",
  "status": "Confirmed",
  "date": "2026-08-20",
  "time": "19:00",
  "timezone": "Europe/London",
  "duration_minutes": 120,
  "adults": 2,
  "children": 1,
  "guest": {
    "first_name": "Jane",
    "last_name": "Smith",
    "email": "jane.smith@example.com",
    "mobile": "+447700900123"
  },
  "tables": ["12", "13"],
  "notes": "Window table if possible.",
  "deposit_paid_minor": 4000,
  "currency": "GBP",
  "source": "online",
  "created_at": "2026-08-01T10:15:00",
  "updated_at": "2026-08-13T18:30:12"
}

// System.Text.Json ignores unknown members by
// default - that is the behaviour you want.
public record Reservation(
    string Id,
    string Reference,
    string State,
    string Date,
    string Time);

// Branch on State, never on Status.
var seated = rows.Where(r => r.State == "seated");