Skip to main content
GET
/
v2
/
summary
/
meal
/
{user_id}
curl --request GET \
     --url {{BASE_URL}}/v2/summary/meal/{user_id}?start_date={{START_DATE}}&end_date={{END_DATE}} \
     --header 'Accept: application/json' \
     --header 'x-vital-api-key: <API_KEY>'
from junction import Junction
from junction.environment import JunctionEnvironment

client = Junction(
    api_key="YOUR_API_KEY",
    environment=JunctionEnvironment.SANDBOX,
)

data = client.meal.get(
    "<user_id>",
    start_date="2021-01-01",
    end_date="2021-01-02",
)
import { JunctionClient, JunctionEnvironment } from "@junction-api/sdk";

const client = new JunctionClient({
    apiKey: "YOUR_API_KEY",
    environment: JunctionEnvironment.Sandbox,
});

const data = await client.meal.get({
    userId: "<user_id>",
    startDate: "2021-01-01",
    endDate: "2021-01-02",
});
import com.junction.api.Junction;
import com.junction.api.core.Environment;
import com.junction.api.resources.meal.requests.GetMealRequest;

Junction client = Junction.builder()
    .apiKey("YOUR_API_KEY")
    .environment(Environment.SANDBOX)
    .build();

var data = client.meal().get(
    "<user_id>",
    GetMealRequest.builder()
        .startDate("2021-01-01")
        .endDate("2021-01-02")
        .build()
);
import (
    "context"

    junction "github.com/junction-api/junction-go"
    "github.com/junction-api/junction-go/client"
    "github.com/junction-api/junction-go/option"
)

c := client.NewClient(
    option.WithApiKey("YOUR_API_KEY"),
    option.WithBaseURL(junction.Environments.Sandbox),
)

endDate := "2021-01-02"
response, err := c.Meal.Get(context.TODO(), &junction.GetMealRequest{
    UserId:    "<user_id>",
    StartDate: "2021-01-01",
    EndDate:   &endDate,
})
if err != nil {
    return err
}
fmt.Printf("Received data %s\n", 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"
    }
  ]
}
{
"detail": "<unknown>"
}
curl --request GET \
     --url {{BASE_URL}}/v2/summary/meal/{user_id}?start_date={{START_DATE}}&end_date={{END_DATE}} \
     --header 'Accept: application/json' \
     --header 'x-vital-api-key: <API_KEY>'
from junction import Junction
from junction.environment import JunctionEnvironment

client = Junction(
    api_key="YOUR_API_KEY",
    environment=JunctionEnvironment.SANDBOX,
)

data = client.meal.get(
    "<user_id>",
    start_date="2021-01-01",
    end_date="2021-01-02",
)
import { JunctionClient, JunctionEnvironment } from "@junction-api/sdk";

const client = new JunctionClient({
    apiKey: "YOUR_API_KEY",
    environment: JunctionEnvironment.Sandbox,
});

const data = await client.meal.get({
    userId: "<user_id>",
    startDate: "2021-01-01",
    endDate: "2021-01-02",
});
import com.junction.api.Junction;
import com.junction.api.core.Environment;
import com.junction.api.resources.meal.requests.GetMealRequest;

Junction client = Junction.builder()
    .apiKey("YOUR_API_KEY")
    .environment(Environment.SANDBOX)
    .build();

var data = client.meal().get(
    "<user_id>",
    GetMealRequest.builder()
        .startDate("2021-01-01")
        .endDate("2021-01-02")
        .build()
);
import (
    "context"

    junction "github.com/junction-api/junction-go"
    "github.com/junction-api/junction-go/client"
    "github.com/junction-api/junction-go/option"
)

c := client.NewClient(
    option.WithApiKey("YOUR_API_KEY"),
    option.WithBaseURL(junction.Environments.Sandbox),
)

endDate := "2021-01-02"
response, err := c.Meal.Get(context.TODO(), &junction.GetMealRequest{
    UserId:    "<user_id>",
    StartDate: "2021-01-01",
    EndDate:   &endDate,
})
if err != nil {
    return err
}
fmt.Printf("Received data %s\n", response)

Authorizations

x-vital-api-key
string
header
required

Vital Team API Key

Path Parameters

user_id
string<uuid>
required

Query Parameters

provider
string
default:""

Provider oura/strava etc

start_date
string
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

end_date
string | null

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

meals
MealInDBBase[ClientFacingSource] · object[]
required