Skip to main content
The API Reference is generated from the FITsociety Public API OpenAPI contract. Use it for exact method, path, parameter, request body, response, and authentication details.

Structure

Endpoints are grouped by integration domain. Start with Health, OAuth and Platform to verify your connection and discover the available capabilities.

Production base URL

All Public API endpoints are company-scoped through the Bearer token. Requests must not send companyId.

Collection pagination

Collection reads default to 10 records and clamp a requested limit above 100 to 100. Own company and client records have no artificial page-count ceiling. Follow hasNextPage, hasMore, or nextCursor according to each endpoint’s existing page, offset, or cursor contract. A single response is not a full export. Tags and custom field definitions are always paginated. The custom field values on a single client remain a complete resource. Nested configuration arrays, capability enumerations, transaction results, and file exports are not collection pages. The n8n webhook list keeps its root data array and exposes continuation under meta.pagination. Shared workout catalogue reads under /public/v1 stop at ten pages. This boundary applies to mixed public library searches; authenticated owned-only public scopes remain traversable. It does not change /api, /app/v1, or MCP catalogue pagination. Nutrition is not mounted under /public/v1 and is unaffected. Page limits are per-query browse bounds, not a global download quota. Integration authors must follow continuation metadata, including when a request for 500 is successfully clamped to 100. See the pagination migration notes.