# ForeverBetter API

## Docs

- [Action plans](https://foreverbetter.mintlify.app/action-plans.md): Turn an analysis into a prioritized set of lifestyle interventions and an evidence-graded supplement stack, cross-referenced against what the user already takes.
- [Agents & MCP](https://foreverbetter.mintlify.app/agents-and-mcp.md): Discover the service, list scoped tools, and call them over MCP or REST.
- [Agent manifest](https://foreverbetter.mintlify.app/api-reference/agent-manifest.md): Agent discovery manifest: base URL, auth requirements, available endpoints, and MCP tool list, so an autonomous agent can self-configure.
- [Analyze biomarker results](https://foreverbetter.mintlify.app/api-reference/analyze-biomarker-results.md): Interpret direct and derived biomarker results from existing uploaded lab sources.
- [Analyze wearable observations](https://foreverbetter.mintlify.app/api-reference/analyze-wearable-observations.md): Analyze sleep, recovery, activity, and cardiovascular observations from wearable sources.
- [Build a customized action plan (interventions + evidence-graded supplement stack) for an analysis](https://foreverbetter.mintlify.app/api-reference/build-a-customized-action-plan-interventions-+-evidence-graded-supplement-stack-for-an-analysis.md): Build a customized action plan (lifestyle interventions + an evidence-graded supplement stack) mapped from a stored analysis, cross-referenced against the user's logged supplements and medications.
- [Build provider OAuth URL](https://foreverbetter.mintlify.app/api-reference/build-provider-oauth-url.md): Build an OAuth authorization URL for WHOOP. (Google Health Connect connects via the mobile bridge through /connections/wearables/start.)
- [Calculate derived biomarkers](https://foreverbetter.mintlify.app/api-reference/calculate-derived-biomarkers.md): Calculate supported derived biomarkers from existing uploaded lab sources.
- [Capability registry](https://foreverbetter.mintlify.app/api-reference/capability-registry.md): List supported health data modalities, providers, setup requirements, and normalized outputs.
- [Complete generic wearables connection](https://foreverbetter.mintlify.app/api-reference/complete-generic-wearables-connection.md): Complete a generic wearables OAuth callback and register the connected account.
- [Compute longitudinal biomarker and wearable trends](https://foreverbetter.mintlify.app/api-reference/compute-longitudinal-biomarker-and-wearable-trends.md): Compute longitudinal biomarker and wearable trends (direction, delta, and status) across all uploads for a user.
- [Compute retest reminders per modality](https://foreverbetter.mintlify.app/api-reference/compute-retest-reminders-per-modality.md): Compute retest reminders (due, upcoming, or current) from the freshest data per modality against a cadence.
- [Create a health goal](https://foreverbetter.mintlify.app/api-reference/create-a-health-goal.md): Create a health goal (target metric, direction, value, and optional due date) for a user.
- [Delete a health goal](https://foreverbetter.mintlify.app/api-reference/delete-a-health-goal.md): Delete a health goal.
- [Endpoint catalog](https://foreverbetter.mintlify.app/api-reference/endpoint-catalog.md): Machine-readable catalog of every endpoint with its method, path, required scopes, and MCP tool name.
- [Exchange provider OAuth code](https://foreverbetter.mintlify.app/api-reference/exchange-provider-oauth-code.md): Exchange a provider OAuth code for provider tokens.
- [Export user data](https://foreverbetter.mintlify.app/api-reference/export-user-data.md): Export tenant-scoped user data and return a portability receipt.
- [Find nearby labs](https://foreverbetter.mintlify.app/api-reference/find-nearby-labs.md): Find Quest and SYNLAB patient service centers near a user-selected area. Returns real locations via partner APIs when available, with locator handoff fallback.
- [Find providers across modalities (genetics, biomarkers/labs, wearables)](https://foreverbetter.mintlify.app/api-reference/find-providers-across-modalities-genetics-biomarkerslabs-wearables.md): Find where to get health data across modalities in one call: pass modality=genetics,biomarkers,wearables to get WGS/genetic-testing providers, nearby lab draw sites (with a location), and supported wearable integrations. Results are grouped by modality.
- [Get a design system with tokens + DESIGN.md](https://foreverbetter.mintlify.app/api-reference/get-a-design-system-with-tokens-+-designmd.md): Get a design system's full tokens (color, typography, spacing, radii, elevation, motion, components) plus a ready-to-paste DESIGN.md. Public reference data.
- [Get a specific genetic testing provider](https://foreverbetter.mintlify.app/api-reference/get-a-specific-genetic-testing-provider.md): Get details for a specific genetic testing provider by id.
- [Health check](https://foreverbetter.mintlify.app/api-reference/health-check.md): Liveness probe. Returns 200 whenever the process is running; does not check dependencies.
- [Issue scoped API key](https://foreverbetter.mintlify.app/api-reference/issue-scoped-api-key.md): Issue a scoped bearer API key for an authenticated user or organization.
- [List a user's health goals](https://foreverbetter.mintlify.app/api-reference/list-a-users-health-goals.md): List a user's health goals with status.
- [List analyses for a user](https://foreverbetter.mintlify.app/api-reference/list-analyses-for-a-user.md): List stored analyses for the authenticated user with optional modality, since, and limit filters.
- [List design systems for health UIs](https://foreverbetter.mintlify.app/api-reference/list-design-systems-for-health-uis.md): List curated design-token sets for health & wellness UIs, inspired by well-known apps. Public reference data — no auth required.
- [List uploaded sources for a user](https://foreverbetter.mintlify.app/api-reference/list-uploaded-sources-for-a-user.md): List uploaded source documents for the authenticated user with optional category, since, and limit filters.
- [List WGS and genetic testing providers](https://foreverbetter.mintlify.app/api-reference/list-wgs-and-genetic-testing-providers.md): List whole genome sequencing (WGS), exome, and SNP array providers with pricing, turnaround, data formats, and regional availability.
- [MCP JSON-RPC endpoint](https://foreverbetter.mintlify.app/api-reference/mcp-json-rpc-endpoint.md): Model Context Protocol (MCP) JSON-RPC endpoint: handles initialize, tools/list, and tools/call over the same capabilities as the REST API.
- [OpenAPI schema](https://foreverbetter.mintlify.app/api-reference/openapi-schema.md): This OpenAPI 3.1 specification, generated from the same schema source the service validates requests against.
- [Pricing, limits, and caching policy](https://foreverbetter.mintlify.app/api-reference/pricing-limits-and-caching-policy.md): List public pricing tiers, rate limits, quotas, and caching behavior.
- [Query health context](https://foreverbetter.mintlify.app/api-reference/query-health-context.md): Query normalized observations and derived interpretations.
- [Re-run a stored analysis on its existing sources](https://foreverbetter.mintlify.app/api-reference/re-run-a-stored-analysis-on-its-existing-sources.md): Re-run a stored analysis against its existing sources, producing a fresh analysis result and dashboard spec.
- [Read a health goal](https://foreverbetter.mintlify.app/api-reference/read-a-health-goal.md): Read a single health goal.
- [Read a source and its normalized observations](https://foreverbetter.mintlify.app/api-reference/read-a-source-and-its-normalized-observations.md): Read a single uploaded source with its normalized observations.
- [Read analysis](https://foreverbetter.mintlify.app/api-reference/read-analysis.md): Read a stored analysis result for the authenticated user.
- [Read dashboard spec](https://foreverbetter.mintlify.app/api-reference/read-dashboard-spec.md): Read a dashboard-ready JSON spec for an analysis.
- [Read prioritized recommendations for an analysis](https://foreverbetter.mintlify.app/api-reference/read-prioritized-recommendations-for-an-analysis.md): Read prioritized, de-duplicated action items derived from a stored analysis.
- [Read queued genetic analysis job status](https://foreverbetter.mintlify.app/api-reference/read-queued-genetic-analysis-job-status.md): Read queued WGS/SNP-array analysis job status.
- [Read queued wearable sync job status](https://foreverbetter.mintlify.app/api-reference/read-queued-wearable-sync-job-status.md): Read queued wearable sync job status.
- [Read unified health context](https://foreverbetter.mintlify.app/api-reference/read-unified-health-context.md): Read a bounded multimodal health context object for apps and agents.
- [Read webhook event log](https://foreverbetter.mintlify.app/api-reference/read-webhook-event-log.md): Read completion events for imports, analyses, wearable syncs, exports, and deletion receipts.
- [Readiness check](https://foreverbetter.mintlify.app/api-reference/readiness-check.md): Readiness probe. Returns 200 only when durable storage, auth (JWKS), Supabase OTP config, and database migrations are all healthy. Used by load balancers and orchestrators.
- [Refresh a provider access token](https://foreverbetter.mintlify.app/api-reference/refresh-a-provider-access-token.md): Exchange a provider refresh token for a fresh access token (WHOOP) so long-running syncs do not expire.
- [Run ancestry analysis setup/projection](https://foreverbetter.mintlify.app/api-reference/run-ancestry-analysis-setupprojection.md): Prepare ancestry analysis for an uploaded genetic source and return reference-panel setup requirements or ancestry proportions when the ancestry worker is configured.
- [Run multimodal health analysis](https://foreverbetter.mintlify.app/api-reference/run-multimodal-health-analysis.md): Run a health analysis from uploaded source IDs.
- [Run synthetic multimodal demo](https://foreverbetter.mintlify.app/api-reference/run-synthetic-multimodal-demo.md): Re-run the deterministic, non-persistent synthetic demo using a sandbox session token.
- [Start email OTP](https://foreverbetter.mintlify.app/api-reference/start-email-otp.md): Send a passwordless email sign-in link and one-time code (via Supabase Auth) so a person can authorize an agent without a password.
- [Start generic wearables connection](https://foreverbetter.mintlify.app/api-reference/start-generic-wearables-connection.md): Start a generic wearables connection flow for a supported source provider.
- [Start genetics analysis](https://foreverbetter.mintlify.app/api-reference/start-genetics-analysis.md): Start a genetics-only analysis for uploaded VCF, WGS, or SNP-array sources.
- [Start synthetic sandbox session](https://foreverbetter.mintlify.app/api-reference/start-synthetic-sandbox-session.md): Create a short-lived, synthetic-only sandbox session and return a complete multimodal demo result without persisting data.
- [Sync wearable data](https://foreverbetter.mintlify.app/api-reference/sync-wearable-data.md): Sync connected wearable observations through the configured wearable integration backend.
- [Tombstone user data](https://foreverbetter.mintlify.app/api-reference/tombstone-user-data.md): Tombstone tenant-scoped user data for deletion/export workflows.
- [Update a health goal](https://foreverbetter.mintlify.app/api-reference/update-a-health-goal.md): Update a health goal (target, due date, status, or note).
- [Upload health data](https://foreverbetter.mintlify.app/api-reference/upload-health-data.md): Upload biomarker, wearable, genetic, or behavioral source data.
- [Verify email OTP](https://foreverbetter.mintlify.app/api-reference/verify-email-otp.md): Verify an emailed one-time code and return an access token scoped to that user.
- [Version metadata](https://foreverbetter.mintlify.app/api-reference/version-metadata.md): Service version and build metadata.
- [Auth and claims](https://foreverbetter.mintlify.app/auth-and-claims.md): Required OIDC token shape for customer data access.
- [Behavioral & lifestyle](https://foreverbetter.mintlify.app/behavioral.md): Upload supplements, medications, nutrition, and symptoms as structured, scored, cross-referenced data.
- [Biomarkers](https://foreverbetter.mintlify.app/biomarkers.md): Upload labs in any common unit, get sex- and age-aware interpretations, derived metrics, and dashboard cards.
- [Connect your agent](https://foreverbetter.mintlify.app/connect-your-agent.md): Let an AI agent sign you in, create its own scoped key, and connect your wearables. No code required.
- [Data model](https://foreverbetter.mintlify.app/data-model.md): The five primitives every request flows through: sources, observations, interpretations, analyses, and dashboard specs.
- [Design systems](https://foreverbetter.mintlify.app/design-systems.md): Curated design-token sets for health & wellness UIs, so you can style your product in minutes.
- [Genetics](https://foreverbetter.mintlify.app/genetics.md): Upload VCF/WGS or SNP-array data, queue interpretation, and read genetic pipeline results.
- [ForeverBetter API](https://foreverbetter.mintlify.app/index.md): One API for building wellness products on wearables, genetics, biomarkers, and agent-ready health context.
- [Ingest data](https://foreverbetter.mintlify.app/ingest-data.md): Upload biomarker, wearable, genetic, or behavioral source files.
- [Quickstart](https://foreverbetter.mintlify.app/quickstart.md): Try a complete synthetic result, then create a free key and build with your own data.
- [Choose an analysis](https://foreverbetter.mintlify.app/run-analysis.md): Run a focused modality analysis, or combine modalities when the product question requires it.
- [Personal action protocol](https://foreverbetter.mintlify.app/use-cases/action-protocol.md): Turn a lab panel and a supplement/medication list into a cited, personalized plan.
- [Build an AI health agent](https://foreverbetter.mintlify.app/use-cases/ai-health-agent.md): Give an agent one health context to reason over, then ask it questions and act over REST or MCP.
- [Analyze your ancestry](https://foreverbetter.mintlify.app/use-cases/ancestry.md): From a raw genome file to ancestry proportions, haplogroups, and a per-chromosome breakdown.
- [Connect a WHOOP](https://foreverbetter.mintlify.app/use-cases/connect-whoop.md): How a signed-up user links their WHOOP in a few clicks, with no developer credentials required.
- [Build a custom health dashboard](https://foreverbetter.mintlify.app/use-cases/custom-dashboard.md): Go from raw multimodal data to a styled, render-ready dashboard in five calls.
- [Get users their first data](https://foreverbetter.mintlify.app/use-cases/find-providers.md): Turn an empty dashboard into a next step: genome kits to order, blood draws to book nearby, and wearables to connect.
- [The get-better-every-year loop](https://foreverbetter.mintlify.app/use-cases/retest-loop.md): Set goals, track trends across retests, and drive the annual re-test that keeps users engaged.
- [Wearable onboarding for your users (B2B)](https://foreverbetter.mintlify.app/wearable-onboarding.md): How a platform connects its end-users' wearables in a streamlined, org-scoped way.
- [Wearables](https://foreverbetter.mintlify.app/wearables.md): Connect WHOOP over OAuth, sync Android sources through ForeverBetter Connect and Google Health Connect, and analyze wearable signals.

## OpenAPI Specs

- [openapi](https://foreverbetter.mintlify.app/openapi.json)