Personal API · beta

Your health data,
as an API.

Every metric freddy syncs, sleep, workouts, glucose, recovery and more, behind one read-only REST API. Your data, your key, your tools.

Create your API key API reference

Included in Proread-onlyJSON

What people build

Your numbers, your tools.

A dashboard that is actually yours

Grafana, Streamlit, or a weekend React app over your own numbers.

Spreadsheets that update themselves

A scheduled script pulls your latest metrics into Google Sheets.

Feed your own models

Notebooks and scripts that read your history without CSV exports.

Quickstart

Three steps.

One key, one header, plain JSON back.

1
Create a key in the dashboard under AI apps → API keys. The secret is shown once.

curl -H "Authorization: Bearer fk_live_..." https://freddy.coach/api/v1/catalog

Discover the exact metric names your sources produce, then query them:

curl -H "Authorization: Bearer fk_live_..." "https://freddy.coach/api/v1/metrics?metric=sleep_score"

{
  "data": [
    { "date": "2026-07-21", "provider": "OURA", "metric": "sleep_score", "numValue": 82, "unit": "score" }
  ],
  "next_cursor": null,
  "meta": { "plan": "PRO", "history_window_days": null, "history_floor": null, "source_cap": null }
}

Endpoints

Four routes. Read-only.

Endpoint	Returns
GET /api/v1/metrics	Normalized health metrics with filters and cursor paging.
GET /api/v1/catalog	Distinct metrics, providers, and units available to you.
GET /api/v1/sources	Your connected sources.
GET /api/v1/profile	Profile and plan window.

120 requests per minute per key · up to 10 active keys · full OpenAPI spec at /api/openapi.json

Go deeper

Everything you need to ship.

Get started

Your health data,as an API.