VitaWell API & Integrations

Connect your systems to VitaWell's comprehensive health & wellness platform. Access health programs, nutrition data, wellness metrics, and real-time patient insights through our RESTful API.

JavaScript // Create a new wellness client
const client = await vitawell.createClient({ api_key: 'vwl_live_sk_...', environment: 'production' });

// Fetch health program
const program = await client.programs .list({ type: 'nutrition' });

📡

↑ 12%

847

Active Integrations

⚡

↑ 5%

2.1ms

Avg Response Time

🔗

Stable

99.98%

Uptime (30 days)

📈

↑ 23%

2.4M

API Calls (Today)

📋 API Endpoints

GET /v2/health-programs List all available health and wellness programs v2.4

Query Parameters

Parameter	Type	Status	Description
`type`	string	Optional	Filter by program type: nutrition, fitness, mindfulness, sleep
`category`	string	Optional	Category: holistic, preventive, therapeutic
`limit`	integer	Optional	Number of results (default: 20, max: 100)

Response (200 OK)

{ "data": [ { "id": "prog_2xk9m4p", "name": "Holistic Nutrition Reset", "type": "nutrition", "duration_weeks": 12, "status": "active" } ], "pagination": { "total": 48, "page": 1 } }

POST /v2/clients Register a new wellness client v2.4

Request Body

Parameter	Type	Status	Description
`full_name`	string	Required	Client's full legal name
`email`	string	Required	Valid email address
`dob`	date	Required	Date of birth (YYYY-MM-DD)
`health_goals`	array	Optional	Array of wellness goal IDs

POST /v2/health-metrics Submit health metric data for a client v2.3

Request Body

Parameter	Type	Status	Description
`client_id`	string	Required	VitaWell client identifier
`metrics`	object	Required	Key-value pairs of health measurements
`source`	string	Optional	Data source: wearable, manual, lab

PUT /v2/appointments/:id Update or reschedule an appointment v2.2

Response Codes

200 OK 401 Unauthorized 404 Not Found

GET /v2/nutrition-plans/:client_id Retrieve personalized nutrition plan v2.4

Response

{ "meal_plans": [ { "day": "monday", "meals": [ { "type": "breakfast", "items": ["quinoa bowl", "green smoothie"], "calories": 450 } ] } ] }

DELETE /v2/subscriptions/:id Cancel a client's wellness subscription v2.1

Response Codes

200 Cancelled 401 Unauthorized

PATCH /v2/clients/:id/wellness-goals Update client wellness goals v2.4

Request Body

Parameter	Type	Status	Description
`goals`	array	Required	Updated wellness goal objects
`priority`	string	Optional	Goal priority: high, medium, low

🔌 Integration Guides

🔐

Authentication Setup

Learn how to authenticate with the VitaWell API using API keys, OAuth 2.0, and service-to-service tokens.

⏱ 5 min read 📄 3 steps

🏥

EHR Integration (FHIR)

Integrate with Electronic Health Records using FHIR R4 standards. Sync patient data bidirectionally.

⏱ 12 min read 📄 8 steps

📱

Wearable Devices Sync

Connect Apple Watch, Fitbit, Oura Ring, and Garmin data to VitaWell health dashboards automatically.

⏱ 8 min read 📄 5 steps

🪝

Webhook Configuration

Set up real-time event notifications for client enrollment, metric updates, and program completions.

⏱ 6 min read 📄 4 steps

💳

Payment Integration

Integrate billing, subscription management, and insurance claim processing via our payments API.

⏱ 10 min read 📄 6 steps

🤖

AI Wellness Insights

Use our AI endpoints to generate personalized health insights, risk scores, and program recommendations.

⏱ 7 min read 📄 5 steps

🪝 Webhook Events

Receive real-time notifications when events occur in your VitaWell account. Configure endpoint URLs and subscribe to events.

👤

client.created

New wellness client registered

📊

metrics.updated

Health metrics data submitted

✅

program.completed

Wellness program milestone reached

📅

appointment.scheduled

New appointment booked

💳

payment.received

Subscription payment processed

⚠️

health.alert

AI-generated health alert triggered

// Webhook signature verification const sig = crypto.createHmac('sha256', webhookSecret) .update(rawBody).digest('hex'); if (sig === req.headers['x-vitawell-signature']) { console.log('✅ Webhook verified'); }

📦 SDK Installation

Get started quickly with official SDKs. Install the package that matches your tech stack.

Node.js

JavaScript / TypeScript

npm install @vitawell/sdk-js

Python

Python 3.8+

pip install vitawell-python

Ruby

Ruby 2.7+

gem install vitawell-ruby

⚡ Rate Limits & Tiers

API access is structured in tiers to ensure reliability. Upgrade anytime based on your integration needs.

Developer

Free

✓ 100 requests / minute
✓ 10,000 requests / day
✓ Sandbox access
✓ Community support
✓ 1 API key

Recommended

Business

$199 /month

✓ 1,000 requests / minute
✓ 500,000 requests / day
✓ Production + Sandbox
✓ Priority email support
✓ 5 API keys
✓ Webhook retry logic

Enterprise

Custom

✓ Unlimited requests
✓ Dedicated infrastructure
✓ SLA guarantee (99.99%)
✓ Dedicated account manager
✓ Unlimited API keys
✓ Custom integrations