Skip to main content
health-api is ONVY’s multi-tenant backend for health data ingestion, metric calculation, AI-generated summaries, and conversational health surfaces. Use this portal when you need to:
  • Authenticate a server or SDK client with OAuth bearer tokens
  • Create and manage users plus their health records
  • Read harmonized daily records, baselines, facts, activities, meals, and custom records
  • Trigger AI summaries and chat completions with ONVY context
  • Receive outbound webhook events when data changes

​
Start here

Quickstart

Get a bearer token, create a user, and make your first API call.

Authentication

Understand OAuth flows, convenience auth endpoints, and scope rules.

Webhooks

Configure outbound event delivery with HMAC-signed payloads.

API reference

Browse the OpenAPI-backed endpoint reference for all public routes.

​
What the platform covers

​
Harmonized health data

ONVY ingests provider payloads, stores normalized records, and calculates health metrics into stable resource families such as daily_records, baselines, activities, meals, and facts.

​
AI surfaces

You can create AI meal summaries, fetch AI summary history, and call user-scoped chat completion endpoints that enrich prompts with ONVY context.

​
Event-driven integration

Webhook delivery is asynchronous. ONVY batches matching events, signs each payload with HMAC-SHA256, and logs delivery outcomes for auditability.

​
Integration path

  1. Get your project_id and OAuth client credentials.
  2. Exchange credentials for an ONVY bearer token.
  3. Create users and start writing or reading health resources.
  4. Configure webhooks if your integration needs outbound updates.
  5. Use the API reference to expand into AI, meals, custom records, and record-specific flows.
New integrations should use bearer authentication. The internal API-key shim exists only for migration compatibility.