---
title: "List meals for a date; otherwise return recent meals up to limit (default 500)"
method: GET
path: "/v1/meals"
tags: ["meals"]
---

# List meals for a date; otherwise return recent meals up to limit (default 500)

`GET /v1/meals`

## Request

- Base URL: `http://localhost:4318`
- URL: `http://localhost:4318/v1/meals`
- Auth: HTTP bearer

## Query parameters

- `date` string, date
- `limit` integer

## Response `200`

Success

- Meal[]
  - `title` string, required
  - `items` object[], required
    - `calories` number, required
    - `protein` number, required
    - `carbs` number, required
    - `fat` number, required
    - `id` string, required
    - `name` string, required
    - `grams` number, nullable, required
    - `preparation` string
    - `emoji` string
    - `source` string, required
    - `sourceUrl` string, uri
    - `basis` 'database' | 'estimate' | 'measured', required
    - `calorieLow` number, required
    - `calorieHigh` number, required
  - `confidence` 'high' | 'medium' | 'low' | 'measured', required
  - `assumptions` string[], required
  - `id` string, uuid, required
  - `eatenAt` string, date-time, required
  - `description` string, required
  - `mealType` 'breakfast' | 'lunch' | 'dinner' | 'snack', required
  - `source` string, required
  - `revision` integer, required
  - `calories` number, required
  - `protein` number, required
  - `carbs` number, required
  - `fat` number, required
  - `calorieLow` number, required
  - `calorieHigh` number, required

## Other responses

- `400`: Invalid input
- `401`: Missing or invalid bearer token
- `409`: Revision or idempotency conflict
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/nibb/apis/nibb-api.md) · [All operations](https://skmtc.dev/nibb/apis/nibb-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nibb/apis/nibb-api/revisions/75bcd8b761ed?raw)