freddy Personal API
Read-only access to your own health data. Authenticate with a personal API key (Authorization: Bearer fk_live_...). Your plan's history window applies.
Authentication
Send your personal API key as a bearer token: Authorization: Bearer fk_live_.... Generate keys from your dashboard under AI apps → API keys. Keys are read-only and bounded by your plan's history window.
Base URL
https://freddy.coach
Endpoints
GET /api/v1/metrics
List your normalized health metrics
Returns your metrics newest-first, bounded by your plan's history window. Paginate with the opaque cursor from next_cursor.
Query parameters
metric— Filter to one or more metric names. Repeat the param (?metric=a&metric=b) or comma-separate (?metric=a,b).provider— Filter to one or more providers (e.g. OURA, GARMIN), case-insensitive. Repeat the param (?provider=oura&provider=polar) or comma-separate (?provider=oura,polar).from— Start date (clamped to your plan window if earlier).to— End date (inclusive).cursor— Opaque pagination cursor from next_cursor.limit— Page size (max 1000).
GET /api/v1/catalog
Distinct metrics + providers available to you (within your window)
GET /api/v1/sources
Your connected sources
GET /api/v1/profile
Your profile + plan window
Machine-readable spec
OpenAPI 3.1: /api/openapi.json — import into Postman, Insomnia, or your own tooling.