Skip to main content
GET
/
users
/
{user_id}
/
nutrition
/
meals
List meals
curl --request GET \
  --url https://production.api.onvy.health/users/{user_id}/nutrition/meals \
  --header 'X-API-Key: <api-key>'
{
  "meals": [
    {
      "id": "meal_01JCXVK5N3P4Q2R7S8T9U0V1W2",
      "user_id": "<string>",
      "project_id": "<string>",
      "meal_time": "2024-10-28T12:00:00Z",
      "analysis_status": "complete",
      "created_at": "2024-10-28T12:05:00Z",
      "updated_at": "2024-10-28T12:10:00Z",
      "description": "Grilled chicken breast with quinoa and steamed broccoli",
      "image_url": "https://s3.amazonaws.com/bucket/meals/image.jpg?X-Amz-...",
      "portion_multiplier": 1.5,
      "comment": "Homemade healthy lunch",
      "analysis_error": "Failed to analyze meal: Image is not food-related",
      "summary_id": "aisummary_01JCXVK5N3P4Q2R7S8T9U0V1W2",
      "ai_generated": true,
      "title": "Meal Summary",
      "text": "Great balanced meal! This chicken with broccoli and brown rice provides excellent protein (35g) with moderate carbs.",
      "name": "Grilled Chicken with Vegetables",
      "ingredients": "chicken breast, broccoli, brown rice, olive oil",
      "calories": 450,
      "protein_grams": 35,
      "fat_grams": 12,
      "carbohydrate_grams": 45,
      "sugar_grams": 5,
      "fiber_grams": 6,
      "glucose_spike_mg_dl": 25,
      "healthiness_score": "A"
    }
  ],
  "pagination": {
    "limit": 500,
    "total": 1,
    "page": "<string>",
    "next_page": "<string>"
  }
}

Authorizations

X-API-Key
string
header
required

API key for authentication

Path Parameters

user_id
string
required

User ID (e.g., google_104940819145861640201)

Query Parameters

page
string

Page Key for pagination

limit
integer
default:100

Number of items per page

Required range: 1 <= x <= 1000

Response

List of meals

Paginated list of meals

meals
Meal · object[]
required
pagination
Pagination · object
required