> For the complete documentation index, see [llms.txt](https://docs.tryterra.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tryterra.co/reference/teams-api/coaches.md).

# Coaches

Create and delete coaches, and read the athletes, activities and tests under each coach.

## List all coaches

> Lists every coach registered under your developer ID.

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"tags":[{"name":"Coaches","summary":"Coaches","description":"Create and delete coaches, and read the athletes, activities and tests under each coach."}],"servers":[{"url":"https://api.tryterra.co/v2/teams","description":"Main teams API base URL"}],"security":[{"ApiKeyAuth":[],"DevID":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your API key for authentication"},"DevID":{"type":"apiKey","in":"header","name":"dev-id","description":"Your developer ID for authentication and tracking"}},"schemas":{"CoachesReturned":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Coach"}}}},"Coach":{"type":"object","allOf":[{"$ref":"#/components/schemas/CoachRecord"}],"properties":{"coach_id":{"type":"string","readOnly":true},"external_coach_id":{"type":"string","readOnly":true},"client_id":{"type":"string","description":"Public identifier for the coach.","writeOnly":true},"client_secret":{"type":"string","description":"Secret key or token for authentication.","writeOnly":true},"token":{"type":"string","description":"API key or token for the coach object","writeOnly":true}}},"CoachRecord":{"type":"object","description":"A registered coach as Terra sends it in a webhook.","properties":{"coach_id":{"type":"string","description":"Unique identifier for the coach, generated by the server."},"external_coach_id":{"type":"string","description":"Identifier of the coach on the provider's systems"},"reference_id":{"type":"string","description":"ID of the coach on your system"},"region":{"type":"string","description":"Region in which the coach operates."},"provider":{"type":"string","description":"Integration provider associated with the coach (e.g., VALD, Catapult)."},"created_at":{"type":"string","format":"date-time","description":"The date and time when the coach was registered."}}},"UnauthorizedProblem":{"type":"object","description":"A refused credential, always with its code.","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance","code"]},"Problem":{"type":"object","description":"An error response, following RFC 9457 (Problem Details for HTTP APIs, which obsoletes RFC 7807). Returned with `Content-Type: application/problem+json` on every 4xx/5xx response. The HTTP status line carries the status code; it is intentionally not repeated in the body. `type`, `title` and `instance` are always present; `detail` is included when a specific explanation is available.\n","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance"]}},"responses":{"Unauthorized":{"description":"The credential is missing, invalid, expired or revoked (code `unauthorized`).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnauthorizedProblem"}}}},"AuthorizationUnavailable":{"description":"The credential or the product access could not be checked (code `authorization_unavailable`). Retry after the service recovers.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"paths":{"/coaches":{"get":{"operationId":"listCoaches","description":"Lists every coach registered under your developer ID.","summary":"List all coaches","responses":{"200":{"description":"A list of coaches","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoachesReturned"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"503":{"$ref":"#/components/responses/AuthorizationUnavailable"}},"tags":["Coaches"]}}}}
```

## Create a new coach

> Registers a coach from their provider, region and provider credentials, and returns the new coach.\
> \
> \- Terra also imports the coach's athletes from the provider, so they appear in \`GET /coaches/{coachId}/athletes\` and \`GET /athletes\`.\
> \- Only VALD coaches can be created today; any other \`provider\` returns \`404\`.\
> \- Creating the same VALD coach again makes a second coach, with its own copy of the athletes, rather than returning \`409\`.

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"tags":[{"name":"Coaches","summary":"Coaches","description":"Create and delete coaches, and read the athletes, activities and tests under each coach."}],"servers":[{"url":"https://api.tryterra.co/v2/teams","description":"Main teams API base URL"}],"security":[{"ApiKeyAuth":[],"DevID":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your API key for authentication"},"DevID":{"type":"apiKey","in":"header","name":"dev-id","description":"Your developer ID for authentication and tracking"}},"schemas":{"Coach":{"type":"object","allOf":[{"$ref":"#/components/schemas/CoachRecord"}],"properties":{"coach_id":{"type":"string","readOnly":true},"external_coach_id":{"type":"string","readOnly":true},"client_id":{"type":"string","description":"Public identifier for the coach.","writeOnly":true},"client_secret":{"type":"string","description":"Secret key or token for authentication.","writeOnly":true},"token":{"type":"string","description":"API key or token for the coach object","writeOnly":true}}},"CoachRecord":{"type":"object","description":"A registered coach as Terra sends it in a webhook.","properties":{"coach_id":{"type":"string","description":"Unique identifier for the coach, generated by the server."},"external_coach_id":{"type":"string","description":"Identifier of the coach on the provider's systems"},"reference_id":{"type":"string","description":"ID of the coach on your system"},"region":{"type":"string","description":"Region in which the coach operates."},"provider":{"type":"string","description":"Integration provider associated with the coach (e.g., VALD, Catapult)."},"created_at":{"type":"string","format":"date-time","description":"The date and time when the coach was registered."}}},"UnauthorizedProblem":{"type":"object","description":"A refused credential, always with its code.","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance","code"]},"ErrorMessage":{"type":"object","description":"The error body teams operations return.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"Problem":{"type":"object","description":"An error response, following RFC 9457 (Problem Details for HTTP APIs, which obsoletes RFC 7807). Returned with `Content-Type: application/problem+json` on every 4xx/5xx response. The HTTP status line carries the status code; it is intentionally not repeated in the body. `type`, `title` and `instance` are always present; `detail` is included when a specific explanation is available.\n","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance"]}},"responses":{"Unauthorized":{"description":"The credential is missing, invalid, expired or revoked (code `unauthorized`).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnauthorizedProblem"}}}},"AuthorizationUnavailable":{"description":"The credential or the product access could not be checked (code `authorization_unavailable`). Retry after the service recovers.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"paths":{"/coaches":{"post":{"operationId":"createCoach","summary":"Create a new coach","description":"Registers a coach from their provider, region and provider credentials, and returns the new coach.\n\n- Terra also imports the coach's athletes from the provider, so they appear in `GET /coaches/{coachId}/athletes` and `GET /athletes`.\n- Only VALD coaches can be created today; any other `provider` returns `404`.\n- Creating the same VALD coach again makes a second coach, with its own copy of the athletes, rather than returning `409`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Coach"}}}},"responses":{"201":{"description":"Coach created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Coach"}}}},"400":{"description":"Invalid input, object invalid"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"The provider cannot be onboarded yet. The `error` is `Provider not available on version 2022-03-16`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"409":{"description":"You already registered a coach with the same credentials and `token`. The body is that coach. A body without `token` never conflicts.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Coach"}}}},"503":{"$ref":"#/components/responses/AuthorizationUnavailable"}},"tags":["Coaches"]}}}}
```

## Retrieve a coach

> Returns one of your coaches.

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"tags":[{"name":"Coaches","summary":"Coaches","description":"Create and delete coaches, and read the athletes, activities and tests under each coach."}],"servers":[{"url":"https://api.tryterra.co/v2/teams","description":"Main teams API base URL"}],"security":[{"ApiKeyAuth":[],"DevID":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your API key for authentication"},"DevID":{"type":"apiKey","in":"header","name":"dev-id","description":"Your developer ID for authentication and tracking"}},"schemas":{"Coach":{"type":"object","allOf":[{"$ref":"#/components/schemas/CoachRecord"}],"properties":{"coach_id":{"type":"string","readOnly":true},"external_coach_id":{"type":"string","readOnly":true},"client_id":{"type":"string","description":"Public identifier for the coach.","writeOnly":true},"client_secret":{"type":"string","description":"Secret key or token for authentication.","writeOnly":true},"token":{"type":"string","description":"API key or token for the coach object","writeOnly":true}}},"CoachRecord":{"type":"object","description":"A registered coach as Terra sends it in a webhook.","properties":{"coach_id":{"type":"string","description":"Unique identifier for the coach, generated by the server."},"external_coach_id":{"type":"string","description":"Identifier of the coach on the provider's systems"},"reference_id":{"type":"string","description":"ID of the coach on your system"},"region":{"type":"string","description":"Region in which the coach operates."},"provider":{"type":"string","description":"Integration provider associated with the coach (e.g., VALD, Catapult)."},"created_at":{"type":"string","format":"date-time","description":"The date and time when the coach was registered."}}},"UnauthorizedProblem":{"type":"object","description":"A refused credential, always with its code.","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance","code"]},"ErrorMessage":{"type":"object","description":"The error body teams operations return.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"Problem":{"type":"object","description":"An error response, following RFC 9457 (Problem Details for HTTP APIs, which obsoletes RFC 7807). Returned with `Content-Type: application/problem+json` on every 4xx/5xx response. The HTTP status line carries the status code; it is intentionally not repeated in the body. `type`, `title` and `instance` are always present; `detail` is included when a specific explanation is available.\n","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance"]}},"responses":{"Unauthorized":{"description":"The credential is missing, invalid, expired or revoked (code `unauthorized`).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnauthorizedProblem"}}}},"AuthorizationUnavailable":{"description":"The credential or the product access could not be checked (code `authorization_unavailable`). Retry after the service recovers.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"paths":{"/coaches/{coachId}":{"get":{"operationId":"getCoach","summary":"Retrieve a coach","description":"Returns one of your coaches.","parameters":[{"name":"coachId","in":"path","required":true,"schema":{"type":"string"},"description":"The coach's `coach_id`."}],"responses":{"200":{"description":"The coach.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Coach"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"Coach not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"503":{"$ref":"#/components/responses/AuthorizationUnavailable"}},"tags":["Coaches"]}}}}
```

## Delete a coach

> Deletes a coach, the provider token Terra holds for them, and their athletes.\
> \
> \- Terra reads activities and tests from the provider rather than storing them, so they can no longer be fetched through Terra.

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"tags":[{"name":"Coaches","summary":"Coaches","description":"Create and delete coaches, and read the athletes, activities and tests under each coach."}],"servers":[{"url":"https://api.tryterra.co/v2/teams","description":"Main teams API base URL"}],"security":[{"ApiKeyAuth":[],"DevID":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your API key for authentication"},"DevID":{"type":"apiKey","in":"header","name":"dev-id","description":"Your developer ID for authentication and tracking"}},"responses":{"Unauthorized":{"description":"The credential is missing, invalid, expired or revoked (code `unauthorized`).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnauthorizedProblem"}}}},"AuthorizationUnavailable":{"description":"The credential or the product access could not be checked (code `authorization_unavailable`). Retry after the service recovers.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"schemas":{"UnauthorizedProblem":{"type":"object","description":"A refused credential, always with its code.","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance","code"]},"ErrorMessage":{"type":"object","description":"The error body teams operations return.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"Problem":{"type":"object","description":"An error response, following RFC 9457 (Problem Details for HTTP APIs, which obsoletes RFC 7807). Returned with `Content-Type: application/problem+json` on every 4xx/5xx response. The HTTP status line carries the status code; it is intentionally not repeated in the body. `type`, `title` and `instance` are always present; `detail` is included when a specific explanation is available.\n","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance"]}}},"paths":{"/coaches/{coachId}":{"delete":{"summary":"Delete a coach","operationId":"deleteCoach","description":"Deletes a coach, the provider token Terra holds for them, and their athletes.\n\n- Terra reads activities and tests from the provider rather than storing them, so they can no longer be fetched through Terra.","parameters":[{"name":"coachId","in":"path","required":true,"schema":{"type":"string"},"description":"The `coach_id` of the coach to delete."}],"responses":{"204":{"description":"Coach deleted successfully."},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"Coach not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"503":{"$ref":"#/components/responses/AuthorizationUnavailable"}},"tags":["Coaches"]}}}}
```

## Retrieve all athletes under a specific coach

> Returns the athletes registered under a coach.\
> \
> \- A coach with no athletes returns one athlete whose fields are all \`null\` except \`coach\_id\`, with \`active\` set to \`false\`.\
> \- \`gender\` is always \`null\` here; read it with \`GET /athletes/{athleteId}\`.\
> \- A \`coach\_id\` you do not have returns \`500\`, not \`404\`.

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"tags":[{"name":"Coaches","summary":"Coaches","description":"Create and delete coaches, and read the athletes, activities and tests under each coach."}],"servers":[{"url":"https://api.tryterra.co/v2/teams","description":"Main teams API base URL"}],"security":[{"ApiKeyAuth":[],"DevID":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your API key for authentication"},"DevID":{"type":"apiKey","in":"header","name":"dev-id","description":"Your developer ID for authentication and tracking"}},"schemas":{"AthletesReturned":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Athlete"}}}},"Athlete":{"type":"object","allOf":[{"$ref":"#/components/schemas/AthleteRecord"}],"properties":{"coach_id":{"type":"string","readOnly":true},"athlete_id":{"type":"string","readOnly":true},"external_athlete_id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"last_updated_at":{"type":"string","format":"date-time","readOnly":true}}},"AthleteRecord":{"type":"object","description":"A registered athlete as Terra sends it in a webhook.","properties":{"coach_id":{"type":"string","description":"The ID of the coach to which the athlete belongs"},"athlete_id":{"type":"string","description":"Unique identifier for the athlete, generated by the server."},"external_athlete_id":{"type":"string","description":"Unique identifier for the athlete on the provider's system, generated by the provider (e.g. VALD, Catapult)"},"reference_id":{"type":"string","description":"A string to reference the Athlete. This can be a UUID, email, or other, and can be used to reconcile the Athlete with your internal systems."},"gender":{"type":["integer","null"],"description":"The athlete's gender, as an integer code. Always `null` in `GET /coaches/{coachId}/athletes`."},"first_name":{"type":"string","description":"Athlete's first name."},"last_name":{"type":"string","description":"Athlete's last name"},"email":{"type":"string","description":"Athlete's email"},"created_at":{"type":"string","format":"date-time","description":"The date and time when the athlete was registered."},"date_of_birth":{"type":"string","format":"date","description":"The date of birth of the athlete"},"last_updated_at":{"type":"string","format":"date-time","description":"The date and time when the athlete was last updated (e.g. updated their first and last name)."},"active":{"type":"boolean","description":"Determines whether or not Terra will send webhooks for the given athlete"}}},"UnauthorizedProblem":{"type":"object","description":"A refused credential, always with its code.","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance","code"]},"ErrorMessage":{"type":"object","description":"The error body teams operations return.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"Problem":{"type":"object","description":"An error response, following RFC 9457 (Problem Details for HTTP APIs, which obsoletes RFC 7807). Returned with `Content-Type: application/problem+json` on every 4xx/5xx response. The HTTP status line carries the status code; it is intentionally not repeated in the body. `type`, `title` and `instance` are always present; `detail` is included when a specific explanation is available.\n","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance"]}},"responses":{"Unauthorized":{"description":"The credential is missing, invalid, expired or revoked (code `unauthorized`).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnauthorizedProblem"}}}},"AuthorizationUnavailable":{"description":"The credential or the product access could not be checked (code `authorization_unavailable`). Retry after the service recovers.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"paths":{"/coaches/{coachId}/athletes":{"get":{"operationId":"getAthletesForCoach","description":"Returns the athletes registered under a coach.\n\n- A coach with no athletes returns one athlete whose fields are all `null` except `coach_id`, with `active` set to `false`.\n- `gender` is always `null` here; read it with `GET /athletes/{athleteId}`.\n- A `coach_id` you do not have returns `500`, not `404`.","summary":"Retrieve all athletes under a specific coach","parameters":[{"name":"coachId","in":"path","required":true,"schema":{"type":"string"},"description":"The coach's `coach_id`."}],"responses":{"200":{"description":"An array of athletes coached by the specified coach","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AthletesReturned"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"description":"Returned when the coach does not exist.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"503":{"$ref":"#/components/responses/AuthorizationUnavailable"}},"tags":["Coaches"]}}}}
```

## Retrieve all activities recorded by athletes under a specific coach

> Returns a coach and the activities their athletes recorded between \`start\_date\` and \`end\_date\`.\
> \
> \- Not available yet: a valid request currently returns \`500\`.

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"tags":[{"name":"Coaches","summary":"Coaches","description":"Create and delete coaches, and read the athletes, activities and tests under each coach."}],"servers":[{"url":"https://api.tryterra.co/v2/teams","description":"Main teams API base URL"}],"security":[{"ApiKeyAuth":[],"DevID":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your API key for authentication"},"DevID":{"type":"apiKey","in":"header","name":"dev-id","description":"Your developer ID for authentication and tracking"}},"schemas":{"CoachDataReturned":{"type":"object","properties":{"coach":{"$ref":"#/components/schemas/Coach"}}},"Coach":{"type":"object","allOf":[{"$ref":"#/components/schemas/CoachRecord"}],"properties":{"coach_id":{"type":"string","readOnly":true},"external_coach_id":{"type":"string","readOnly":true},"client_id":{"type":"string","description":"Public identifier for the coach.","writeOnly":true},"client_secret":{"type":"string","description":"Secret key or token for authentication.","writeOnly":true},"token":{"type":"string","description":"API key or token for the coach object","writeOnly":true}}},"CoachRecord":{"type":"object","description":"A registered coach as Terra sends it in a webhook.","properties":{"coach_id":{"type":"string","description":"Unique identifier for the coach, generated by the server."},"external_coach_id":{"type":"string","description":"Identifier of the coach on the provider's systems"},"reference_id":{"type":"string","description":"ID of the coach on your system"},"region":{"type":"string","description":"Region in which the coach operates."},"provider":{"type":"string","description":"Integration provider associated with the coach (e.g., VALD, Catapult)."},"created_at":{"type":"string","format":"date-time","description":"The date and time when the coach was registered."}}},"TeamActivity":{"type":"object","properties":{"activity_id":{"type":["string","null"],"description":"Unique identifier for the activity"},"start_timestamp_us":{"type":["integer","null"],"description":"Start timestamp of the activity in microseconds"},"end_timestamp_us":{"type":["integer","null"],"description":"End timestamp of the activity in microseconds"},"description":{"type":["string","null"],"description":"Description of the activity"},"teams":{"type":["array","null"],"items":{"$ref":"#/components/schemas/TeamInfo"},"description":"List of teams involved in the activity"},"athletes":{"type":["array","null"],"items":{"$ref":"#/components/schemas/Athlete"},"description":"List of athletes involved in the activity"},"athlete_participation":{"anyOf":[{"$ref":"#/components/schemas/ParticipationStatus"},{"type":"null"}],"description":"Overall participation status of athletes"},"tz_offset_seconds":{"type":["integer","null"],"description":"Timezone offset in seconds","default":0},"periods":{"type":["array","null"],"items":{"$ref":"#/components/schemas/Period"},"description":"List of periods in the activity","default":[]},"activity_metrics":{"type":["array","null"],"items":{"$ref":"#/components/schemas/Metric"},"description":"List of metrics associated with the activity","default":[]},"athlete_metrics":{"type":["object","null"],"additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/Metric"}},"description":"Dictionary mapping athlete IDs to their metrics","default":{}},"events":{"type":["array","null"],"items":{"type":"string"},"description":"List of events related to the activity"}}},"TeamInfo":{"type":"object","properties":{"name":{"type":["string","null"],"description":"Name of the team"},"is_home":{"$ref":"#/components/schemas/IsHomeFlag","description":"Indicates if the team is the home team"}}},"IsHomeFlag":{"type":"integer","description":"Indicates if the team is home or away","oneOf":[{"title":"UNKNOWN","const":-1,"description":"Unknown or not specified"},{"title":"AWAY","const":0,"description":"Away team"},{"title":"HOME","const":1,"description":"Home team"}]},"Athlete":{"type":"object","allOf":[{"$ref":"#/components/schemas/AthleteRecord"}],"properties":{"coach_id":{"type":"string","readOnly":true},"athlete_id":{"type":"string","readOnly":true},"external_athlete_id":{"type":"string","readOnly":true},"created_at":{"type":"string","format":"date-time","readOnly":true},"last_updated_at":{"type":"string","format":"date-time","readOnly":true}}},"AthleteRecord":{"type":"object","description":"A registered athlete as Terra sends it in a webhook.","properties":{"coach_id":{"type":"string","description":"The ID of the coach to which the athlete belongs"},"athlete_id":{"type":"string","description":"Unique identifier for the athlete, generated by the server."},"external_athlete_id":{"type":"string","description":"Unique identifier for the athlete on the provider's system, generated by the provider (e.g. VALD, Catapult)"},"reference_id":{"type":"string","description":"A string to reference the Athlete. This can be a UUID, email, or other, and can be used to reconcile the Athlete with your internal systems."},"gender":{"type":["integer","null"],"description":"The athlete's gender, as an integer code. Always `null` in `GET /coaches/{coachId}/athletes`."},"first_name":{"type":"string","description":"Athlete's first name."},"last_name":{"type":"string","description":"Athlete's last name"},"email":{"type":"string","description":"Athlete's email"},"created_at":{"type":"string","format":"date-time","description":"The date and time when the athlete was registered."},"date_of_birth":{"type":"string","format":"date","description":"The date of birth of the athlete"},"last_updated_at":{"type":"string","format":"date-time","description":"The date and time when the athlete was last updated (e.g. updated their first and last name)."},"active":{"type":"boolean","description":"Determines whether or not Terra will send webhooks for the given athlete"}}},"ParticipationStatus":{"type":"object","properties":{"full":{"type":"array","items":{"type":"string"},"description":"List of athletes with full participation","default":[]},"partial":{"type":"array","items":{"type":"string"},"description":"List of athletes with partial participation","default":[]},"unknown":{"type":"array","items":{"type":"string"},"description":"List of athletes with unknown participation","default":[]}}},"Period":{"type":"object","properties":{"period_id":{"type":["string","null"],"description":"ID of the period"},"name":{"type":["string","null"],"description":"Name of the period"},"athlete_participation":{"anyOf":[{"$ref":"#/components/schemas/ParticipationStatus"},{"type":"null"}],"description":"Participation status of athletes in the period"},"detailed_athlete_participation":{"type":"array","items":{"$ref":"#/components/schemas/DetailedParticipationStatus"},"description":"Detailed participation status of athletes","default":[]},"start_timestamp_us":{"type":["integer","null"],"description":"Start timestamp of the period in microseconds"},"end_timestamp_us":{"type":["integer","null"],"description":"End timestamp of the period in microseconds"},"athlete_metrics":{"type":"array","items":{"$ref":"#/components/schemas/AthleteMetrics"}}}},"DetailedParticipationStatus":{"type":"object","properties":{"athlete_id":{"type":["string","null"],"description":"ID of the athlete"},"external_athlete_id":{"type":["string","null"],"description":"External ID of the athlete"},"is_home_team":{"$ref":"#/components/schemas/IsHomeFlag","description":"Indicates if the athlete is from the home team"},"participation":{"$ref":"#/components/schemas/ParticipationType","description":"Type of participation in an activity"},"function":{"type":["string","null"],"description":"Function of the athlete in the activity"}}},"ParticipationType":{"type":"integer","description":"Type of participation in an activity","oneOf":[{"title":"UNKNOWN","const":0,"description":"Unknown participation type"},{"title":"FULL","const":1,"description":"Full participation"},{"title":"PARTIAL","const":2,"description":"Partial participation"}]},"AthleteMetrics":{"type":"object","properties":{"athlete_id":{"type":["string","null"],"description":"ID of the athlete"},"metrics":{"type":["array","null"],"items":{"$ref":"#/components/schemas/Metric"},"description":"List of metrics associated with the athlete"}}},"Metric":{"type":"object","properties":{"name":{"type":["string","null"],"description":"Name of the metric"},"value":{"oneOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"description":"Value of the metric"},"unit":{"type":["string","null"],"description":"Unit of the metric"}}},"DataSentToDestination":{"type":"object","description":"Returned when `to_destination=true`. Confirms that data retrieval has been queued and will be delivered to your webhook.","properties":{"coach":{"$ref":"#/components/schemas/Coach"},"reference":{"type":"string","format":"uuid","description":"Unique reference ID for this dispatch. Can be used to correlate the subsequent webhook delivery."},"message":{"type":"string","description":"Human-readable confirmation message."},"type":{"type":"string","description":"The type of data being dispatched.","enum":["test.dispatched","activity.dispatched","activity.metric.dispatched"]}}},"UnauthorizedProblem":{"type":"object","description":"A refused credential, always with its code.","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance","code"]},"ErrorMessage":{"type":"object","description":"The error body teams operations return.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"Problem":{"type":"object","description":"An error response, following RFC 9457 (Problem Details for HTTP APIs, which obsoletes RFC 7807). Returned with `Content-Type: application/problem+json` on every 4xx/5xx response. The HTTP status line carries the status code; it is intentionally not repeated in the body. `type`, `title` and `instance` are always present; `detail` is included when a specific explanation is available.\n","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance"]}},"responses":{"Unauthorized":{"description":"The credential is missing, invalid, expired or revoked (code `unauthorized`).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnauthorizedProblem"}}}},"AuthorizationUnavailable":{"description":"The credential or the product access could not be checked (code `authorization_unavailable`). Retry after the service recovers.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"paths":{"/coaches/{coachId}/activities":{"get":{"operationId":"getActivitiesForCoach","description":"Returns a coach and the activities their athletes recorded between `start_date` and `end_date`.\n\n- Not available yet: a valid request currently returns `500`.","summary":"Retrieve all activities recorded by athletes under a specific coach","parameters":[{"name":"coachId","in":"path","required":true,"schema":{"type":"string"},"description":"The coach's `coach_id`."},{"name":"start_date","in":"query","required":true,"description":"Start date for the query range (YYYY-MM-DD). Leaving it out returns `500`, not `400`.","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"End of the date range, as YYYY-MM-DD. Defaults to one day after `start_date`.","schema":{"type":"string","format":"date"}},{"name":"to_destination","in":"query","required":false,"description":"Not implemented yet. Whether to send the data to your webhook instead of returning it. When `true`, the response is `202` with a `reference` ID that identifies the later webhook delivery. Defaults to `false`, which returns the data in the response body.","schema":{"type":"string","enum":["true","false"],"default":"false"}}],"responses":{"200":{"description":"List of activities within the specified time range for all athletes under the coach","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/CoachDataReturned"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/TeamActivity"}}}}]}}}},"202":{"description":"Data dispatch accepted. Returned when `to_destination=true`. Data will be sent to your configured webhook.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSentToDestination"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"Coach not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"500":{"description":"Returned for every request that passes validation, because provider data is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"503":{"$ref":"#/components/responses/AuthorizationUnavailable"}},"tags":["Coaches"]}}}}
```

## Retrieve activity metrics schema for a coach

> Lists the metrics a coach's activities can carry, with the key, display name and unit of each.\
> \
> \- Not available yet: a valid request currently returns \`500\`.

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"tags":[{"name":"Coaches","summary":"Coaches","description":"Create and delete coaches, and read the athletes, activities and tests under each coach."}],"servers":[{"url":"https://api.tryterra.co/v2/teams","description":"Main teams API base URL"}],"security":[{"ApiKeyAuth":[],"DevID":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your API key for authentication"},"DevID":{"type":"apiKey","in":"header","name":"dev-id","description":"Your developer ID for authentication and tracking"}},"schemas":{"CoachDataReturned":{"type":"object","properties":{"coach":{"$ref":"#/components/schemas/Coach"}}},"Coach":{"type":"object","allOf":[{"$ref":"#/components/schemas/CoachRecord"}],"properties":{"coach_id":{"type":"string","readOnly":true},"external_coach_id":{"type":"string","readOnly":true},"client_id":{"type":"string","description":"Public identifier for the coach.","writeOnly":true},"client_secret":{"type":"string","description":"Secret key or token for authentication.","writeOnly":true},"token":{"type":"string","description":"API key or token for the coach object","writeOnly":true}}},"CoachRecord":{"type":"object","description":"A registered coach as Terra sends it in a webhook.","properties":{"coach_id":{"type":"string","description":"Unique identifier for the coach, generated by the server."},"external_coach_id":{"type":"string","description":"Identifier of the coach on the provider's systems"},"reference_id":{"type":"string","description":"ID of the coach on your system"},"region":{"type":"string","description":"Region in which the coach operates."},"provider":{"type":"string","description":"Integration provider associated with the coach (e.g., VALD, Catapult)."},"created_at":{"type":"string","format":"date-time","description":"The date and time when the coach was registered."}}},"MetricSchema":{"type":"object","properties":{"key":{"type":"string","description":"Unique key for the metric."},"display_name":{"type":["string","null"],"description":"Human-readable name of the metric."},"unit":{"type":["string","null"],"description":"Unit of measurement for the metric."},"type":{"type":["string","null"],"description":"Data type of the metric (e.g., integer, float)."},"sport":{"$ref":"#/components/schemas/Sport","description":"Sport associated with the metric."}}},"Sport":{"type":"integer","description":"Type of sport","oneOf":[{"title":"UNKNOWN","const":-1,"description":"Unknown sport"},{"title":"GENERIC","const":0,"description":"Generic sport"},{"title":"AMERICAN_FOOTBALL","const":10,"description":"American Football"},{"title":"BASEBALL","const":11,"description":"Baseball"},{"title":"BASKETBALL","const":12,"description":"Basketball"},{"title":"CRICKET","const":13,"description":"Cricket"},{"title":"FOOTBALL","const":14,"description":"Football (Soccer)"},{"title":"ICE_HOCKEY","const":15,"description":"Ice Hockey"},{"title":"RUGBY","const":16,"description":"Rugby"},{"title":"TENNIS","const":17,"description":"Tennis"}]},"DataSentToDestination":{"type":"object","description":"Returned when `to_destination=true`. Confirms that data retrieval has been queued and will be delivered to your webhook.","properties":{"coach":{"$ref":"#/components/schemas/Coach"},"reference":{"type":"string","format":"uuid","description":"Unique reference ID for this dispatch. Can be used to correlate the subsequent webhook delivery."},"message":{"type":"string","description":"Human-readable confirmation message."},"type":{"type":"string","description":"The type of data being dispatched.","enum":["test.dispatched","activity.dispatched","activity.metric.dispatched"]}}},"UnauthorizedProblem":{"type":"object","description":"A refused credential, always with its code.","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance","code"]},"ErrorMessage":{"type":"object","description":"The error body teams operations return.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"Problem":{"type":"object","description":"An error response, following RFC 9457 (Problem Details for HTTP APIs, which obsoletes RFC 7807). Returned with `Content-Type: application/problem+json` on every 4xx/5xx response. The HTTP status line carries the status code; it is intentionally not repeated in the body. `type`, `title` and `instance` are always present; `detail` is included when a specific explanation is available.\n","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance"]}},"responses":{"Unauthorized":{"description":"The credential is missing, invalid, expired or revoked (code `unauthorized`).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnauthorizedProblem"}}}},"AuthorizationUnavailable":{"description":"The credential or the product access could not be checked (code `authorization_unavailable`). Retry after the service recovers.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"paths":{"/coaches/{coachId}/activities/metrics/schema":{"get":{"operationId":"getActivityMetricsSchemaForCoach","summary":"Retrieve activity metrics schema for a coach","description":"Lists the metrics a coach's activities can carry, with the key, display name and unit of each.\n\n- Not available yet: a valid request currently returns `500`.","parameters":[{"name":"coachId","in":"path","required":true,"schema":{"type":"string"},"description":"The coach's `coach_id`."},{"name":"to_destination","in":"query","required":false,"description":"Not implemented yet. Whether to send the data to your webhook instead of returning it. When `true`, the response is `202` with a `reference` ID that identifies the later webhook delivery. Defaults to `false`, which returns the data in the response body.","schema":{"type":"string","enum":["true","false"],"default":"false"}}],"responses":{"200":{"description":"Schema retrieved successfully.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/CoachDataReturned"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/MetricSchema"}}}}]}}}},"202":{"description":"Data dispatch accepted. Returned when `to_destination=true`. Data will be sent to your configured webhook.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSentToDestination"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"Coach not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"500":{"description":"Returned for every request that passes validation, because provider data is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"503":{"$ref":"#/components/responses/AuthorizationUnavailable"}},"tags":["Coaches"]}}}}
```

## Retrieve all tests conducted by athletes under a specific coach

> Returns a coach and the tests their athletes completed between \`start\_date\` and \`end\_date\`.\
> \
> \- Not available yet: a valid request currently returns \`500\`.

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"tags":[{"name":"Coaches","summary":"Coaches","description":"Create and delete coaches, and read the athletes, activities and tests under each coach."}],"servers":[{"url":"https://api.tryterra.co/v2/teams","description":"Main teams API base URL"}],"security":[{"ApiKeyAuth":[],"DevID":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your API key for authentication"},"DevID":{"type":"apiKey","in":"header","name":"dev-id","description":"Your developer ID for authentication and tracking"}},"schemas":{"CoachDataReturned":{"type":"object","properties":{"coach":{"$ref":"#/components/schemas/Coach"}}},"Coach":{"type":"object","allOf":[{"$ref":"#/components/schemas/CoachRecord"}],"properties":{"coach_id":{"type":"string","readOnly":true},"external_coach_id":{"type":"string","readOnly":true},"client_id":{"type":"string","description":"Public identifier for the coach.","writeOnly":true},"client_secret":{"type":"string","description":"Secret key or token for authentication.","writeOnly":true},"token":{"type":"string","description":"API key or token for the coach object","writeOnly":true}}},"CoachRecord":{"type":"object","description":"A registered coach as Terra sends it in a webhook.","properties":{"coach_id":{"type":"string","description":"Unique identifier for the coach, generated by the server."},"external_coach_id":{"type":"string","description":"Identifier of the coach on the provider's systems"},"reference_id":{"type":"string","description":"ID of the coach on your system"},"region":{"type":"string","description":"Region in which the coach operates."},"provider":{"type":"string","description":"Integration provider associated with the coach (e.g., VALD, Catapult)."},"created_at":{"type":"string","format":"date-time","description":"The date and time when the coach was registered."}}},"Test":{"type":"object","properties":{"test_id":{"type":["string","null"],"description":"Unique identifier for the test"},"display_name":{"type":["string","null"],"description":"Human-readable name of the test performed"},"timestamp_us":{"type":["integer","null"],"description":"Timestamp of the test in microseconds"},"test_type":{"$ref":"#/components/schemas/TestType"},"exercise_type":{"$ref":"#/components/schemas/ExerciseType"},"athlete_weight":{"type":["number","null"],"description":"Weight of the athlete during the test"},"movement":{"anyOf":[{"$ref":"#/components/schemas/BiomechanicalMovement"},{"type":"null"}]},"tz_offset_seconds":{"type":["integer","null"],"description":"Timezone offset in seconds","default":0},"category":{"anyOf":[{"$ref":"#/components/schemas/TestCategory"},{"type":"null"}]},"duration_us":{"type":["number","null"],"description":"Duration of the test in microseconds"},"body_region":{"anyOf":[{"$ref":"#/components/schemas/BodyRegion"},{"type":"null"}]},"position":{"anyOf":[{"$ref":"#/components/schemas/Position"},{"type":"null"}]},"notes":{"type":["string","null"],"description":"Any notes related to the test"},"device":{"type":["string","null"],"description":"The device used for the test"},"test_result_metrics":{"type":"array","items":{"$ref":"#/components/schemas/TestResultMetric"}},"sets":{"type":"array","items":{"$ref":"#/components/schemas/Set"}}}},"TestType":{"type":"integer","description":"Type of test","oneOf":[{"title":"UNKNOWN","const":-1,"description":"Unknown or undefined test type"},{"title":"CUSTOM","const":9999,"description":"Custom or user-defined test type"},{"title":"ABALAKOV_JUMP","const":1,"description":"Abalakov Jump"},{"title":"COUNTERMOVEMENT_JUMP","const":2,"description":"Countermovement Jump"},{"title":"COUNTERMOVEMENT_JUMP_LOADED","const":3,"description":"Countermovement Jump - Loaded"},{"title":"COUNTERMOVEMENT_REBOUND_JUMP","const":4,"description":"Countermovement Rebound Jump"},{"title":"DROP_JUMP","const":5,"description":"Drop Jump"},{"title":"SINGLE_LEG_HOP_AND_RETURN","const":6,"description":"Single Leg Hop and Return"},{"title":"HOP_TEST","const":7,"description":"Hop Test"},{"title":"SINGLE_LEG_COUNTERMOVEMENT_REBOUND_JUMP","const":8,"description":"Single Leg Countermovement Rebound Jump"},{"title":"SINGLE_LEG_DROP_JUMP","const":9,"description":"Single Leg Drop Jump"},{"title":"SINGLE_LEG_HOP_TEST","const":10,"description":"Single Leg Hop Test"},{"title":"SINGLE_LEG_JUMP","const":11,"description":"Single Leg Jump"},{"title":"SQUAT_JUMP","const":12,"description":"Squat Jump"},{"title":"SQUAT_JUMP_LOADED","const":13,"description":"Squat Jump - Loaded"},{"title":"ISOMETRIC_BELT_SQUAT","const":100,"description":"Isometric Belt Squat"},{"title":"ISOMETRIC_MID_THIGH_PULL","const":101,"description":"Isometric Mid-Thigh Pull"},{"title":"ISOMETRIC_PUSH_UP","const":102,"description":"Isometric Push-Up"},{"title":"ISOMETRIC_SQUAT_HOLD","const":103,"description":"Isometric Squat Hold"},{"title":"RUN_SPECIFIC_ANKLE_ISO_PUSH","const":104,"description":"Run-Specific Ankle Iso-Push"},{"title":"RUN_SPECIFIC_HIP_ISO_PUSH","const":105,"description":"Run-Specific Hip Iso-Push"},{"title":"RUN_SPECIFIC_KNEE_ISO_PUSH","const":106,"description":"Run-Specific Knee Iso-Push"},{"title":"SEATED_ISOMETRIC_CALF_RAISE","const":107,"description":"Seated Isometric Calf Raise"},{"title":"SHOULDER_ISO_I","const":108,"description":"Shoulder ISO-I"},{"title":"SHOULDER_ISO_T","const":109,"description":"Shoulder ISO-T"},{"title":"SHOULDER_ISO_Y","const":110,"description":"Shoulder ISO-Y"},{"title":"QUIET_STAND","const":200,"description":"Quiet Stand"},{"title":"SINGLE_LEG_RANGE_OF_STABILITY","const":201,"description":"Single Leg Range of Stability"},{"title":"SINGLE_LEG_STAND","const":202,"description":"Single Leg Stand"},{"title":"LAND_AND_HOLD","const":300,"description":"Land and Hold"},{"title":"PUSH_UP_TEST","const":301,"description":"Push-Up Test"},{"title":"PLYOMETRIC_PUSH_UP","const":302,"description":"Plyometric Push-Up"},{"title":"SINGLE_LEG_LAND_AND_HOLD","const":303,"description":"Single Leg Land and Hold"},{"title":"SINGLE_LEG_SQUAT","const":304,"description":"Single Leg Squat"},{"title":"SIT_TO_STAND_TO_SIT","const":305,"description":"Sit to Stand to Sit"},{"title":"SQUAT_ASSESSMENT","const":306,"description":"Squat Assessment"},{"title":"GENERAL_FORCE_TIME_ANALYSIS","const":400,"description":"General Force-Time Analysis"}]},"ExerciseType":{"type":"integer","description":"Type of exercise","oneOf":[{"title":"UNKNOWN","const":-1,"description":"Unknown or undefined exercise type"},{"title":"CUSTOM","const":1250,"description":"Custom or user-defined exercise type"},{"title":"NORDIC","const":480,"description":"Nordic exercise"},{"title":"RAZOR_CURL","const":490,"description":"Razor Curl exercise"},{"title":"DEADLIFT","const":500,"description":"Deadlift exercise"},{"title":"ABDOMINAL_CRUNCH","const":510,"description":"Abdominal Crunch exercise"},{"title":"BENCH_PRESS","const":520,"description":"Bench Press exercise"},{"title":"BENCH_PULL","const":530,"description":"Bench Pull exercise"},{"title":"BENCH_THROW","const":540,"description":"Bench Throw exercise"},{"title":"BENT_ARM_PULLOVER","const":550,"description":"Bent Arm Pullover exercise"},{"title":"BICEP_CURLS","const":560,"description":"Bicep Curls exercise"},{"title":"CALF_RAISE","const":570,"description":"Calf Raise exercise"},{"title":"CHEST_PRESS","const":580,"description":"Chest Press exercise"},{"title":"CHIN_UP","const":590,"description":"Chin-Up exercise"},{"title":"CLEAN","const":600,"description":"Clean exercise"},{"title":"CLEAN_PULL","const":610,"description":"Clean Pull exercise"},{"title":"CLEAN_AND_JERK","const":620,"description":"Clean and Jerk exercise"},{"title":"CORMAX_BENCH_THROW","const":630,"description":"Cormax Bench Throw exercise"},{"title":"SHOULDER_RAISE","const":640,"description":"Shoulder Raise exercise"},{"title":"DECLINE_BENCH","const":650,"description":"Decline Bench exercise"},{"title":"DIP_SEATED","const":660,"description":"Seated Dip exercise"},{"title":"DIPS","const":670,"description":"Dips exercise"},{"title":"DOMINATOR","const":680,"description":"Dominator exercise"},{"title":"DROP_JUMP","const":690,"description":"Drop Jump exercise"},{"title":"EXTENSION_TRICEPS","const":700,"description":"Triceps Extension exercise"},{"title":"EXTENSION_TRUNK","const":710,"description":"Trunk Extension exercise"},{"title":"FLOOR_PRESS","const":720,"description":"Floor Press exercise"},{"title":"FULL_CLEAN","const":730,"description":"Full Clean exercise"},{"title":"GOOD_MORNING","const":740,"description":"Good Morning exercise"},{"title":"GOOD_MORNINGS","const":750,"description":"Good Mornings exercise"},{"title":"HIGH_PULL","const":760,"description":"High Pull exercise"},{"title":"HIP_EXTENSION","const":770,"description":"Hip Extension exercise"},{"title":"HIP_SWING","const":780,"description":"Hip Swing exercise"},{"title":"HIP_THRUST","const":790,"description":"Hip Thrust exercise"},{"title":"INCLINE_PRESS","const":800,"description":"Incline Press exercise"},{"title":"JAMMER","const":810,"description":"Jammer exercise"},{"title":"JERK","const":820,"description":"Jerk exercise"},{"title":"LANDMINE","const":830,"description":"Landmine exercise"},{"title":"LAT_PULLDOWN","const":840,"description":"Lat Pulldown exercise"},{"title":"LATERAL_BOUND","const":850,"description":"Lateral Bound exercise"},{"title":"LATERAL_HOP","const":860,"description":"Lateral Hop exercise"},{"title":"LATERAL_SHUFFLE","const":870,"description":"Lateral Shuffle exercise"},{"title":"LEG_CURL","const":880,"description":"Leg Curl exercise"},{"title":"LEG_EXTENSION","const":890,"description":"Leg Extension exercise"},{"title":"LEG_PRESS","const":900,"description":"Leg Press exercise"},{"title":"LEG_RAISE","const":910,"description":"Leg Raise exercise"},{"title":"LUNGE","const":920,"description":"Lunge exercise"},{"title":"MILITARY_PRESS","const":930,"description":"Military Press exercise"},{"title":"MUSCLE_CLEAN","const":940,"description":"Muscle Clean exercise"},{"title":"NORDIC_HAMSTRING","const":950,"description":"Nordic Hamstring exercise"},{"title":"POWER_CLEAN","const":960,"description":"Power Clean exercise"},{"title":"POWER_SHRUG","const":970,"description":"Power Shrug exercise"},{"title":"POWER_SNATCH","const":980,"description":"Power Snatch exercise"},{"title":"PRESS","const":990,"description":"Press exercise"},{"title":"PULL","const":1000,"description":"Pull exercise"},{"title":"PULLDOWN","const":1010,"description":"Pulldown exercise"},{"title":"PULLUP","const":1020,"description":"Pull-Up exercise"},{"title":"PUSHUP","const":1030,"description":"Push-Up exercise"},{"title":"RACK_PULL","const":1040,"description":"Rack Pull exercise"},{"title":"ROW","const":1050,"description":"Row exercise"},{"title":"ROW_LOW","const":1060,"description":"Low Row exercise"},{"title":"ROW_SEATED","const":1070,"description":"Seated Row exercise"},{"title":"ROW_TBAR","const":1080,"description":"T-Bar Row exercise"},{"title":"SCRUM_SLED","const":1090,"description":"Scrum Sled exercise"},{"title":"SHOULDER_PRESS","const":1100,"description":"Shoulder Press exercise"},{"title":"SHRUG","const":1110,"description":"Shrug exercise"},{"title":"SHUTTLE_PRESS","const":1120,"description":"Shuttle Press exercise"},{"title":"SKATER","const":1130,"description":"Skater exercise"},{"title":"SNATCH","const":1140,"description":"Snatch exercise"},{"title":"SQUAT","const":1150,"description":"Squat exercise"},{"title":"SQUAT_JUMP","const":1160,"description":"Squat Jump exercise"},{"title":"STEP_UPS","const":1170,"description":"Step-Ups exercise"},{"title":"STRAIGHT_ARM_PULLDOWN","const":1180,"description":"Straight Arm Pulldown exercise"},{"title":"THRUSTER","const":1190,"description":"Thruster exercise"},{"title":"TORSO","const":1200,"description":"Torso exercise"},{"title":"VIKING_PRESS","const":1210,"description":"Viking Press exercise"}]},"BiomechanicalMovement":{"type":"integer","description":"Type of movement, including biomechanical actions and custom movements","oneOf":[{"title":"UNKNOWN","const":-1,"description":"Unknown movement"},{"title":"CUSTOM","const":9999,"description":"Custom or user-defined movement"},{"title":"ABDUCTION","const":10,"description":"Abduction"},{"title":"ADDUCTION","const":20,"description":"Adduction"},{"title":"ADDUCTION_SQUEEZE","const":30,"description":"Adduction squeeze"},{"title":"FLEXION","const":40,"description":"Flexion"},{"title":"EXTENSION","const":50,"description":"Extension"},{"title":"EXTERNAL_ROTATION","const":60,"description":"External rotation"},{"title":"INTERNAL_ROTATION","const":70,"description":"Internal rotation"},{"title":"HORIZONTAL_ABDUCTION","const":80,"description":"Horizontal abduction"},{"title":"HORIZONTAL_ADDUCTION","const":90,"description":"Horizontal adduction"},{"title":"SCAPTION","const":100,"description":"Scaption"},{"title":"DORSIFLEXION","const":110,"description":"Dorsiflexion"},{"title":"PLANTAR_FLEXION","const":120,"description":"Plantar flexion"},{"title":"EVERSION","const":130,"description":"Eversion"},{"title":"INVERSION","const":140,"description":"Inversion"},{"title":"TOE_FLEXION","const":150,"description":"Toe flexion"},{"title":"TOE_EXTENSION","const":160,"description":"Toe extension"},{"title":"ISOMETRIC_MID_THIGH_PULL","const":170,"description":"Isometric mid-thigh pull"},{"title":"JUMP","const":180,"description":"Jump"},{"title":"LATERAL_FLEXION_LEFT","const":190,"description":"Lateral flexion left"},{"title":"LATERAL_FLEXION_RIGHT","const":200,"description":"Lateral flexion right"},{"title":"ROTATION_LEFT","const":210,"description":"Rotation left"},{"title":"ROTATION_RIGHT","const":220,"description":"Rotation right"},{"title":"PROTRACTION","const":230,"description":"Protraction"},{"title":"RETRACTION","const":240,"description":"Retraction"},{"title":"ELEVATION","const":250,"description":"Elevation"},{"title":"ROTATION","const":260,"description":"Rotation"},{"title":"INTERNAL_ROTATION_EXTERNAL_ROTATION","const":270,"description":"Internal and external rotation"},{"title":"FLEXION_EXTENSION","const":280,"description":"Flexion and extension"},{"title":"ADDUCTION_ABDUCTION","const":290,"description":"Adduction and abduction"},{"title":"DORSIFLEXION_PLANTAR_FLEXION","const":300,"description":"Dorsiflexion and plantar flexion"},{"title":"INVERSION_EVERSION","const":310,"description":"Inversion and eversion"},{"title":"LATERAL_FLEXION_LEFT_LATERAL_FLEXION_RIGHT","const":320,"description":"Lateral flexion left and right"},{"title":"ROTATION_LEFT_ROTATION_RIGHT","const":330,"description":"Rotation left and right"},{"title":"SUPINATION_PRONATION","const":340,"description":"Supination and pronation"},{"title":"HORIZONTAL_ABDUCTION_ADDUCTION","const":350,"description":"Horizontal abduction and adduction"},{"title":"RADIAL_DEVIATION_ULNA_DEVIATION","const":360,"description":"Radial and ulnar deviation"},{"title":"GRIP_SQUEEZE","const":370,"description":"Grip squeeze"},{"title":"RADIAL_DEVIATION","const":380,"description":"Radial deviation"},{"title":"ULNA_DEVIATION","const":390,"description":"Ulnar deviation"},{"title":"SUPINATION","const":400,"description":"Supination"},{"title":"PRONATION","const":410,"description":"Pronation"},{"title":"PINCH_GRIP","const":420,"description":"Pinch grip"},{"title":"FIRST_FINGER_PINCH","const":430,"description":"First finger pinch"},{"title":"SECOND_FINGER_PINCH","const":440,"description":"Second finger pinch"},{"title":"THIRD_FINGER_PINCH","const":450,"description":"Third finger pinch"},{"title":"FOURTH_FINGER_PINCH","const":460,"description":"Fourth finger pinch"},{"title":"THREE_POINT_PINCH","const":470,"description":"Three-point pinch"}]},"TestCategory":{"type":"integer","description":"Category of the test","oneOf":[{"title":"UNKNOWN","const":0,"description":"Unknown category"},{"title":"ISOMETRIC_STRENGTH","const":1,"description":"Isometric strength test"},{"title":"STRENGTH","const":2,"description":"Strength test"},{"title":"RANGE_OF_MOTION","const":3,"description":"Range of motion test"}]},"BodyRegion":{"type":"integer","description":"Body region tested","oneOf":[{"title":"NA","const":0,"description":"Not applicable"},{"title":"NECK","const":1,"description":"Neck"},{"title":"SHOULDER","const":2,"description":"Shoulder"},{"title":"TRUNK","const":3,"description":"Trunk"},{"title":"HIP","const":4,"description":"Hip"},{"title":"ELBOW","const":5,"description":"Elbow"},{"title":"WRIST","const":6,"description":"Wrist"},{"title":"HAND","const":7,"description":"Hand"},{"title":"KNEE","const":8,"description":"Knee"},{"title":"ANKLE","const":9,"description":"Ankle"},{"title":"FOOT","const":10,"description":"Foot"},{"title":"SCAPULA","const":11,"description":"Scapula"}]},"Position":{"type":"integer","description":"Position indicator","oneOf":[{"title":"UNKNOWN","const":0,"description":"Unknown position"},{"title":"NEUTRAL","const":10,"description":"Neutral position"},{"title":"CUSTOM","const":20,"description":"Custom position"},{"title":"P30_DEGREES_ABDUCTION","const":100,"description":"30 degrees abduction"},{"title":"P45_DEGREES_ABDUCTION","const":110,"description":"45 degrees abduction"},{"title":"P90_DEGREES_ABDUCTION","const":120,"description":"90 degrees abduction"},{"title":"STANDING_30_DEGREES_ABDUCTION","const":130,"description":"Standing with 30 degrees abduction"},{"title":"P90_DEGREES_SHOULDER_ABDUCTION","const":140,"description":"90 degrees shoulder abduction"},{"title":"SUPINE_90_DEGREES_SHOULDER_ABDUCTION","const":150,"description":"Supine position with 90 degrees shoulder abduction"},{"title":"SEATED_90_DEGREES_SHOULDER_ABDUCTION_LONG_LEVER","const":160,"description":"Seated with 90 degrees shoulder abduction, long lever"},{"title":"SEATED_90_DEGREES_SHOULDER_ABDUCTION_SHORT_LEVER","const":170,"description":"Seated with 90 degrees shoulder abduction, short lever"},{"title":"P90_DEGREES_FLEXION","const":200,"description":"90 degrees flexion"},{"title":"HORIZONTAL_FLEXION","const":210,"description":"Horizontal flexion"},{"title":"P90_DEGREES_ELBOW_FLEXION","const":220,"description":"90 degrees elbow flexion"},{"title":"P90_DEGREES_SHOULDER_FLEXION","const":230,"description":"90 degrees shoulder flexion"},{"title":"SEATED_90_DEGREE_SHOULDER_FLEXION","const":240,"description":"Seated with 90 degrees shoulder flexion"},{"title":"STANDING_90_DEGREE_SHOULDER_FLEXION","const":250,"description":"Standing with 90 degrees shoulder flexion"},{"title":"SEATED","const":300,"description":"Seated position"},{"title":"SEATED_ELBOW_90_DEGREES","const":310,"description":"Seated with elbow at 90 degrees"},{"title":"SEATED_ELBOW_90_DEGREES_90_DEGREE_SHOULDER_ABDUCTION","const":320,"description":"Seated with elbow and shoulder at 90 degrees abduction"},{"title":"SEATED_SHORT_LEVER","const":330,"description":"Seated with short lever"},{"title":"SEATED_LONG_LEVER","const":340,"description":"Seated with long lever"},{"title":"SEATED_45_DEGREES","const":350,"description":"Seated at 45 degrees"},{"title":"SEATED_90_DEGREES","const":360,"description":"Seated at 90 degrees"},{"title":"SEATED_10_DEGREES","const":370,"description":"Seated at 10 degrees"},{"title":"STANDING","const":400,"description":"Standing position"},{"title":"STANDING_ELBOW_90_DEGREES","const":410,"description":"Standing with elbow at 90 degrees"},{"title":"STANDING_ELBOW_90_DEGREES_90_DEGREE_SHOULDER_ABDUCTION","const":420,"description":"Standing with elbow and shoulder at 90 degrees abduction"},{"title":"STANDING_LONG_LEVER","const":430,"description":"Standing with long lever"},{"title":"STANDING_SHORT_LEVER","const":440,"description":"Standing with short lever"},{"title":"KNEE_60_DEGREES","const":450,"description":"Knee at 60 degrees"},{"title":"KICKER","const":460,"description":"Kicker position"},{"title":"LONG_SITTING_PLANTAR_FLEXED","const":500,"description":"Long sitting with plantar flexed"},{"title":"LONG_SITTING_PLANTIGRADE","const":510,"description":"Long sitting with plantigrade"},{"title":"LONG_SITTING","const":520,"description":"Long sitting position"},{"title":"SIDE_LYING","const":600,"description":"Side lying position"},{"title":"SIDE_LYING_LONG_LEVER","const":610,"description":"Side lying with long lever"},{"title":"SIDE_LYING_SHORT_LEVER","const":620,"description":"Side lying with short lever"},{"title":"PRONE","const":700,"description":"Prone position"},{"title":"MID_PRONE","const":710,"description":"Mid-prone position"},{"title":"PRONE_LONG_LEVER","const":720,"description":"Prone with long lever"},{"title":"PRONE_90_DEGREE_KNEE_FLEXION","const":730,"description":"Prone with 90 degrees knee flexion"},{"title":"PRONE_SHORT_LEVER","const":740,"description":"Prone with short lever"},{"title":"SEMI_PRONE","const":750,"description":"Semi-prone position"},{"title":"SUPINE","const":800,"description":"Supine position"},{"title":"SUPINE_90_DEGREES_HIP_FLEXION","const":810,"description":"Supine with 90 degrees hip flexion"},{"title":"SUPINE_ELBOW_90_DEGREES_90_DEGREE_SHOULDER_ABDUCTION","const":820,"description":"Supine with elbow and shoulder at 90 degrees abduction"},{"title":"SUPINE_ELBOW_90_DEGREES","const":830,"description":"Supine with elbow at 90 degrees"},{"title":"SUPINE_ELBOW_90_DEGREES_120_SHOULDER_ABDUCTION","const":840,"description":"Supine with elbow at 90 degrees and shoulder at 120 degrees abduction"},{"title":"SUPINE_LONG_LEVER","const":850,"description":"Supine with long lever"},{"title":"SUPINE_SHORT_LEVER","const":860,"description":"Supine with short lever"},{"title":"SUPINE_KNEES_45_DEGREES","const":870,"description":"Supine with knees at 45 degrees"},{"title":"SUPINE_KNEES_90_DEGREES","const":880,"description":"Supine with knees at 90 degrees"},{"title":"SUPINE_45_DEGREES","const":890,"description":"Supine at 45 degrees"},{"title":"SUPINE_10_DEGREES","const":900,"description":"Supine at 10 degrees"},{"title":"SUPINE_90_DEGREES","const":910,"description":"Supine at 90 degrees"},{"title":"P45_DEGREES","const":1000,"description":"45 degrees position"},{"title":"P60_DEGREES","const":1005,"description":"60 degrees position"},{"title":"P90_DEGREES","const":1010,"description":"90 degrees position"},{"title":"ELBOW_EXTENDED","const":1020,"description":"Elbow extended"},{"title":"PRONATED","const":1030,"description":"Pronated position"},{"title":"SUPINATED","const":1040,"description":"Supinated position"},{"title":"KNEE_0_DEGREES","const":1050,"description":"Knee at 0 degrees"},{"title":"KNEE_45_DEGREES","const":1060,"description":"Knee at 45 degrees"},{"title":"KNEE_90_DEGREES","const":1070,"description":"Knee at 90 degrees"},{"title":"KNEE_30_DEGREES","const":1080,"description":"Knee at 30 degrees"},{"title":"ISOMETRIC_MID_THIGH_PULL","const":1090,"description":"Isometric mid-thigh pull position"},{"title":"P90_DEGREE_ELBOW_FLEXION_WRIST_NEUTRAL","const":1100,"description":"90 degrees elbow flexion with wrist neutral"},{"title":"P90_DEGREE_ELBOW_FLEXION_WRIST_SUPINATED","const":1110,"description":"90 degrees elbow flexion with wrist supinated"},{"title":"P90_DEGREE_ELBOW_FLEXION_WRIST_PRONATED","const":1120,"description":"90 degrees elbow flexion with wrist pronated"},{"title":"P90_DEGREE_ELBOW_FLEXION_90_ABDUCTION_WRIST_NEUTRAL","const":1130,"description":"90 degrees elbow flexion, 90 degrees abduction, wrist neutral"},{"title":"P90_DEGREE_ELBOW_FLEXION_90_ABDUCTION_WRIST_SUPINATED","const":1140,"description":"90 degrees elbow flexion, 90 degrees abduction, wrist supinated"},{"title":"P90_DEGREE_ELBOW_FLEXION_90_ABDUCTION_WRIST_PRONATED","const":1150,"description":"90 degrees elbow flexion, 90 degrees abduction, wrist pronated"},{"title":"P90_DEGREES_ELBOW_FLEXION_WRIST_NEUTRAL","const":1160,"description":"90 degrees elbow flexion with wrist neutral"},{"title":"P90_DEGREES_ELBOW_FLEXION_WRIST_SUPINATED","const":1170,"description":"90 degrees elbow flexion with wrist supinated"},{"title":"P90_DEGREES_ELBOW_FLEXION_WRIST_PRONATED","const":1180,"description":"90 degrees elbow flexion with wrist pronated"},{"title":"QUADRUPED","const":1190,"description":"Quadruped position"}]},"TestResultMetric":{"type":"object","properties":{"side":{"$ref":"#/components/schemas/Side","description":"Side indicator"},"aspect":{"$ref":"#/components/schemas/Aspect","description":"Aspect indicator"},"statistic_type":{"$ref":"#/components/schemas/StatisticType","description":"Type of statistic"},"metric_type":{"$ref":"#/components/schemas/MetricType"},"contraction_type":{"$ref":"#/components/schemas/ContractionType","description":"Type of muscle contraction"},"value":{"type":["number","null"],"description":"Value of the metric"}}},"Side":{"type":"integer","description":"Side indicator","oneOf":[{"title":"NA","const":0,"description":"Not applicable"},{"title":"LEFT","const":1,"description":"Left side"},{"title":"RIGHT","const":2,"description":"Right side"},{"title":"LEFT_THEN_RIGHT","const":3,"description":"Left side followed by right side"},{"title":"RIGHT_THEN_LEFT","const":4,"description":"Right side followed by left side"},{"title":"BOTH","const":5,"description":"Both sides simultaneously"},{"title":"ASYMMETRY_PERCENTAGE","const":6,"description":"Asymmetry percentage between sides"}]},"Aspect":{"type":"integer","description":"Aspect indicator","oneOf":[{"title":"NA","const":-1,"description":"Not applicable"},{"title":"INNER","const":10,"description":"Inner aspect"},{"title":"OUTER","const":20,"description":"Outer aspect"},{"title":"VERTICAL","const":30,"description":"Vertical aspect"},{"title":"HORIZONTAL","const":40,"description":"Horizontal aspect"},{"title":"MEDIAL","const":50,"description":"Medial aspect"},{"title":"LATERAL","const":60,"description":"Lateral aspect"},{"title":"ANTERIOR","const":70,"description":"Anterior aspect"},{"title":"POSTERIOR","const":80,"description":"Posterior aspect"},{"title":"TAKEOFF","const":90,"description":"Takeoff phase"},{"title":"LANDING","const":100,"description":"Landing phase"}]},"StatisticType":{"type":"integer","description":"Type of statistic","oneOf":[{"title":"NA","const":-1,"description":"Not applicable"},{"title":"AVG","const":1,"description":"Average value"},{"title":"MIN","const":2,"description":"Minimum value"},{"title":"MAX","const":3,"description":"Maximum value"},{"title":"TOTAL","const":4,"description":"Total value"},{"title":"INSTANTANEOUS","const":5,"description":"Instantaneous value"}]},"MetricType":{"type":"integer","description":"Type of metric","oneOf":[{"title":"BODY_MASS","const":1,"description":"Body mass"},{"title":"FORCE","const":2,"description":"Force"},{"title":"ACCELERATION","const":3,"description":"Acceleration"},{"title":"IMPULSE","const":4,"description":"Impulse"},{"title":"BRAKING_IMPULSE","const":5,"description":"Braking impulse"},{"title":"VELOCITY","const":6,"description":"Velocity"},{"title":"POWER","const":7,"description":"Power"},{"title":"REPETITIONS","const":8,"description":"Repetitions"},{"title":"TORQUE","const":9,"description":"Torque"},{"title":"CALIBRATION","const":10,"description":"Calibration"},{"title":"ROM_DEGREES","const":11,"description":"Range of motion in degrees"},{"title":"TIME_TO_PEAK_FORCE","const":12,"description":"Time to peak force"},{"title":"TIME_TO_PEAK_POWER","const":13,"description":"Time to peak power"},{"title":"TIME_TO_PEAK_VELOCITY","const":14,"description":"Time to peak velocity"},{"title":"RATE_OF_FORCE_DEVELOPMENT","const":15,"description":"Rate of force development"},{"title":"HEIGHT","const":16,"description":"Height"},{"title":"DIP","const":17,"description":"Dip"},{"title":"WATTS_PER_KG","const":18,"description":"Watts per kilogram"},{"title":"WORK","const":19,"description":"Work"},{"title":"CONTACT_TIME","const":20,"description":"Contact time"},{"title":"FLIGHT_TIME","const":21,"description":"Flight time"},{"title":"ROM_DISTANCE","const":22,"description":"Range of motion distance"},{"title":"HORIZONTAL_DISTANCE","const":23,"description":"Horizontal distance"},{"title":"LIFT_DISTANCE","const":24,"description":"Lift distance"},{"title":"MAX_BACK","const":25,"description":"Maximum back movement"},{"title":"MAX_FORWARD","const":26,"description":"Maximum forward movement"},{"title":"DURATION","const":27,"description":"Duration"},{"title":"REP_RATE","const":28,"description":"Repetition rate"},{"title":"TOTAL_TRAVEL_PATH","const":29,"description":"Total travel path"},{"title":"VERTICAL_DISTANCE","const":30,"description":"Vertical distance"},{"title":"REACTIVE_STRENGTH_INDEX","const":31,"description":"Reactive strength index"},{"title":"REPETITION_RATE","const":32,"description":"Repetition rate"},{"title":"JUMP_HEIGHT","const":33,"description":"Jump height"}]},"ContractionType":{"type":"integer","description":"Type of muscle contraction","oneOf":[{"title":"UNKNOWN","const":-1,"description":"Unknown contraction type"},{"title":"NA","const":0,"description":"Not applicable"},{"title":"ECCENTRIC","const":1,"description":"Eccentric contraction"},{"title":"CONCENTRIC","const":2,"description":"Concentric contraction"},{"title":"ISOMETRIC","const":3,"description":"Isometric contraction"},{"title":"ISOINERTIAL","const":4,"description":"Isoinertial contraction"},{"title":"ISOKINETIC","const":5,"description":"Isokinetic contraction"},{"title":"ISOTONIC","const":6,"description":"Isotonic contraction"}]},"Set":{"type":"object","properties":{"metrics":{"type":"array","items":{"$ref":"#/components/schemas/TestResultMetric"}},"timestamp_us":{"type":["integer","null"],"description":"Timestamp of the set in microseconds"},"duration_us":{"type":["integer","null"],"description":"Duration of the set in microseconds"},"side":{"$ref":"#/components/schemas/Side","default":0},"aspect":{"$ref":"#/components/schemas/Aspect","default":-1},"reps":{"type":"array","items":{"$ref":"#/components/schemas/Rep"}},"weight":{"type":["number","null"],"description":"Weight used for the exercise"},"exercise_name":{"type":["string","null"],"description":"Name of the exercise"},"variations":{"type":"array","items":{"$ref":"#/components/schemas/Variation"}},"movement":{"$ref":"#/components/schemas/BiomechanicalMovement","default":-1}}},"Rep":{"type":"object","properties":{"offset_us":{"type":"integer","description":"Offset from start of test in microseconds"},"duration_us":{"type":"number","description":"Duration of the rep in microseconds"},"metrics":{"type":"array","description":"List of metrics for the rep","items":{"$ref":"#/components/schemas/TestResultMetric"}}}},"Variation":{"type":"integer","description":"Exercise variation","oneOf":[{"title":"BARBELL","const":10,"description":"Using a barbell"},{"title":"DUMBBELL","const":20,"description":"Using dumbbells"},{"title":"BAND","const":30,"description":"Using resistance bands"},{"title":"CHAIN","const":40,"description":"Using chains"},{"title":"LOG_BAR","const":50,"description":"Using a log bar"},{"title":"KADILLAC_BAR","const":60,"description":"Using a Kadillac bar"},{"title":"SWISS_BAR","const":70,"description":"Using a Swiss bar"},{"title":"SMITH_MACHINE","const":80,"description":"Using a Smith machine"},{"title":"TRAP_BAR","const":90,"description":"Using a trap bar"},{"title":"KETTLE_BELL","const":100,"description":"Using kettlebells"},{"title":"CAMBER_BAR","const":110,"description":"Using a camber bar"},{"title":"DUFFALO_BAR","const":120,"description":"Using a Duffalo bar"},{"title":"SSB","const":130,"description":"Using a safety squat bar"},{"title":"KEISER","const":140,"description":"Using Keiser equipment"},{"title":"SORINEX","const":150,"description":"Using Sorinex equipment"},{"title":"INCLINE","const":160,"description":"Incline variation"},{"title":"INCLINE_30_DEGREES","const":170,"description":"Incline at 30 degrees"},{"title":"INCLINE_45_DEGREES","const":180,"description":"Incline at 45 degrees"},{"title":"INCLINE_60_DEGREES","const":190,"description":"Incline at 60 degrees"},{"title":"DECLINE","const":200,"description":"Decline variation"},{"title":"CLOSE_GRIP","const":210,"description":"Close grip"},{"title":"WIDE_GRIP","const":220,"description":"Wide grip"},{"title":"NEUTRAL_GRIP","const":230,"description":"Neutral grip"},{"title":"OVERHAND_GRIP","const":240,"description":"Overhand (pronated) grip"},{"title":"UNDERHAND_GRIP","const":250,"description":"Underhand (supinated) grip"},{"title":"SNATCH_GRIP","const":260,"description":"Snatch grip"},{"title":"ALTERNATING_GRIP","const":270,"description":"Alternating grip"},{"title":"PARALLEL_GRIP","const":280,"description":"Parallel grip"},{"title":"HOOK_GRIP","const":290,"description":"Hook grip"},{"title":"HIGH_BAR","const":300,"description":"High bar position"},{"title":"LOW_BAR","const":310,"description":"Low bar position"},{"title":"OVERHEAD","const":320,"description":"Overhead position"},{"title":"BEHIND_NECK","const":330,"description":"Behind the neck position"},{"title":"FRONT","const":340,"description":"Front position"},{"title":"BEHIND","const":350,"description":"Behind position"},{"title":"SEATED","const":360,"description":"Seated variation"},{"title":"STANDING","const":370,"description":"Standing variation"},{"title":"HANG","const":380,"description":"Hang position"},{"title":"HIGH_PULL","const":390,"description":"High pull"},{"title":"SPLIT","const":400,"description":"Split stance"},{"title":"BLOCK","const":410,"description":"Using blocks"},{"title":"BLOCK_7_5_CM","const":420,"description":"Block height 7.5 cm"},{"title":"BLOCK_15_CM","const":430,"description":"Block height 15 cm"},{"title":"BLOCK_22_5_CM","const":440,"description":"Block height 22.5 cm"},{"title":"BLOCK_30_CM","const":450,"description":"Block height 30 cm"},{"title":"BLOCK_35_CM","const":460,"description":"Block height 35 cm"},{"title":"BLOCK_40_CM","const":470,"description":"Block height 40 cm"},{"title":"DEFICIT","const":480,"description":"Deficit variation"},{"title":"MID_THIGH","const":490,"description":"Mid-thigh position"},{"title":"LOW","const":500,"description":"Low position"},{"title":"HIGH","const":510,"description":"High position"},{"title":"BOX","const":520,"description":"Using a box"},{"title":"PIN_LOADED","const":530,"description":"Pin-loaded equipment"},{"title":"PLATE_LOADED","const":540,"description":"Plate-loaded equipment"},{"title":"DYNAMIC","const":550,"description":"Dynamic movement"},{"title":"REVERSE_DYNAMIC","const":560,"description":"Reverse dynamic movement"},{"title":"PAUSE","const":570,"description":"Pause variation"},{"title":"PINS","const":580,"description":"Using pins"},{"title":"REBOUND","const":590,"description":"Rebound variation"},{"title":"RESET","const":600,"description":"Reset between reps"},{"title":"CONCENTRIC","const":610,"description":"Concentric movement"},{"title":"ECCENTRIC","const":620,"description":"Eccentric movement"},{"title":"JUMP","const":630,"description":"Jump variation"},{"title":"SHRUG","const":640,"description":"Shrug variation"},{"title":"RAISE","const":650,"description":"Raise movement"},{"title":"EXTENSION","const":660,"description":"Extension movement"},{"title":"BULGARIAN","const":670,"description":"Bulgarian variation"},{"title":"LEG_EXT","const":680,"description":"Leg extension"},{"title":"HIP_EXT","const":690,"description":"Hip extension"},{"title":"PENDLAY","const":700,"description":"Pendlay variation"},{"title":"FORWARD","const":710,"description":"Forward movement"},{"title":"LATERAL","const":720,"description":"Lateral movement"},{"title":"STIFF_LEG","const":730,"description":"Stiff leg variation"},{"title":"ROMANIAN","const":740,"description":"Romanian variation"},{"title":"HACK","const":750,"description":"Hack variation"},{"title":"GOOD_MORNING","const":760,"description":"Good morning variation"},{"title":"AB","const":770,"description":"Abdominal focus"},{"title":"DOMINATOR","const":780,"description":"Dominator variation"},{"title":"SKATER","const":790,"description":"Skater variation"},{"title":"LANDMINE","const":800,"description":"Landmine variation"},{"title":"RACK_PULL","const":810,"description":"Rack pull"},{"title":"SISSY","const":820,"description":"Sissy squat"},{"title":"SHUTTLE_PRESS","const":830,"description":"Shuttle press"},{"title":"POGO","const":840,"description":"Pogo variation"},{"title":"SPEED","const":850,"description":"Speed focus"},{"title":"THRUSTER","const":860,"description":"Thruster variation"},{"title":"TWISTS","const":870,"description":"Twisting movement"},{"title":"WOODCHOP","const":880,"description":"Woodchop movement"},{"title":"HAND_SUPPORTED","const":890,"description":"Hand-supported variation"},{"title":"SPLIT_STANCE","const":900,"description":"Split stance"},{"title":"BOSCH","const":910,"description":"Bosch variation"},{"title":"ALTERNATE","const":920,"description":"Alternate movement"},{"title":"COUNT_MOVEMENT","const":930,"description":"Count movement"},{"title":"SCRUM_SLED","const":940,"description":"Using scrum sled"},{"title":"WEIGHTLIFTING_SHOES","const":950,"description":"Using weightlifting shoes"}]},"DataSentToDestination":{"type":"object","description":"Returned when `to_destination=true`. Confirms that data retrieval has been queued and will be delivered to your webhook.","properties":{"coach":{"$ref":"#/components/schemas/Coach"},"reference":{"type":"string","format":"uuid","description":"Unique reference ID for this dispatch. Can be used to correlate the subsequent webhook delivery."},"message":{"type":"string","description":"Human-readable confirmation message."},"type":{"type":"string","description":"The type of data being dispatched.","enum":["test.dispatched","activity.dispatched","activity.metric.dispatched"]}}},"ErrorMessage":{"type":"object","description":"The error body teams operations return.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"UnauthorizedProblem":{"type":"object","description":"A refused credential, always with its code.","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance","code"]},"Problem":{"type":"object","description":"An error response, following RFC 9457 (Problem Details for HTTP APIs, which obsoletes RFC 7807). Returned with `Content-Type: application/problem+json` on every 4xx/5xx response. The HTTP status line carries the status code; it is intentionally not repeated in the body. `type`, `title` and `instance` are always present; `detail` is included when a specific explanation is available.\n","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance"]}},"responses":{"Unauthorized":{"description":"The credential is missing, invalid, expired or revoked (code `unauthorized`).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnauthorizedProblem"}}}},"AuthorizationUnavailable":{"description":"The credential or the product access could not be checked (code `authorization_unavailable`). Retry after the service recovers.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"paths":{"/coaches/{coachId}/tests":{"get":{"operationId":"getTestsForCoach","description":"Returns a coach and the tests their athletes completed between `start_date` and `end_date`.\n\n- Not available yet: a valid request currently returns `500`.","summary":"Retrieve all tests conducted by athletes under a specific coach","parameters":[{"name":"coachId","in":"path","required":true,"schema":{"type":"string"},"description":"The coach's `coach_id`."},{"name":"start_date","in":"query","required":true,"description":"Start date for the query range (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"End of the date range, as YYYY-MM-DD. Defaults to one day after `start_date`.","schema":{"type":"string","format":"date"}},{"name":"to_destination","in":"query","required":false,"description":"Not implemented yet. Whether to send the data to your webhook instead of returning it. When `true`, the response is `202` with a `reference` ID that identifies the later webhook delivery. Defaults to `false`, which returns the data in the response body.","schema":{"type":"string","enum":["true","false"],"default":"false"}}],"responses":{"200":{"description":"List of tests within the specified time range for all athletes under the coach","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/CoachDataReturned"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Test"}}}}]}}}},"202":{"description":"Data dispatch accepted. Returned when `to_destination=true`. Data will be sent to your configured webhook.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSentToDestination"}}}},"400":{"description":"Returned when `start_date` is missing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"Coach not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"500":{"description":"Returned for every request that passes validation, because provider data is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"503":{"$ref":"#/components/responses/AuthorizationUnavailable"}},"tags":["Coaches"]}}}}
```

## Search and filter tests for a specific coach

> Returns a coach and their athletes' tests between \`start\_time\` and \`end\_time\`, optionally only for the athletes listed in \`athlete\_ids\`.\
> \
> \- Not available yet: a valid request currently returns \`500\`.

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"tags":[{"name":"Coaches","summary":"Coaches","description":"Create and delete coaches, and read the athletes, activities and tests under each coach."}],"servers":[{"url":"https://api.tryterra.co/v2/teams","description":"Main teams API base URL"}],"security":[{"ApiKeyAuth":[],"DevID":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your API key for authentication"},"DevID":{"type":"apiKey","in":"header","name":"dev-id","description":"Your developer ID for authentication and tracking"}},"schemas":{"TestSearchQuery":{"type":"object","description":"Query body for filtering tests.","required":["start_time","end_time"],"properties":{"start_time":{"type":"string","format":"date","description":"Start date for the query range (YYYY-MM-DD)."},"end_time":{"type":"string","format":"date","description":"End date for the query range (YYYY-MM-DD)."},"athlete_ids":{"type":"array","description":"Optional list of athlete IDs to filter results. If omitted, returns tests for all athletes. Not applied yet, so every athlete's tests are returned.","items":{"type":"string"}}}},"CoachDataReturned":{"type":"object","properties":{"coach":{"$ref":"#/components/schemas/Coach"}}},"Coach":{"type":"object","allOf":[{"$ref":"#/components/schemas/CoachRecord"}],"properties":{"coach_id":{"type":"string","readOnly":true},"external_coach_id":{"type":"string","readOnly":true},"client_id":{"type":"string","description":"Public identifier for the coach.","writeOnly":true},"client_secret":{"type":"string","description":"Secret key or token for authentication.","writeOnly":true},"token":{"type":"string","description":"API key or token for the coach object","writeOnly":true}}},"CoachRecord":{"type":"object","description":"A registered coach as Terra sends it in a webhook.","properties":{"coach_id":{"type":"string","description":"Unique identifier for the coach, generated by the server."},"external_coach_id":{"type":"string","description":"Identifier of the coach on the provider's systems"},"reference_id":{"type":"string","description":"ID of the coach on your system"},"region":{"type":"string","description":"Region in which the coach operates."},"provider":{"type":"string","description":"Integration provider associated with the coach (e.g., VALD, Catapult)."},"created_at":{"type":"string","format":"date-time","description":"The date and time when the coach was registered."}}},"Test":{"type":"object","properties":{"test_id":{"type":["string","null"],"description":"Unique identifier for the test"},"display_name":{"type":["string","null"],"description":"Human-readable name of the test performed"},"timestamp_us":{"type":["integer","null"],"description":"Timestamp of the test in microseconds"},"test_type":{"$ref":"#/components/schemas/TestType"},"exercise_type":{"$ref":"#/components/schemas/ExerciseType"},"athlete_weight":{"type":["number","null"],"description":"Weight of the athlete during the test"},"movement":{"anyOf":[{"$ref":"#/components/schemas/BiomechanicalMovement"},{"type":"null"}]},"tz_offset_seconds":{"type":["integer","null"],"description":"Timezone offset in seconds","default":0},"category":{"anyOf":[{"$ref":"#/components/schemas/TestCategory"},{"type":"null"}]},"duration_us":{"type":["number","null"],"description":"Duration of the test in microseconds"},"body_region":{"anyOf":[{"$ref":"#/components/schemas/BodyRegion"},{"type":"null"}]},"position":{"anyOf":[{"$ref":"#/components/schemas/Position"},{"type":"null"}]},"notes":{"type":["string","null"],"description":"Any notes related to the test"},"device":{"type":["string","null"],"description":"The device used for the test"},"test_result_metrics":{"type":"array","items":{"$ref":"#/components/schemas/TestResultMetric"}},"sets":{"type":"array","items":{"$ref":"#/components/schemas/Set"}}}},"TestType":{"type":"integer","description":"Type of test","oneOf":[{"title":"UNKNOWN","const":-1,"description":"Unknown or undefined test type"},{"title":"CUSTOM","const":9999,"description":"Custom or user-defined test type"},{"title":"ABALAKOV_JUMP","const":1,"description":"Abalakov Jump"},{"title":"COUNTERMOVEMENT_JUMP","const":2,"description":"Countermovement Jump"},{"title":"COUNTERMOVEMENT_JUMP_LOADED","const":3,"description":"Countermovement Jump - Loaded"},{"title":"COUNTERMOVEMENT_REBOUND_JUMP","const":4,"description":"Countermovement Rebound Jump"},{"title":"DROP_JUMP","const":5,"description":"Drop Jump"},{"title":"SINGLE_LEG_HOP_AND_RETURN","const":6,"description":"Single Leg Hop and Return"},{"title":"HOP_TEST","const":7,"description":"Hop Test"},{"title":"SINGLE_LEG_COUNTERMOVEMENT_REBOUND_JUMP","const":8,"description":"Single Leg Countermovement Rebound Jump"},{"title":"SINGLE_LEG_DROP_JUMP","const":9,"description":"Single Leg Drop Jump"},{"title":"SINGLE_LEG_HOP_TEST","const":10,"description":"Single Leg Hop Test"},{"title":"SINGLE_LEG_JUMP","const":11,"description":"Single Leg Jump"},{"title":"SQUAT_JUMP","const":12,"description":"Squat Jump"},{"title":"SQUAT_JUMP_LOADED","const":13,"description":"Squat Jump - Loaded"},{"title":"ISOMETRIC_BELT_SQUAT","const":100,"description":"Isometric Belt Squat"},{"title":"ISOMETRIC_MID_THIGH_PULL","const":101,"description":"Isometric Mid-Thigh Pull"},{"title":"ISOMETRIC_PUSH_UP","const":102,"description":"Isometric Push-Up"},{"title":"ISOMETRIC_SQUAT_HOLD","const":103,"description":"Isometric Squat Hold"},{"title":"RUN_SPECIFIC_ANKLE_ISO_PUSH","const":104,"description":"Run-Specific Ankle Iso-Push"},{"title":"RUN_SPECIFIC_HIP_ISO_PUSH","const":105,"description":"Run-Specific Hip Iso-Push"},{"title":"RUN_SPECIFIC_KNEE_ISO_PUSH","const":106,"description":"Run-Specific Knee Iso-Push"},{"title":"SEATED_ISOMETRIC_CALF_RAISE","const":107,"description":"Seated Isometric Calf Raise"},{"title":"SHOULDER_ISO_I","const":108,"description":"Shoulder ISO-I"},{"title":"SHOULDER_ISO_T","const":109,"description":"Shoulder ISO-T"},{"title":"SHOULDER_ISO_Y","const":110,"description":"Shoulder ISO-Y"},{"title":"QUIET_STAND","const":200,"description":"Quiet Stand"},{"title":"SINGLE_LEG_RANGE_OF_STABILITY","const":201,"description":"Single Leg Range of Stability"},{"title":"SINGLE_LEG_STAND","const":202,"description":"Single Leg Stand"},{"title":"LAND_AND_HOLD","const":300,"description":"Land and Hold"},{"title":"PUSH_UP_TEST","const":301,"description":"Push-Up Test"},{"title":"PLYOMETRIC_PUSH_UP","const":302,"description":"Plyometric Push-Up"},{"title":"SINGLE_LEG_LAND_AND_HOLD","const":303,"description":"Single Leg Land and Hold"},{"title":"SINGLE_LEG_SQUAT","const":304,"description":"Single Leg Squat"},{"title":"SIT_TO_STAND_TO_SIT","const":305,"description":"Sit to Stand to Sit"},{"title":"SQUAT_ASSESSMENT","const":306,"description":"Squat Assessment"},{"title":"GENERAL_FORCE_TIME_ANALYSIS","const":400,"description":"General Force-Time Analysis"}]},"ExerciseType":{"type":"integer","description":"Type of exercise","oneOf":[{"title":"UNKNOWN","const":-1,"description":"Unknown or undefined exercise type"},{"title":"CUSTOM","const":1250,"description":"Custom or user-defined exercise type"},{"title":"NORDIC","const":480,"description":"Nordic exercise"},{"title":"RAZOR_CURL","const":490,"description":"Razor Curl exercise"},{"title":"DEADLIFT","const":500,"description":"Deadlift exercise"},{"title":"ABDOMINAL_CRUNCH","const":510,"description":"Abdominal Crunch exercise"},{"title":"BENCH_PRESS","const":520,"description":"Bench Press exercise"},{"title":"BENCH_PULL","const":530,"description":"Bench Pull exercise"},{"title":"BENCH_THROW","const":540,"description":"Bench Throw exercise"},{"title":"BENT_ARM_PULLOVER","const":550,"description":"Bent Arm Pullover exercise"},{"title":"BICEP_CURLS","const":560,"description":"Bicep Curls exercise"},{"title":"CALF_RAISE","const":570,"description":"Calf Raise exercise"},{"title":"CHEST_PRESS","const":580,"description":"Chest Press exercise"},{"title":"CHIN_UP","const":590,"description":"Chin-Up exercise"},{"title":"CLEAN","const":600,"description":"Clean exercise"},{"title":"CLEAN_PULL","const":610,"description":"Clean Pull exercise"},{"title":"CLEAN_AND_JERK","const":620,"description":"Clean and Jerk exercise"},{"title":"CORMAX_BENCH_THROW","const":630,"description":"Cormax Bench Throw exercise"},{"title":"SHOULDER_RAISE","const":640,"description":"Shoulder Raise exercise"},{"title":"DECLINE_BENCH","const":650,"description":"Decline Bench exercise"},{"title":"DIP_SEATED","const":660,"description":"Seated Dip exercise"},{"title":"DIPS","const":670,"description":"Dips exercise"},{"title":"DOMINATOR","const":680,"description":"Dominator exercise"},{"title":"DROP_JUMP","const":690,"description":"Drop Jump exercise"},{"title":"EXTENSION_TRICEPS","const":700,"description":"Triceps Extension exercise"},{"title":"EXTENSION_TRUNK","const":710,"description":"Trunk Extension exercise"},{"title":"FLOOR_PRESS","const":720,"description":"Floor Press exercise"},{"title":"FULL_CLEAN","const":730,"description":"Full Clean exercise"},{"title":"GOOD_MORNING","const":740,"description":"Good Morning exercise"},{"title":"GOOD_MORNINGS","const":750,"description":"Good Mornings exercise"},{"title":"HIGH_PULL","const":760,"description":"High Pull exercise"},{"title":"HIP_EXTENSION","const":770,"description":"Hip Extension exercise"},{"title":"HIP_SWING","const":780,"description":"Hip Swing exercise"},{"title":"HIP_THRUST","const":790,"description":"Hip Thrust exercise"},{"title":"INCLINE_PRESS","const":800,"description":"Incline Press exercise"},{"title":"JAMMER","const":810,"description":"Jammer exercise"},{"title":"JERK","const":820,"description":"Jerk exercise"},{"title":"LANDMINE","const":830,"description":"Landmine exercise"},{"title":"LAT_PULLDOWN","const":840,"description":"Lat Pulldown exercise"},{"title":"LATERAL_BOUND","const":850,"description":"Lateral Bound exercise"},{"title":"LATERAL_HOP","const":860,"description":"Lateral Hop exercise"},{"title":"LATERAL_SHUFFLE","const":870,"description":"Lateral Shuffle exercise"},{"title":"LEG_CURL","const":880,"description":"Leg Curl exercise"},{"title":"LEG_EXTENSION","const":890,"description":"Leg Extension exercise"},{"title":"LEG_PRESS","const":900,"description":"Leg Press exercise"},{"title":"LEG_RAISE","const":910,"description":"Leg Raise exercise"},{"title":"LUNGE","const":920,"description":"Lunge exercise"},{"title":"MILITARY_PRESS","const":930,"description":"Military Press exercise"},{"title":"MUSCLE_CLEAN","const":940,"description":"Muscle Clean exercise"},{"title":"NORDIC_HAMSTRING","const":950,"description":"Nordic Hamstring exercise"},{"title":"POWER_CLEAN","const":960,"description":"Power Clean exercise"},{"title":"POWER_SHRUG","const":970,"description":"Power Shrug exercise"},{"title":"POWER_SNATCH","const":980,"description":"Power Snatch exercise"},{"title":"PRESS","const":990,"description":"Press exercise"},{"title":"PULL","const":1000,"description":"Pull exercise"},{"title":"PULLDOWN","const":1010,"description":"Pulldown exercise"},{"title":"PULLUP","const":1020,"description":"Pull-Up exercise"},{"title":"PUSHUP","const":1030,"description":"Push-Up exercise"},{"title":"RACK_PULL","const":1040,"description":"Rack Pull exercise"},{"title":"ROW","const":1050,"description":"Row exercise"},{"title":"ROW_LOW","const":1060,"description":"Low Row exercise"},{"title":"ROW_SEATED","const":1070,"description":"Seated Row exercise"},{"title":"ROW_TBAR","const":1080,"description":"T-Bar Row exercise"},{"title":"SCRUM_SLED","const":1090,"description":"Scrum Sled exercise"},{"title":"SHOULDER_PRESS","const":1100,"description":"Shoulder Press exercise"},{"title":"SHRUG","const":1110,"description":"Shrug exercise"},{"title":"SHUTTLE_PRESS","const":1120,"description":"Shuttle Press exercise"},{"title":"SKATER","const":1130,"description":"Skater exercise"},{"title":"SNATCH","const":1140,"description":"Snatch exercise"},{"title":"SQUAT","const":1150,"description":"Squat exercise"},{"title":"SQUAT_JUMP","const":1160,"description":"Squat Jump exercise"},{"title":"STEP_UPS","const":1170,"description":"Step-Ups exercise"},{"title":"STRAIGHT_ARM_PULLDOWN","const":1180,"description":"Straight Arm Pulldown exercise"},{"title":"THRUSTER","const":1190,"description":"Thruster exercise"},{"title":"TORSO","const":1200,"description":"Torso exercise"},{"title":"VIKING_PRESS","const":1210,"description":"Viking Press exercise"}]},"BiomechanicalMovement":{"type":"integer","description":"Type of movement, including biomechanical actions and custom movements","oneOf":[{"title":"UNKNOWN","const":-1,"description":"Unknown movement"},{"title":"CUSTOM","const":9999,"description":"Custom or user-defined movement"},{"title":"ABDUCTION","const":10,"description":"Abduction"},{"title":"ADDUCTION","const":20,"description":"Adduction"},{"title":"ADDUCTION_SQUEEZE","const":30,"description":"Adduction squeeze"},{"title":"FLEXION","const":40,"description":"Flexion"},{"title":"EXTENSION","const":50,"description":"Extension"},{"title":"EXTERNAL_ROTATION","const":60,"description":"External rotation"},{"title":"INTERNAL_ROTATION","const":70,"description":"Internal rotation"},{"title":"HORIZONTAL_ABDUCTION","const":80,"description":"Horizontal abduction"},{"title":"HORIZONTAL_ADDUCTION","const":90,"description":"Horizontal adduction"},{"title":"SCAPTION","const":100,"description":"Scaption"},{"title":"DORSIFLEXION","const":110,"description":"Dorsiflexion"},{"title":"PLANTAR_FLEXION","const":120,"description":"Plantar flexion"},{"title":"EVERSION","const":130,"description":"Eversion"},{"title":"INVERSION","const":140,"description":"Inversion"},{"title":"TOE_FLEXION","const":150,"description":"Toe flexion"},{"title":"TOE_EXTENSION","const":160,"description":"Toe extension"},{"title":"ISOMETRIC_MID_THIGH_PULL","const":170,"description":"Isometric mid-thigh pull"},{"title":"JUMP","const":180,"description":"Jump"},{"title":"LATERAL_FLEXION_LEFT","const":190,"description":"Lateral flexion left"},{"title":"LATERAL_FLEXION_RIGHT","const":200,"description":"Lateral flexion right"},{"title":"ROTATION_LEFT","const":210,"description":"Rotation left"},{"title":"ROTATION_RIGHT","const":220,"description":"Rotation right"},{"title":"PROTRACTION","const":230,"description":"Protraction"},{"title":"RETRACTION","const":240,"description":"Retraction"},{"title":"ELEVATION","const":250,"description":"Elevation"},{"title":"ROTATION","const":260,"description":"Rotation"},{"title":"INTERNAL_ROTATION_EXTERNAL_ROTATION","const":270,"description":"Internal and external rotation"},{"title":"FLEXION_EXTENSION","const":280,"description":"Flexion and extension"},{"title":"ADDUCTION_ABDUCTION","const":290,"description":"Adduction and abduction"},{"title":"DORSIFLEXION_PLANTAR_FLEXION","const":300,"description":"Dorsiflexion and plantar flexion"},{"title":"INVERSION_EVERSION","const":310,"description":"Inversion and eversion"},{"title":"LATERAL_FLEXION_LEFT_LATERAL_FLEXION_RIGHT","const":320,"description":"Lateral flexion left and right"},{"title":"ROTATION_LEFT_ROTATION_RIGHT","const":330,"description":"Rotation left and right"},{"title":"SUPINATION_PRONATION","const":340,"description":"Supination and pronation"},{"title":"HORIZONTAL_ABDUCTION_ADDUCTION","const":350,"description":"Horizontal abduction and adduction"},{"title":"RADIAL_DEVIATION_ULNA_DEVIATION","const":360,"description":"Radial and ulnar deviation"},{"title":"GRIP_SQUEEZE","const":370,"description":"Grip squeeze"},{"title":"RADIAL_DEVIATION","const":380,"description":"Radial deviation"},{"title":"ULNA_DEVIATION","const":390,"description":"Ulnar deviation"},{"title":"SUPINATION","const":400,"description":"Supination"},{"title":"PRONATION","const":410,"description":"Pronation"},{"title":"PINCH_GRIP","const":420,"description":"Pinch grip"},{"title":"FIRST_FINGER_PINCH","const":430,"description":"First finger pinch"},{"title":"SECOND_FINGER_PINCH","const":440,"description":"Second finger pinch"},{"title":"THIRD_FINGER_PINCH","const":450,"description":"Third finger pinch"},{"title":"FOURTH_FINGER_PINCH","const":460,"description":"Fourth finger pinch"},{"title":"THREE_POINT_PINCH","const":470,"description":"Three-point pinch"}]},"TestCategory":{"type":"integer","description":"Category of the test","oneOf":[{"title":"UNKNOWN","const":0,"description":"Unknown category"},{"title":"ISOMETRIC_STRENGTH","const":1,"description":"Isometric strength test"},{"title":"STRENGTH","const":2,"description":"Strength test"},{"title":"RANGE_OF_MOTION","const":3,"description":"Range of motion test"}]},"BodyRegion":{"type":"integer","description":"Body region tested","oneOf":[{"title":"NA","const":0,"description":"Not applicable"},{"title":"NECK","const":1,"description":"Neck"},{"title":"SHOULDER","const":2,"description":"Shoulder"},{"title":"TRUNK","const":3,"description":"Trunk"},{"title":"HIP","const":4,"description":"Hip"},{"title":"ELBOW","const":5,"description":"Elbow"},{"title":"WRIST","const":6,"description":"Wrist"},{"title":"HAND","const":7,"description":"Hand"},{"title":"KNEE","const":8,"description":"Knee"},{"title":"ANKLE","const":9,"description":"Ankle"},{"title":"FOOT","const":10,"description":"Foot"},{"title":"SCAPULA","const":11,"description":"Scapula"}]},"Position":{"type":"integer","description":"Position indicator","oneOf":[{"title":"UNKNOWN","const":0,"description":"Unknown position"},{"title":"NEUTRAL","const":10,"description":"Neutral position"},{"title":"CUSTOM","const":20,"description":"Custom position"},{"title":"P30_DEGREES_ABDUCTION","const":100,"description":"30 degrees abduction"},{"title":"P45_DEGREES_ABDUCTION","const":110,"description":"45 degrees abduction"},{"title":"P90_DEGREES_ABDUCTION","const":120,"description":"90 degrees abduction"},{"title":"STANDING_30_DEGREES_ABDUCTION","const":130,"description":"Standing with 30 degrees abduction"},{"title":"P90_DEGREES_SHOULDER_ABDUCTION","const":140,"description":"90 degrees shoulder abduction"},{"title":"SUPINE_90_DEGREES_SHOULDER_ABDUCTION","const":150,"description":"Supine position with 90 degrees shoulder abduction"},{"title":"SEATED_90_DEGREES_SHOULDER_ABDUCTION_LONG_LEVER","const":160,"description":"Seated with 90 degrees shoulder abduction, long lever"},{"title":"SEATED_90_DEGREES_SHOULDER_ABDUCTION_SHORT_LEVER","const":170,"description":"Seated with 90 degrees shoulder abduction, short lever"},{"title":"P90_DEGREES_FLEXION","const":200,"description":"90 degrees flexion"},{"title":"HORIZONTAL_FLEXION","const":210,"description":"Horizontal flexion"},{"title":"P90_DEGREES_ELBOW_FLEXION","const":220,"description":"90 degrees elbow flexion"},{"title":"P90_DEGREES_SHOULDER_FLEXION","const":230,"description":"90 degrees shoulder flexion"},{"title":"SEATED_90_DEGREE_SHOULDER_FLEXION","const":240,"description":"Seated with 90 degrees shoulder flexion"},{"title":"STANDING_90_DEGREE_SHOULDER_FLEXION","const":250,"description":"Standing with 90 degrees shoulder flexion"},{"title":"SEATED","const":300,"description":"Seated position"},{"title":"SEATED_ELBOW_90_DEGREES","const":310,"description":"Seated with elbow at 90 degrees"},{"title":"SEATED_ELBOW_90_DEGREES_90_DEGREE_SHOULDER_ABDUCTION","const":320,"description":"Seated with elbow and shoulder at 90 degrees abduction"},{"title":"SEATED_SHORT_LEVER","const":330,"description":"Seated with short lever"},{"title":"SEATED_LONG_LEVER","const":340,"description":"Seated with long lever"},{"title":"SEATED_45_DEGREES","const":350,"description":"Seated at 45 degrees"},{"title":"SEATED_90_DEGREES","const":360,"description":"Seated at 90 degrees"},{"title":"SEATED_10_DEGREES","const":370,"description":"Seated at 10 degrees"},{"title":"STANDING","const":400,"description":"Standing position"},{"title":"STANDING_ELBOW_90_DEGREES","const":410,"description":"Standing with elbow at 90 degrees"},{"title":"STANDING_ELBOW_90_DEGREES_90_DEGREE_SHOULDER_ABDUCTION","const":420,"description":"Standing with elbow and shoulder at 90 degrees abduction"},{"title":"STANDING_LONG_LEVER","const":430,"description":"Standing with long lever"},{"title":"STANDING_SHORT_LEVER","const":440,"description":"Standing with short lever"},{"title":"KNEE_60_DEGREES","const":450,"description":"Knee at 60 degrees"},{"title":"KICKER","const":460,"description":"Kicker position"},{"title":"LONG_SITTING_PLANTAR_FLEXED","const":500,"description":"Long sitting with plantar flexed"},{"title":"LONG_SITTING_PLANTIGRADE","const":510,"description":"Long sitting with plantigrade"},{"title":"LONG_SITTING","const":520,"description":"Long sitting position"},{"title":"SIDE_LYING","const":600,"description":"Side lying position"},{"title":"SIDE_LYING_LONG_LEVER","const":610,"description":"Side lying with long lever"},{"title":"SIDE_LYING_SHORT_LEVER","const":620,"description":"Side lying with short lever"},{"title":"PRONE","const":700,"description":"Prone position"},{"title":"MID_PRONE","const":710,"description":"Mid-prone position"},{"title":"PRONE_LONG_LEVER","const":720,"description":"Prone with long lever"},{"title":"PRONE_90_DEGREE_KNEE_FLEXION","const":730,"description":"Prone with 90 degrees knee flexion"},{"title":"PRONE_SHORT_LEVER","const":740,"description":"Prone with short lever"},{"title":"SEMI_PRONE","const":750,"description":"Semi-prone position"},{"title":"SUPINE","const":800,"description":"Supine position"},{"title":"SUPINE_90_DEGREES_HIP_FLEXION","const":810,"description":"Supine with 90 degrees hip flexion"},{"title":"SUPINE_ELBOW_90_DEGREES_90_DEGREE_SHOULDER_ABDUCTION","const":820,"description":"Supine with elbow and shoulder at 90 degrees abduction"},{"title":"SUPINE_ELBOW_90_DEGREES","const":830,"description":"Supine with elbow at 90 degrees"},{"title":"SUPINE_ELBOW_90_DEGREES_120_SHOULDER_ABDUCTION","const":840,"description":"Supine with elbow at 90 degrees and shoulder at 120 degrees abduction"},{"title":"SUPINE_LONG_LEVER","const":850,"description":"Supine with long lever"},{"title":"SUPINE_SHORT_LEVER","const":860,"description":"Supine with short lever"},{"title":"SUPINE_KNEES_45_DEGREES","const":870,"description":"Supine with knees at 45 degrees"},{"title":"SUPINE_KNEES_90_DEGREES","const":880,"description":"Supine with knees at 90 degrees"},{"title":"SUPINE_45_DEGREES","const":890,"description":"Supine at 45 degrees"},{"title":"SUPINE_10_DEGREES","const":900,"description":"Supine at 10 degrees"},{"title":"SUPINE_90_DEGREES","const":910,"description":"Supine at 90 degrees"},{"title":"P45_DEGREES","const":1000,"description":"45 degrees position"},{"title":"P60_DEGREES","const":1005,"description":"60 degrees position"},{"title":"P90_DEGREES","const":1010,"description":"90 degrees position"},{"title":"ELBOW_EXTENDED","const":1020,"description":"Elbow extended"},{"title":"PRONATED","const":1030,"description":"Pronated position"},{"title":"SUPINATED","const":1040,"description":"Supinated position"},{"title":"KNEE_0_DEGREES","const":1050,"description":"Knee at 0 degrees"},{"title":"KNEE_45_DEGREES","const":1060,"description":"Knee at 45 degrees"},{"title":"KNEE_90_DEGREES","const":1070,"description":"Knee at 90 degrees"},{"title":"KNEE_30_DEGREES","const":1080,"description":"Knee at 30 degrees"},{"title":"ISOMETRIC_MID_THIGH_PULL","const":1090,"description":"Isometric mid-thigh pull position"},{"title":"P90_DEGREE_ELBOW_FLEXION_WRIST_NEUTRAL","const":1100,"description":"90 degrees elbow flexion with wrist neutral"},{"title":"P90_DEGREE_ELBOW_FLEXION_WRIST_SUPINATED","const":1110,"description":"90 degrees elbow flexion with wrist supinated"},{"title":"P90_DEGREE_ELBOW_FLEXION_WRIST_PRONATED","const":1120,"description":"90 degrees elbow flexion with wrist pronated"},{"title":"P90_DEGREE_ELBOW_FLEXION_90_ABDUCTION_WRIST_NEUTRAL","const":1130,"description":"90 degrees elbow flexion, 90 degrees abduction, wrist neutral"},{"title":"P90_DEGREE_ELBOW_FLEXION_90_ABDUCTION_WRIST_SUPINATED","const":1140,"description":"90 degrees elbow flexion, 90 degrees abduction, wrist supinated"},{"title":"P90_DEGREE_ELBOW_FLEXION_90_ABDUCTION_WRIST_PRONATED","const":1150,"description":"90 degrees elbow flexion, 90 degrees abduction, wrist pronated"},{"title":"P90_DEGREES_ELBOW_FLEXION_WRIST_NEUTRAL","const":1160,"description":"90 degrees elbow flexion with wrist neutral"},{"title":"P90_DEGREES_ELBOW_FLEXION_WRIST_SUPINATED","const":1170,"description":"90 degrees elbow flexion with wrist supinated"},{"title":"P90_DEGREES_ELBOW_FLEXION_WRIST_PRONATED","const":1180,"description":"90 degrees elbow flexion with wrist pronated"},{"title":"QUADRUPED","const":1190,"description":"Quadruped position"}]},"TestResultMetric":{"type":"object","properties":{"side":{"$ref":"#/components/schemas/Side","description":"Side indicator"},"aspect":{"$ref":"#/components/schemas/Aspect","description":"Aspect indicator"},"statistic_type":{"$ref":"#/components/schemas/StatisticType","description":"Type of statistic"},"metric_type":{"$ref":"#/components/schemas/MetricType"},"contraction_type":{"$ref":"#/components/schemas/ContractionType","description":"Type of muscle contraction"},"value":{"type":["number","null"],"description":"Value of the metric"}}},"Side":{"type":"integer","description":"Side indicator","oneOf":[{"title":"NA","const":0,"description":"Not applicable"},{"title":"LEFT","const":1,"description":"Left side"},{"title":"RIGHT","const":2,"description":"Right side"},{"title":"LEFT_THEN_RIGHT","const":3,"description":"Left side followed by right side"},{"title":"RIGHT_THEN_LEFT","const":4,"description":"Right side followed by left side"},{"title":"BOTH","const":5,"description":"Both sides simultaneously"},{"title":"ASYMMETRY_PERCENTAGE","const":6,"description":"Asymmetry percentage between sides"}]},"Aspect":{"type":"integer","description":"Aspect indicator","oneOf":[{"title":"NA","const":-1,"description":"Not applicable"},{"title":"INNER","const":10,"description":"Inner aspect"},{"title":"OUTER","const":20,"description":"Outer aspect"},{"title":"VERTICAL","const":30,"description":"Vertical aspect"},{"title":"HORIZONTAL","const":40,"description":"Horizontal aspect"},{"title":"MEDIAL","const":50,"description":"Medial aspect"},{"title":"LATERAL","const":60,"description":"Lateral aspect"},{"title":"ANTERIOR","const":70,"description":"Anterior aspect"},{"title":"POSTERIOR","const":80,"description":"Posterior aspect"},{"title":"TAKEOFF","const":90,"description":"Takeoff phase"},{"title":"LANDING","const":100,"description":"Landing phase"}]},"StatisticType":{"type":"integer","description":"Type of statistic","oneOf":[{"title":"NA","const":-1,"description":"Not applicable"},{"title":"AVG","const":1,"description":"Average value"},{"title":"MIN","const":2,"description":"Minimum value"},{"title":"MAX","const":3,"description":"Maximum value"},{"title":"TOTAL","const":4,"description":"Total value"},{"title":"INSTANTANEOUS","const":5,"description":"Instantaneous value"}]},"MetricType":{"type":"integer","description":"Type of metric","oneOf":[{"title":"BODY_MASS","const":1,"description":"Body mass"},{"title":"FORCE","const":2,"description":"Force"},{"title":"ACCELERATION","const":3,"description":"Acceleration"},{"title":"IMPULSE","const":4,"description":"Impulse"},{"title":"BRAKING_IMPULSE","const":5,"description":"Braking impulse"},{"title":"VELOCITY","const":6,"description":"Velocity"},{"title":"POWER","const":7,"description":"Power"},{"title":"REPETITIONS","const":8,"description":"Repetitions"},{"title":"TORQUE","const":9,"description":"Torque"},{"title":"CALIBRATION","const":10,"description":"Calibration"},{"title":"ROM_DEGREES","const":11,"description":"Range of motion in degrees"},{"title":"TIME_TO_PEAK_FORCE","const":12,"description":"Time to peak force"},{"title":"TIME_TO_PEAK_POWER","const":13,"description":"Time to peak power"},{"title":"TIME_TO_PEAK_VELOCITY","const":14,"description":"Time to peak velocity"},{"title":"RATE_OF_FORCE_DEVELOPMENT","const":15,"description":"Rate of force development"},{"title":"HEIGHT","const":16,"description":"Height"},{"title":"DIP","const":17,"description":"Dip"},{"title":"WATTS_PER_KG","const":18,"description":"Watts per kilogram"},{"title":"WORK","const":19,"description":"Work"},{"title":"CONTACT_TIME","const":20,"description":"Contact time"},{"title":"FLIGHT_TIME","const":21,"description":"Flight time"},{"title":"ROM_DISTANCE","const":22,"description":"Range of motion distance"},{"title":"HORIZONTAL_DISTANCE","const":23,"description":"Horizontal distance"},{"title":"LIFT_DISTANCE","const":24,"description":"Lift distance"},{"title":"MAX_BACK","const":25,"description":"Maximum back movement"},{"title":"MAX_FORWARD","const":26,"description":"Maximum forward movement"},{"title":"DURATION","const":27,"description":"Duration"},{"title":"REP_RATE","const":28,"description":"Repetition rate"},{"title":"TOTAL_TRAVEL_PATH","const":29,"description":"Total travel path"},{"title":"VERTICAL_DISTANCE","const":30,"description":"Vertical distance"},{"title":"REACTIVE_STRENGTH_INDEX","const":31,"description":"Reactive strength index"},{"title":"REPETITION_RATE","const":32,"description":"Repetition rate"},{"title":"JUMP_HEIGHT","const":33,"description":"Jump height"}]},"ContractionType":{"type":"integer","description":"Type of muscle contraction","oneOf":[{"title":"UNKNOWN","const":-1,"description":"Unknown contraction type"},{"title":"NA","const":0,"description":"Not applicable"},{"title":"ECCENTRIC","const":1,"description":"Eccentric contraction"},{"title":"CONCENTRIC","const":2,"description":"Concentric contraction"},{"title":"ISOMETRIC","const":3,"description":"Isometric contraction"},{"title":"ISOINERTIAL","const":4,"description":"Isoinertial contraction"},{"title":"ISOKINETIC","const":5,"description":"Isokinetic contraction"},{"title":"ISOTONIC","const":6,"description":"Isotonic contraction"}]},"Set":{"type":"object","properties":{"metrics":{"type":"array","items":{"$ref":"#/components/schemas/TestResultMetric"}},"timestamp_us":{"type":["integer","null"],"description":"Timestamp of the set in microseconds"},"duration_us":{"type":["integer","null"],"description":"Duration of the set in microseconds"},"side":{"$ref":"#/components/schemas/Side","default":0},"aspect":{"$ref":"#/components/schemas/Aspect","default":-1},"reps":{"type":"array","items":{"$ref":"#/components/schemas/Rep"}},"weight":{"type":["number","null"],"description":"Weight used for the exercise"},"exercise_name":{"type":["string","null"],"description":"Name of the exercise"},"variations":{"type":"array","items":{"$ref":"#/components/schemas/Variation"}},"movement":{"$ref":"#/components/schemas/BiomechanicalMovement","default":-1}}},"Rep":{"type":"object","properties":{"offset_us":{"type":"integer","description":"Offset from start of test in microseconds"},"duration_us":{"type":"number","description":"Duration of the rep in microseconds"},"metrics":{"type":"array","description":"List of metrics for the rep","items":{"$ref":"#/components/schemas/TestResultMetric"}}}},"Variation":{"type":"integer","description":"Exercise variation","oneOf":[{"title":"BARBELL","const":10,"description":"Using a barbell"},{"title":"DUMBBELL","const":20,"description":"Using dumbbells"},{"title":"BAND","const":30,"description":"Using resistance bands"},{"title":"CHAIN","const":40,"description":"Using chains"},{"title":"LOG_BAR","const":50,"description":"Using a log bar"},{"title":"KADILLAC_BAR","const":60,"description":"Using a Kadillac bar"},{"title":"SWISS_BAR","const":70,"description":"Using a Swiss bar"},{"title":"SMITH_MACHINE","const":80,"description":"Using a Smith machine"},{"title":"TRAP_BAR","const":90,"description":"Using a trap bar"},{"title":"KETTLE_BELL","const":100,"description":"Using kettlebells"},{"title":"CAMBER_BAR","const":110,"description":"Using a camber bar"},{"title":"DUFFALO_BAR","const":120,"description":"Using a Duffalo bar"},{"title":"SSB","const":130,"description":"Using a safety squat bar"},{"title":"KEISER","const":140,"description":"Using Keiser equipment"},{"title":"SORINEX","const":150,"description":"Using Sorinex equipment"},{"title":"INCLINE","const":160,"description":"Incline variation"},{"title":"INCLINE_30_DEGREES","const":170,"description":"Incline at 30 degrees"},{"title":"INCLINE_45_DEGREES","const":180,"description":"Incline at 45 degrees"},{"title":"INCLINE_60_DEGREES","const":190,"description":"Incline at 60 degrees"},{"title":"DECLINE","const":200,"description":"Decline variation"},{"title":"CLOSE_GRIP","const":210,"description":"Close grip"},{"title":"WIDE_GRIP","const":220,"description":"Wide grip"},{"title":"NEUTRAL_GRIP","const":230,"description":"Neutral grip"},{"title":"OVERHAND_GRIP","const":240,"description":"Overhand (pronated) grip"},{"title":"UNDERHAND_GRIP","const":250,"description":"Underhand (supinated) grip"},{"title":"SNATCH_GRIP","const":260,"description":"Snatch grip"},{"title":"ALTERNATING_GRIP","const":270,"description":"Alternating grip"},{"title":"PARALLEL_GRIP","const":280,"description":"Parallel grip"},{"title":"HOOK_GRIP","const":290,"description":"Hook grip"},{"title":"HIGH_BAR","const":300,"description":"High bar position"},{"title":"LOW_BAR","const":310,"description":"Low bar position"},{"title":"OVERHEAD","const":320,"description":"Overhead position"},{"title":"BEHIND_NECK","const":330,"description":"Behind the neck position"},{"title":"FRONT","const":340,"description":"Front position"},{"title":"BEHIND","const":350,"description":"Behind position"},{"title":"SEATED","const":360,"description":"Seated variation"},{"title":"STANDING","const":370,"description":"Standing variation"},{"title":"HANG","const":380,"description":"Hang position"},{"title":"HIGH_PULL","const":390,"description":"High pull"},{"title":"SPLIT","const":400,"description":"Split stance"},{"title":"BLOCK","const":410,"description":"Using blocks"},{"title":"BLOCK_7_5_CM","const":420,"description":"Block height 7.5 cm"},{"title":"BLOCK_15_CM","const":430,"description":"Block height 15 cm"},{"title":"BLOCK_22_5_CM","const":440,"description":"Block height 22.5 cm"},{"title":"BLOCK_30_CM","const":450,"description":"Block height 30 cm"},{"title":"BLOCK_35_CM","const":460,"description":"Block height 35 cm"},{"title":"BLOCK_40_CM","const":470,"description":"Block height 40 cm"},{"title":"DEFICIT","const":480,"description":"Deficit variation"},{"title":"MID_THIGH","const":490,"description":"Mid-thigh position"},{"title":"LOW","const":500,"description":"Low position"},{"title":"HIGH","const":510,"description":"High position"},{"title":"BOX","const":520,"description":"Using a box"},{"title":"PIN_LOADED","const":530,"description":"Pin-loaded equipment"},{"title":"PLATE_LOADED","const":540,"description":"Plate-loaded equipment"},{"title":"DYNAMIC","const":550,"description":"Dynamic movement"},{"title":"REVERSE_DYNAMIC","const":560,"description":"Reverse dynamic movement"},{"title":"PAUSE","const":570,"description":"Pause variation"},{"title":"PINS","const":580,"description":"Using pins"},{"title":"REBOUND","const":590,"description":"Rebound variation"},{"title":"RESET","const":600,"description":"Reset between reps"},{"title":"CONCENTRIC","const":610,"description":"Concentric movement"},{"title":"ECCENTRIC","const":620,"description":"Eccentric movement"},{"title":"JUMP","const":630,"description":"Jump variation"},{"title":"SHRUG","const":640,"description":"Shrug variation"},{"title":"RAISE","const":650,"description":"Raise movement"},{"title":"EXTENSION","const":660,"description":"Extension movement"},{"title":"BULGARIAN","const":670,"description":"Bulgarian variation"},{"title":"LEG_EXT","const":680,"description":"Leg extension"},{"title":"HIP_EXT","const":690,"description":"Hip extension"},{"title":"PENDLAY","const":700,"description":"Pendlay variation"},{"title":"FORWARD","const":710,"description":"Forward movement"},{"title":"LATERAL","const":720,"description":"Lateral movement"},{"title":"STIFF_LEG","const":730,"description":"Stiff leg variation"},{"title":"ROMANIAN","const":740,"description":"Romanian variation"},{"title":"HACK","const":750,"description":"Hack variation"},{"title":"GOOD_MORNING","const":760,"description":"Good morning variation"},{"title":"AB","const":770,"description":"Abdominal focus"},{"title":"DOMINATOR","const":780,"description":"Dominator variation"},{"title":"SKATER","const":790,"description":"Skater variation"},{"title":"LANDMINE","const":800,"description":"Landmine variation"},{"title":"RACK_PULL","const":810,"description":"Rack pull"},{"title":"SISSY","const":820,"description":"Sissy squat"},{"title":"SHUTTLE_PRESS","const":830,"description":"Shuttle press"},{"title":"POGO","const":840,"description":"Pogo variation"},{"title":"SPEED","const":850,"description":"Speed focus"},{"title":"THRUSTER","const":860,"description":"Thruster variation"},{"title":"TWISTS","const":870,"description":"Twisting movement"},{"title":"WOODCHOP","const":880,"description":"Woodchop movement"},{"title":"HAND_SUPPORTED","const":890,"description":"Hand-supported variation"},{"title":"SPLIT_STANCE","const":900,"description":"Split stance"},{"title":"BOSCH","const":910,"description":"Bosch variation"},{"title":"ALTERNATE","const":920,"description":"Alternate movement"},{"title":"COUNT_MOVEMENT","const":930,"description":"Count movement"},{"title":"SCRUM_SLED","const":940,"description":"Using scrum sled"},{"title":"WEIGHTLIFTING_SHOES","const":950,"description":"Using weightlifting shoes"}]},"DataSentToDestination":{"type":"object","description":"Returned when `to_destination=true`. Confirms that data retrieval has been queued and will be delivered to your webhook.","properties":{"coach":{"$ref":"#/components/schemas/Coach"},"reference":{"type":"string","format":"uuid","description":"Unique reference ID for this dispatch. Can be used to correlate the subsequent webhook delivery."},"message":{"type":"string","description":"Human-readable confirmation message."},"type":{"type":"string","description":"The type of data being dispatched.","enum":["test.dispatched","activity.dispatched","activity.metric.dispatched"]}}},"UnauthorizedProblem":{"type":"object","description":"A refused credential, always with its code.","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance","code"]},"ErrorMessage":{"type":"object","description":"The error body teams operations return.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]},"Problem":{"type":"object","description":"An error response, following RFC 9457 (Problem Details for HTTP APIs, which obsoletes RFC 7807). Returned with `Content-Type: application/problem+json` on every 4xx/5xx response. The HTTP status line carries the status code; it is intentionally not repeated in the body. `type`, `title` and `instance` are always present; `detail` is included when a specific explanation is available.\n","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type. Defaults to `about:blank`."},"title":{"type":"string","description":"A short, human-readable summary of the problem type (the lowercased HTTP status text)."},"instance":{"type":"string","description":"The request path, including any query string, that produced this problem."},"code":{"type":"string","description":"Stable error classification: branch on this, not on `detail`. A refused credential returns unauthorized (401: missing, invalid, expired or revoked), scope_missing (403: the credential lacks the scope the operation requires) or audience_restricted (403: the credential is not granted for this dev-id). authorization_unavailable (503) means the credential or the product access could not be checked; retry later. Product gates return entitlement_required (403) or environment_disabled (403). service_unavailable (503) means the request never reached the service; dependency_failed (502 or 504) means the service did not complete it, though it may already have acted on it. Report uploads return validation_failed, unsupported_file_type or too_many_files (400), payload_too_large (413) and rate_limited (429)."},"product":{"type":"string","description":"The product checked by the authorization gate, when classified."},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem."}},"required":["type","title","instance"]}},"responses":{"Unauthorized":{"description":"The credential is missing, invalid, expired or revoked (code `unauthorized`).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/UnauthorizedProblem"}}}},"AuthorizationUnavailable":{"description":"The credential or the product access could not be checked (code `authorization_unavailable`). Retry after the service recovers.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"paths":{"/coaches/{coachId}/tests/search":{"post":{"operationId":"searchTestsForCoach","summary":"Search and filter tests for a specific coach","description":"Returns a coach and their athletes' tests between `start_time` and `end_time`, optionally only for the athletes listed in `athlete_ids`.\n\n- Not available yet: a valid request currently returns `500`.","parameters":[{"name":"coachId","in":"path","required":true,"schema":{"type":"string"},"description":"The coach's `coach_id`."},{"name":"to_destination","in":"query","required":false,"description":"Not implemented yet. Whether to send the data to your webhook instead of returning it. When `true`, the response is `202` with a `reference` ID that identifies the later webhook delivery. Defaults to `false`, which returns the data in the response body.","schema":{"type":"string","enum":["true","false"],"default":"false"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestSearchQuery"}}}},"responses":{"200":{"description":"Filtered list of tests matching the query.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/CoachDataReturned"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Test"}}}}]}}}},"202":{"description":"Data dispatch accepted. Returned when `to_destination=true`. Data will be sent to your configured webhook.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSentToDestination"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"Coach not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"500":{"description":"Returned for every request that passes validation, because provider data is not available yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}},"503":{"$ref":"#/components/responses/AuthorizationUnavailable"}},"tags":["Coaches"]}}}}
```
