DOCS · EARLY
Endpoint reference
The full documentation site (field dictionary, vocabulary reference, rendered OpenAPI) is in progress. Until then: every endpoint below is live, and /openapi.json carries the complete request/response schemas with examples.
| Endpoint | Purpose |
|---|---|
| GET /v1/exercises | List & filter — muscle, pattern, equipment, available_equipment (subset match), tier, modality, sfr_class, booleans, q search, sort, limit/offset. |
| GET /v1/exercises/{id} | One exercise by stable slug, e.g. barbell_bench_press. |
| GET /v1/meta | Controlled vocabularies with counts + current dataset_version. |
| GET /health | Liveness + dataset size. |
| GET /openapi.json | OpenAPI 3.1 spec — the canonical machine contract. |
First request — your first 100 calls each day are free, no key needed to start:
curl "https://exercise-api.com/v1/exercises?muscle=chest&sfr_class=high"The catalog currently holds 183 exercises (dataset v1.1.0). The /v1 contract is additive-only: fields and enum values are added, never removed or retyped.