Agent-first API documentation

BAD Developer Platform

BAD is the intelligence layer above all your health data — one unified, cross-source health graph (activities, recovery, labs, nutrition, body comp), today from Apple Health + Strava and designed to absorb every other source. The REST API and MCP server give your agent programmatic read/write access to that graph. Open by design — your data, your tools.

For the fuller agent-oriented guide (badstack one-curl install, per-agent MCP setup, drop-in prompt), see the developer docs.

Quick Start

Create a key

Open Settings → Developer and create an API key.

Verify auth

Call GET /v1/users/me to confirm the key works.

Read today's plan

Fetch today's training items with GET /v1/plans/today.

Log an activity

Record a manual workout with POST /v1/activities.

Explore by Topic

First Request

bash

export BAD_API_KEY="bad_live_..."
curl "https://bad.app/api/v1/users/me" \
  -H "Authorization: Bearer $BAD_API_KEY"

📡 Base URLs

RESThttps://bad.app/api/v1

MCPhttps://bad.app/api/mcp