v71

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-032076961.5 MB
summary

Get Meals

Get user's meals

get/v2/summary/meal/{user_id}

Path parameters

user_idstring uuid required

Query parameters

providerstring

Provider oura/strava etc

Provider oura/strava etc

start_datestring required

Date from in YYYY-MM-DD or ISO formatted date time. If a date is provided without a time, the time will be set to 00:00:00

Date from in YYYY-MM-DD or ISO formatted date time. If a date is provided without a time, the time will be set to 00:00:00

end_datestring nullable

Date to YYYY-MM-DD or ISO formatted date time. If a date is provided without a time, the time will be set to 23:59:59

Date to YYYY-MM-DD or ISO formatted date time. If a date is provided without a time, the time will be set to 23:59:59

Response

Successful Response

Example response

{
  "meals": [
    {
      "calendar_date": "2019-08-24",
      "created_at": "2023-02-27T20:31:24+00:00",
      "data": {
        "Chiken coquet starter": {
          "energy": {
            "unit": "kcal",
            "value": 400
          },
          "macros": {
            "carbs": 75,
            "fats": {
              "monounsaturated": 1,
              "omega3": 0,
              "omega6": 0,
              "polyunsaturated": 1,
              "saturated": 98,
              "total": 100
            },
            "protein": 10,
            "sugar": 25
          },
          "micros": {
            "minerals": {
              "sodium": 500
            }
          }
        },
        "Coffee, black, 1 tbsp(s)": {
          "energy": {
            "unit": "kcal",
            "value": 0
          },
          "macros": {
            "carbs": 0,
            "fats": {
              "total": 0
            },
            "protein": 0,
            "sugar": 0
          },
          "micros": {
            "minerals": {
              "sodium": 0
            }
          }
        }
      },
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "Dinner",
      "priority_id": 42,
      "provider_id": "123456",
      "source": {
        "app_id": "com.myfitnesspal.mfp",
        "device_id": "550e8400-e29b-41d4-a716-446655440000",
        "provider": "apple_health_kit",
        "type": "unknown"
      },
      "source_app_id": "com.myfitnesspal.mfp",
      "source_id": 10,
      "timestamp": "2019-08-24T00:00:00Z",
      "updated_at": "2023-02-28T01:22:38+00:00",
      "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5"
    }
  ]
}