Skip to main content
POST
cURL

Authorizations

​
Authorization
string
header
required

Public API access token issued by /public/v1/oauth/token. Example: Authorization: Bearer fspt_.... Each resource request rechecks the token company's current provider access. Disabling access blocks existing tokens with 403 auth.provider_unavailable.

Headers

​
Idempotency-Key
string
required

Required for Public API write requests. Reusing the same key with the same method, path, and body replays the stored successful response; reusing it with a different request returns 409 idempotency.conflict.

Required string length: 1 - 200
Example:

"booking-create-20260714-001"

Path Parameters

​
clientId
string
required

Client in the company bound to the Public API token.

Pattern: ^[a-fA-F0-9]{24}$

Body

application/json
​
tab
enum<string>
default:feed
Available options:
feed,
exercises,
statistics
​
clientId
string

Required when the caller is a coach/admin; a client token resolves its own id.

Example:

"67f1234567890abcdef1234"

​
page
integer
default:1
Required range: 1 <= x <= 100
​
limit
integer
default:10

FEED tab only: DATE GROUPS per page. Clamped to [10, 100] by the shared paginator, so a smaller value is raised to 10.

Required range: 10 <= x <= 100
​
exercisePage
integer
default:1

EXERCISES tab only: page over exercises, independent of page.

Required range: 1 <= x <= 100
​
exerciseLimit
integer
default:10

EXERCISES tab only: exercises per page. Clamped to [10, 100] by the shared paginator, so a smaller value is raised to 10.

Required range: 10 <= x <= 100
​
search
string

Case-insensitive substring. On feed it filters the PLAN name (a date survives when at least one of its plans matches); on exercises it filters the EXERCISE name. Applied BEFORE pagination, so pagination.totalItems counts the matches. Also accepted as ?search=.

Example:

"strength"

​
statsRange
enum<string>
default:last7days

Range for the CHART only — the stat cards are always all-time and ignore this. activity uses the last 7 days and returns chart points only for dates with completed training.

Available options:
last7days,
last1month,
last6months,
activity
​
muscleBalanceRange
enum<string>
default:last7days
Available options:
last7days,
last30days,
last90days,
allTime

Response

Workout history fetched successfully.

​
data
object
required
​
meta
object
required