Coach Watts Scores API

The Scores API from Coach Watts — 9 operation(s) for scores.

GitHub OpenAPI

Operations 9

GET /api/scores/athlete-profile Get athlete profile scores #
GET /api/scores/efficiency-trends Get efficiency trends #
GET /api/scores/explanation Get score explanation #
POST /api/scores/generate-explanations Generate score explanations #
POST /api/scores/nutrition-trends-explanation Generate nutrition trend explanation #
GET /api/scores/nutrition-trends Get nutrition trends #
GET /api/scores/readiness-correlation Get readiness correlation #
POST /api/scores/workout-trends-explanation Generate workout trend explanation #
GET /api/scores/workout-trends Get workout trends #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/coachwatts-com:coachwatts-com-scores-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

coachwatts-com-scores-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Coachwatts Com Scores API
  version: 0.5.25
  description: 'Operations tagged Scores across 2 of this provider''s published API definitions: coachwatts-com-openapi.json, coachwatts-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://coachwatts.com
  description: Local Development Server
  variables: {}
tags:
- name: Scores
paths:
  /api/scores/athlete-profile:
    get:
      tags:
      - Scores
      parameters: []
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  user:
                    type: object
                    properties:
                      id:
                        type: string
                      name:
                        type: string
                        nullable: true
                      ftp:
                        type: integer
                        nullable: true
                      weight:
                        type: number
                        nullable: true
                      maxHr:
                        type: integer
                        nullable: true
                      wkg:
                        type: string
                        nullable: true
                  scores:
                    type: object
                    properties:
                      currentFitness:
                        type: integer
                        nullable: true
                      recoveryCapacity:
                        type: integer
                        nullable: true
                      nutritionCompliance:
                        type: integer
                        nullable: true
                      trainingConsistency:
                        type: integer
                        nullable: true
                      lastUpdated:
                        type: string
                        format: date-time
                        nullable: true
        '401':
          description: Unauthorized
        '404':
          description: User not found
      summary: Get athlete profile scores
      description: Returns the current athlete profile scores and explanations.
      operationId: getApiScoresAthleteProfile
      x-operation-id-source: derived
    servers:
    - url: https://coachwatts.com
      description: Local Development Server
      variables: {}
  /api/scores/efficiency-trends:
    get:
      tags:
      - Scores
      parameters: []
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  trends:
                    type: array
                    items:
                      type: object
                      properties:
                        date:
                          type: string
                        timestamp:
                          type: string
                          format: date-time
                        workoutId:
                          type: string
                          nullable: true
                        efficiencyFactor:
                          type: number
                        decoupling:
                          type: number
                          nullable: true
                        normalizedPower:
                          type: number
                          nullable: true
                        averageHr:
                          type: number
                          nullable: true
        '401':
          description: Unauthorized
      summary: Get efficiency trends
      description: Returns efficiency factor (Power/HR) and decoupling trends.
      inputSchema:
      - name: days
        in: query
        schema:
          type:
          - integer
          - string
          default: 90
      - name: sport
        in: query
        schema:
          type: string
      - name: tags
        in: query
        schema:
          type: string
      operationId: getApiScoresEfficiencyTrends
      x-operation-id-source: derived
    servers:
    - url: https://coachwatts.com
      description: Local Development Server
      variables: {}
  /api/scores/explanation:
    get:
      tags:
      - Scores
      parameters: []
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  analysis:
                    type: object
                    nullable: true
                  score:
                    type: number
                    nullable: true
                  period:
                    type: integer
                    nullable: true
                  cached:
                    type: boolean
                  generatedAt:
                    type: string
                    format: date-time
                    nullable: true
                  expiresAt:
                    type: string
                    format: date-time
                    nullable: true
                  message:
                    type: string
                    nullable: true
                  generating:
                    type: boolean
                    nullable: true
        '400':
          description: Missing required parameters
        '401':
          description: Unauthorized
      summary: Get score explanation
      description: Returns an AI-generated explanation for a specific score trend.
      inputSchema:
      - name: type
        in: query
        required: true
        schema:
          type: string
          enum:
          - nutrition
          - workout
      - name: period
        in: query
        required: true
        schema:
          type: integer
      - name: metric
        in: query
        required: true
        schema:
          type: string
      operationId: getApiScoresExplanation
      x-operation-id-source: derived
    servers:
    - url: https://coachwatts.com
      description: Local Development Server
      variables: {}
  /api/scores/generate-explanations:
    post:
      tags:
      - Scores
      parameters: []
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                  jobId:
                    type: string
        '401':
          description: Unauthorized
      summary: Generate score explanations
      description: Triggers a background job to generate explanations for all score trends.
      operationId: postApiScoresGenerateExplanations
      x-operation-id-source: derived
    servers:
    - url: https://coachwatts.com
      description: Local Development Server
      variables: {}
  /api/scores/nutrition-trends-explanation:
    post:
      tags:
      - Scores
      parameters: []
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  analysis:
                    type: object
                  score:
                    type: number
                  period:
                    type: integer
        '401':
          description: Unauthorized
      summary: Generate nutrition trend explanation
      description: Generates an AI explanation for nutrition trends.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - summary
              properties:
                days:
                  type: integer
                  default: 14
                summary:
                  type: object
                  required:
                  - total
                  properties:
                    total:
                      type: integer
                    avgOverall:
                      type: number
                    avgMacroBalance:
                      type: number
                    avgQuality:
                      type: number
                    avgAdherence:
                      type: number
                    avgHydration:
                      type: number
      operationId: postApiScoresNutritionTrendsExplanation
      x-operation-id-source: derived
    servers:
    - url: https://coachwatts.com
      description: Local Development Server
      variables: {}
  /api/scores/nutrition-trends:
    get:
      tags:
      - Scores
      parameters: []
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  nutrition:
                    type: array
                    items:
                      type: object
                  summary:
                    type: object
                    properties:
                      total:
                        type: integer
                      avgOverall:
                        type: number
                      avgMacroBalance:
                        type: number
                      avgQuality:
                        type: number
                      avgAdherence:
                        type: number
                      avgHydration:
                        type: number
        '401':
          description: Unauthorized
      summary: Get nutrition trends
      description: Returns nutrition scores and averages for a specified period.
      inputSchema:
      - name: days
        in: query
        schema:
          type: integer
          default: 14
      - name: sport
        in: query
        schema:
          type: string
      operationId: getApiScoresNutritionTrends
      x-operation-id-source: derived
    servers:
    - url: https://coachwatts.com
      description: Local Development Server
      variables: {}
  /api/scores/readiness-correlation:
    get:
      tags:
      - Scores
      parameters: []
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  points:
                    type: array
                    items:
                      type: object
                      properties:
                        x:
                          type: number
                          description: Recovery Score
                        y:
                          type: number
                          description: Performance (TSS)
                        date:
                          type: string
                          format: date-time
                        type:
                          type: string
                        title:
                          type: string
        '401':
          description: Unauthorized
      summary: Get readiness correlation
      description: Returns data points correlating recovery scores with workout performance (TSS).
      inputSchema:
      - name: days
        in: query
        schema:
          type:
          - integer
          - string
          default: 30
      - name: tags
        in: query
        schema:
          type: string
      operationId: getApiScoresReadinessCorrelation
      x-operation-id-source: derived
    servers:
    - url: https://coachwatts.com
      description: Local Development Server
      variables: {}
  /api/scores/workout-trends-explanation:
    post:
      tags:
      - Scores
      parameters: []
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  analysis:
                    type: object
                  score:
                    type: number
                  period:
                    type: integer
        '401':
          description: Unauthorized
      summary: Generate workout trend explanation
      description: Generates an AI explanation for workout trends.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - summary
              properties:
                days:
                  type: integer
                  default: 30
                summary:
                  type: object
                  required:
                  - total
                  properties:
                    total:
                      type: integer
                    avgOverall:
                      type: number
                    avgTechnical:
                      type: number
                    avgEffort:
                      type: number
                    avgPacing:
                      type: number
                    avgExecution:
                      type: number
      operationId: postApiScoresWorkoutTrendsExplanation
      x-operation-id-source: derived
    servers:
    - url: https://coachwatts.com
      description: Local Development Server
      variables: {}
  /api/scores/workout-trends:
    get:
      tags:
      - Scores
      parameters: []
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  workouts:
                    type: array
                    items:
                      type: object
                      properties:
                        date:
                          type: string
                          format: date-time
                        overallScore:
                          type: integer
                        technicalScore:
                          type: integer
                        effortScore:
                          type: integer
                        pacingScore:
                          type: integer
                        executionScore:
                          type: integer
                        isGhost:
                          type: boolean
                  summary:
                    type: object
                    properties:
                      total:
                        type: integer
                      avgOverall:
                        type: number
                      avgTechnical:
                        type: number
                      avgEffort:
                        type: number
                      avgPacing:
                        type: number
                      avgExecution:
                        type: number
        '401':
          description: Unauthorized
      summary: Get workout trends
      description: Returns daily workout scores and trends for a specified period.
      inputSchema:
      - name: days
        in: query
        schema:
          type: integer
          default: 30
      - name: sport
        in: query
        schema:
          type: string
      - name: tags
        in: query
        schema:
          type: string
      operationId: getApiScoresWorkoutTrends
      x-operation-id-source: derived
    servers:
    - url: https://coachwatts.com
      description: Local Development Server
      variables: {}
x-refined-from:
- coachwatts-com-openapi.json
- coachwatts-com-openapi.yml