Coaches

List coaches

GET /public/v1/coaches
Authorization: Bearer <access_token>

Required scope:

coaches:read

Query parameters:

Parameter	Type	Notes
`page`	integer	1-based page number
`limit`	integer	Defaults to 100, maximum 500
`search`	string	Searches first name, last name, and email
`role`	string	One of `Coach`, `Manager`, or `Admin`

Example:

curl -H "Authorization: Bearer <access_token>" \
  "https://api.fitsociety.io/public/v1/coaches?limit=50&search=doe"

Get a coach

GET /public/v1/coaches/{coachId}
Authorization: Bearer <access_token>

Required scope:

coaches:read

Coach output fields

List response fields:

Field	Type	Nullable	Description
`data.page`	integer	no	Current page.
`data.limit`	integer	no	Page size after cap, maximum `500`.
`data.total`	integer	no	Total matching coaches.
`data.totalPages`	integer	no	Total pages.
`data.hasNextPage`	boolean	no	Next page availability.
`data.hasPrevPage`	boolean	no	Previous page availability.
`data.data[]._id`	string	no	Coach ID.
`data.data[].firstName`	string	no	First name.
`data.data[].lastName`	string	no	Last name.
`data.data[].email`	string	no	Coach email.
`data.data[].role`	string	no	`Coach`, `Manager`, or `Admin`.
`data.data[].language`	string	no	Coach language.
`data.data[].trainerStatus`	boolean	no	Trainer active flag.
`data.data[].image`	string/object	yes	Stored profile image metadata as returned by the coach model.
`data.data[].lastActive`	string	yes	Last active timestamp.
`data.data[].online`	boolean	yes	Online flag.

Detail response fields:

Field	Type	Nullable	Description
`data.coach._id`	string	no	Coach ID.
`data.coach.firstName`	string	no	First name.
`data.coach.lastName`	string	no	Last name.
`data.coach.email`	string	no	Coach email.
`data.coach.role`	string	no	`Coach`, `Manager`, or `Admin`.
`data.coach.language`	string	no	Coach language.
`data.coach.trainerStatus`	boolean	no	Trainer active flag.
`data.coach.image`	string/object	yes	Stored profile image metadata as returned by the coach model.
`data.coach.lastActive`	string	yes	Last active timestamp.
`data.coach.online`	boolean	yes	Online flag.

Coach responses are company-scoped and do not return password/auth state, device tokens, refresh tokens, private permissions internals, phone numbers, address fields, payout data, or notification preferences.

Start here

Public API guides

Access Devices

List coaches

Get a coach

Coach output fields

​List coaches

​Get a coach

​Coach output fields

List coaches

Get a coach

Coach output fields