Intended Audience

This page describes who the athlete-nutrition-ai API is designed for and what background knowledge you should have before integrating with it. Understanding the intended audience helps you assess whether this API fits your use case and ensures you can follow the rest of the documentation effectively.

Who This Guide Is For

This guide is for athletes and health-conscious individuals who want personalized, AI-powered nutrition planning tied to their training schedule. Whether you are a competitive athlete, a weekend warrior, or simply someone working toward fitness goals, this app adapts your meal planning to your activity level and upcoming workouts.

No technical knowledge is required. Everything is accessible through the app's interface — no code, no configuration, just your goals and your training data.

What You Can Do

Inside the app, you can:

1. Create your profile — Set your dietary preferences, restrictions, and physical attributes so the AI can personalize its recommendations.
2. Connect your training calendar — Link your workout schedule so the app can plan your nutrition around your actual training load.
3. Chat with your AI nutrition advisor — Ask questions and receive personalized guidance tailored to your goals and upcoming sessions.
4. Generate meal plans and shopping lists — Get structured, ready-to-use outputs you can follow day by day.
5. Manage your subscription — Choose the plan tier that fits your needs and unlocks the features you want.

Section: "Examples"

Current content: The following example shows the kind of request the app makes on your behalf when you connect your athlete profile. It illustrates a simple authenticated request to retrieve your upcoming training events — a common early step in the nutrition planning workflow.

Retrieve upcoming training events for your athlete profile

{
  "athlete_id": "ath_01hx93j2kpq",
  "window": "7d",
  "events": [
    {
      "event_id": "evt_a7f3c",
      "type": "long_run",
      "scheduled_at": "2024-08-14T07:00:00Z",
      "duration_minutes": 90,
      "intensity": "moderate"
    },
    {
      "event_id": "evt_b2d8e",
      "type": "strength_training",
      "scheduled_at": "2024-08-16T06:30:00Z",
      "duration_minutes": 60,
      "intensity": "high"
    }
  ]
}

This is the training data the app retrieves for the next seven days once you log in. It is passed automatically to the AI nutrition advisor to generate a meal plan tailored to your upcoming workouts.

• Authentication overview — How to obtain and refresh access tokens before making API calls.
• Athlete profile setup — What athlete data the API expects and why each field influences nutrition recommendations.
• Training calendar integration — How to connect an external calendar source so the API can read upcoming events.
• AI nutrition advisor — How the conversational endpoint works and what kinds of inputs it accepts.
• Error handling — How the API signals problems and what your application should do in response.
• Subscription and entitlements — How plan tiers affect which endpoints and features are available to your integration.