API v1

Vitalis Developer API

A clean REST surface for partners — bring assessments, protocols, and commerce into your own clinical workflow.

Latency

<120ms p95

Multi-region edge cache

Authentication

Bearer tokens

Scoped to workspace + role

Webhooks

Signed payloads

HMAC-SHA256 with rotating secrets

Status

Operational

Uptime 99.99% past 90d

Getting started

Base URL

https://api.vitalis.health/v1

bash

Authentication

curl https://api.vitalis.health/v1/members/mem_8f3 \
  -H "Authorization: Bearer vk_live_•••"

bash

Webhook verification

X-Vitalis-Signature: t=1719000000,v1=…
HMAC-SHA256 of "{t}.{body}" with whsec_•••

text

Reference

GET/v1/members/{id}

Bearer

Retrieve a member

Response 200

{ "id": "mem_8f3", "name": "Ava Chen", "joined": "2026-05-12" }

json

POST/v1/members

Bearer

Create a member

Request body

{ "name": "Ava Chen", "email": "ava@example.com" }

json

Response 200

{ "id": "mem_8f3", "name": "Ava Chen" }

json

Webhook events

assessment.completed

stable

protocol.activated

stable

protocol.paused

stable

order.created

stable

order.shipped

stable

order.delivered

stable

subscription.renewed

stable

subscription.cancelled

stable

member.created

stable