vital

library2.1.569pypypiunverified

Vital is a Python client for the Vital API, enabling integration with health data from wearables and medical devices. The current version is 2.1.569, offering features like body metrics, activity, sleep, and lab results. It follows a monthly release cadence with expanding provider support.

health

pip install vital

github ↗homepage ↗

INSTALL

IMPORT

SIG · VITAL

vital

healthpythonv2.1.569

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

VitalClient

✓ from vital import VitalClient

✗ from vital import VitalClient

Initialize VitalClient with API key and environment, then fetch body vitals from a provider.

from vital import VitalClient import os client = VitalClient(api_key=os.environ.get('VITAL_API_KEY', ''), environment='sandbox') health_data = client.body.vitals(provider='oura', start_date='2024-01-01', end_date='2024-01-07') print(health_data)

Debug

Known issues

breakingIn v2.0, the client initialization changed from `Vital(api_key=...)` to `VitalClient(api_key=...)`. The old class name no longer exists.

fix

Use `from vital import VitalClient` and instantiate `VitalClient(api_key=...)`.

affects: >=2.0.0

deprecatedThe `environment` parameter in VitalClient is being replaced by `base_url`. Passing 'sandbox' or 'production' via environment still works but is deprecated.

fix

Use `base_url='https://api.sandbox.vital.io'` or the production URL directly.

affects: <2.2.0 (future)

gotchaAPI key must be provided; missing it raises a vague authentication error. Always set VITAL_API_KEY environment variable or pass api_key explicitly.

fix

Set environment variable VITAL_API_KEY before instantiating client, or pass as argument.

affects: all

gotchaDate formats must be ISO 8601 (YYYY-MM-DD). Using other formats like MM/DD/YYYY causes parsing errors.

fix

Always use 'YYYY-MM-DD' for date parameters.

affects: all

Upgrade

Version history

2.1.569latest on PyPI · released Jan 14, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

10 hits · last 30 days

node

Resources

githubhttps://github.com/tryVital/vital-python ↗

homepagehttps://github.com/tryVital/vital-python ↗