Documentation
Learn how to use VitalTrajectory to track and improve your health
Getting Started
Welcome to VitalTrajectory!
VitalTrajectory helps you track your health journey by logging daily metrics, monitoring trends, and managing your medical records all in one place.
Step 1: Create Your Account
Click "Get Started" to create your free account. You'll be guided through a quick 4-step setup process.
Step 2: Complete Your Health Profile
During onboarding, you'll set up your health profile with:
- Your height and weight
- Date of birth and gender
- Activity level
- Starting measurements (waist, hips, neck)
- Any known health issues
Don't worry - you can update this information anytime in Settings.
Step 3: Choose What to Track
Select which daily log features you want to use:
- Body Metrics - Weight, measurements, body fat
- Exercise - Workout sessions and activity
- Food & Nutrition - Meals, calories, macros
- Sleep & Stress - Sleep quality and stress levels
- Blood Pressure - Blood pressure readings
- Bowel Movements - Digestive health tracking
Step 4: Choose Your Logging Style
Select how you prefer to log your daily information:
- Quick Log - Fast, streamlined logging for essential metrics
- Advanced Log - Comprehensive logging with all available fields
You can switch between modes anytime in your Daily Log settings.
You're All Set!
Start logging your first daily entry and explore your personalized dashboard to see your health trends and insights.
Daily Logging
Creating a Daily Log Entry
- Navigate to Daily Log from the main menu
- Select the date you want to log (or use today's date)
- Fill in the sections you want to track:
- Body Metrics - Enter your weight and measurements
- Exercise - Add exercise sessions with start/finish times
- Food & Nutrition - Log meals and track calories
- Sleep & Stress - Record sleep duration and quality
- Blood Pressure - Add blood pressure readings
- Bowel Movements - Track digestive health
- Notes - Add any additional notes for the day
- Click Save to store your entry
Quick Log vs Advanced Log
Quick Log
Pin your most-used sections to the Quick Log view for faster daily entry. Perfect for quick check-ins with essential metrics.
Advanced Log
See all available sections at once. Ideal for comprehensive daily tracking when you have more time.
Editing Entries
You can edit any daily log entry by:
- Going to Daily Log → All Logs
- Clicking on the date you want to edit
- Making your changes and clicking Save
Dashboard & Reports
Your Dashboard
The dashboard gives you an overview of your health journey with key metrics and trends.
Key Metrics
- Current Weight - Your most recent weight with 7-day change
- BMI - Body Mass Index calculated from your height and weight
- Daily Calorie Goal - Personalized based on your profile
- Weekly Loss Rate - Your average weight change per week
Charts & Trends
Visualize your progress with interactive charts showing:
- Weight trends over time
- Body measurements (waist, hips, neck)
- Exercise hours
- Calorie intake
- Sleep duration
- Stress scores
Daily Vitality Score
Your Daily Vitality Score (DVS) is a 0-100 score that reflects how well you're meeting your health goals based on:
- Exercise activity
- Sleep quality
- Nutrition goals
- Stress management
Reports
Access detailed reports from the Reports menu:
- Daily Report - Summary for a specific date
- Weekly Report - Week-over-week analysis
- Monthly Report - Monthly trends and insights
Health Profile
Managing Your Health Profile
Your health profile contains baseline information used for calculations and insights.
Accessing Your Profile
Go to Settings → Health Profile to view and edit your profile.
Profile Information
- Physical Stats - Height, weight, measurements
- Demographics - Date of birth, gender
- Activity Level - Used for calorie calculations
- Health Issues - Known conditions or concerns
- Unit Preferences - Imperial or Metric
Why This Matters
Your profile information is used to:
- Calculate your BMI
- Determine your daily calorie goals
- Provide personalized insights
- Track changes from your starting point
Medical Records
Tracking Medical Information
Keep all your medical information organized in one place.
Medical Visits
Record doctor appointments, specialist visits, and consultations:
- Date and provider
- Visit type and reason
- Notes and outcomes
Medications
Track your medications with:
- Medication name and dosage
- Prescribing provider
- Start and end dates
- Schedule and reminders
Procedures & Tests
Record medical procedures and test results:
- Procedure/test name and date
- Associated medical visit
- Results and notes
Blood Work
Track lab results and blood work over time to monitor changes.
Device Integrations
Connect Your Health Devices
Automatically sync data from your favorite health tracking devices and apps.
Oura Ring
Connect your Oura Ring to automatically import:
- Sleep data (duration, quality, stages)
- Heart rate (resting and throughout the day)
- Readiness scores
- Activity data
How to connect: Go to Settings → Integrations and click "Connect Oura Ring". You'll be redirected to authorize the connection.
Fitbit
Sync your Fitbit device to import:
- Activity and steps
- Sleep data
- Heart rate
- Exercise sessions
How to connect: Go to Settings → Integrations and click "Connect Fitbit". Authorize the connection when prompted.
Apple Health
Import data from Apple HealthKit on your iOS device.
How to connect: Use the VitalTrajectory iOS app to sync your Apple Health data.
Billing & Plans
Subscription Plans
Vital Trajectory offers two plans: Standard and Premium, available in both monthly and annual billing options. All users start with a 14-day free trial (no credit card required).
14-Day Free Trial
Every new user gets a 14-day free trial with access to all Standard features. No credit card required to start. Upgrade anytime during or after your trial.
Standard Plan
Pricing: $9.99/month or $99.90/year (2 months free)
The Standard plan includes everything you need to organize your health in one place:
- Full daily log system for symptoms, vitals, and metrics
- Track weight, blood pressure, heart rate, and measurements
- Log medications, labs, procedures, and visits
- Goals, fasting, and exercise tracking
- Core dashboards and charts
- Document uploads and secure storage (fair use)
- Dark mode and user activity history
- Basic export (CSV and PDF) and weekly/monthly overviews
- Exercise, fasting, and sleep timers
Premium Plan
Pricing: $17.99/month or $179.90/year (2 months free)
The Premium plan includes everything in Standard, plus advanced analytics and insights:
- Lifestyle correlations engine
- Advanced analytics dashboards
- Trend forecasting and progress modeling
- Multi-year pattern detection
- Deeper goal insights and progress analysis
- Habit-to-symptom insights
- Unlimited document uploads
- Doctor-ready reports and visit summaries
- Auto-generated monthly health summaries
- Clinician-friendly outputs designed for medical visits
- Priority support
- Early/beta access to new features
Upgrading or Managing Your Plan
- Go to Settings → Billing
- Choose your plan (Standard or Premium)
- Complete the secure checkout process
- Your account will be upgraded immediately
Managing Your Subscription
From the Billing page, you can:
- View your current plan
- Update payment method
- View billing history
- Cancel your subscription (you'll retain access until the end of your billing period)
API Documentation
Using the VitalTrajectory API
VitalTrajectory provides a RESTful API that allows you to programmatically access your health data and integrate with other applications.
Base URL
https://vitaltrajectory.com/api
Authentication
The API uses token-based authentication. After logging in, you'll receive an access token that must be included in all API requests.
Getting Your API Token
- Log in to your VitalTrajectory account
- Go to Settings → API (coming soon)
- Generate a new API token
- Store it securely - you won't be able to see it again
Using Your Token
Include your token in the Authorization header of all API requests:
Authorization: Bearer your-token-here
Accept: application/json
Content-Type: application/json
Available Endpoints
| Method | Endpoint | Description |
|---|---|---|
| POST | /api/login |
Authenticate and get access token |
| GET | /api/user |
Get your user profile information |
| GET | /api/dashboard |
Get dashboard data and metrics |
| GET | /api/daily-log |
List your daily log entries |
| GET | /api/daily-log/{date} |
Get a specific daily log (date format: YYYY-MM-DD) |
| POST | /api/daily-log |
Create a new daily log entry |
| PUT | /api/daily-log/{id} |
Update an existing daily log |
| GET | /api/reports/daily |
Get daily report for a specific date |
| GET | /api/reports/weekly |
Get weekly report |
| GET | /api/reports/monthly |
Get monthly report |
Example Request
Here's an example of fetching your daily log for today:
curl -X GET "https://vitaltrajectory.com/api/daily-log/2025-12-11" \
-H "Authorization: Bearer your-token-here" \
-H "Accept: application/json"