> 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/models.md).

# Models

## The Problem object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"]}}}}
```

## The ErrorMessage object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"ErrorMessage":{"type":"object","description":"The error body teams operations return.","properties":{"error":{"type":"string","description":"What went wrong."}},"required":["error"]}}}}
```

## The DataSentToDestination object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"]}}},"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."}}}}}}
```

## The TestSearchQuery object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"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"}}}}}}}
```

## The WidgetSessionParams object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"WidgetSessionParams":{"type":"object","properties":{"providers":{"type":"string","description":"Comma separated list of providers to display on the device selection page"},"language":{"type":"string","description":"Display language of the widget"},"reference_id":{"type":"string","description":"Identifier of the end user on your system, such as a user ID or email associated with them"},"auth_success_redirect_url":{"type":"string","description":"URL the user is redirected to upon successful authentication"},"auth_failure_redirect_url":{"type":"string","description":"URL the user is redirected to upon unsuccessful authentication"}}}}}}
```

## The Coach object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"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."}}}}}}
```

## The CoachRecord object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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."}}}}}}
```

## The Athlete object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}}}}}}
```

## The AthleteRecord object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}}}}}}
```

## The Metric object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}}}}}}
```

## The AthleteMetrics object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}}}}}}
```

## The DetailedParticipationStatus object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}}},"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"}]},"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"}]}}}}
```

## The ParticipationStatus object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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":[]}}}}}}
```

## The Period object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}}}},"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":[]}}},"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"}}},"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"}]},"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"}}}}}}
```

## The TeamInfo object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}]}}}}
```

## The TeamActivity object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}}}}}}
```

## The TestResultMetric object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}]}}}}
```

## The Rep object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}}}},"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"}]}}}}
```

## The Set object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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}}},"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"}]},"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"}]},"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"}]}}}}
```

## The Test object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}]}}}}
```

## The CoachRegistered object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"CoachRegistered":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/CoachRecord"},"message":{"type":"string","default":"Coach has successfully registered"},"type":{"type":"string","default":"coach.registered"}}},"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."}}}}}}
```

## The AthletesRegistered object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"AthletesRegistered":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/AthleteRecord"}},"message":{"type":"string","default":"One or more Athletes have been successfully registered"},"type":{"type":"string","default":"athlete.registered"}}},"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"}}}}}}
```

## The ErrorResponse object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"ErrorResponse":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer","format":"int32"},"detail":{"type":"string"},"instance":{"type":["string","null"],"format":"uri"}},"required":["type","title","status","detail"]}}}}
```

## The CoachesReturned object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"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."}}}}}}
```

## The AthletesReturned object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"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"}}}}}}
```

## The CoachDataReturned object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"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."}}}}}}
```

## The MetricSchema object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}]}}}}
```

## The IntegrationsResponse object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"IntegrationsResponse":{"type":"object","properties":{"providers":{"type":"array","items":{"$ref":"#/components/schemas/ProviderDetails"}}}},"ProviderDetails":{"type":"object","properties":{"provider":{"type":"string","description":"Provider identifier (e.g., 'VALD', 'CATAPULT')."},"name":{"type":"string","description":"Display name of the provider."},"icon":{"type":"string","description":"URL to the provider's logo or icon."},"types":{"type":"object","properties":{"tests":{"type":"boolean","description":"Indicates if the provider supports test data."},"activities":{"type":"boolean","description":"Indicates if the provider supports activity data."}}},"login_fields":{"type":"array","items":{"$ref":"#/components/schemas/LoginField"}}}},"LoginField":{"type":"object","properties":{"field":{"type":"string","description":"Field name used in authentication."},"name":{"type":"string","description":"Human-readable name of the field."},"type":{"type":"string","description":"Input type (e.g., 'text', 'password')."},"required":{"type":"boolean","description":"Indicates if the field is required."},"options":{"type":["array","null"],"items":{"type":"string"},"description":"Options for select-type fields."}}}}}}
```

## The ProviderDetails object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"ProviderDetails":{"type":"object","properties":{"provider":{"type":"string","description":"Provider identifier (e.g., 'VALD', 'CATAPULT')."},"name":{"type":"string","description":"Display name of the provider."},"icon":{"type":"string","description":"URL to the provider's logo or icon."},"types":{"type":"object","properties":{"tests":{"type":"boolean","description":"Indicates if the provider supports test data."},"activities":{"type":"boolean","description":"Indicates if the provider supports activity data."}}},"login_fields":{"type":"array","items":{"$ref":"#/components/schemas/LoginField"}}}},"LoginField":{"type":"object","properties":{"field":{"type":"string","description":"Field name used in authentication."},"name":{"type":"string","description":"Human-readable name of the field."},"type":{"type":"string","description":"Input type (e.g., 'text', 'password')."},"required":{"type":"boolean","description":"Indicates if the field is required."},"options":{"type":["array","null"],"items":{"type":"string"},"description":"Options for select-type fields."}}}}}}
```

## The LoginField object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"LoginField":{"type":"object","properties":{"field":{"type":"string","description":"Field name used in authentication."},"name":{"type":"string","description":"Human-readable name of the field."},"type":{"type":"string","description":"Input type (e.g., 'text', 'password')."},"required":{"type":"boolean","description":"Indicates if the field is required."},"options":{"type":["array","null"],"items":{"type":"string"},"description":"Options for select-type fields."}}}}}}
```

## The IsHomeFlag object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}]}}}}
```

## The ParticipationType object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}]}}}}
```

## The Sport object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}]}}}}
```

## The Side object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}]}}}}
```

## The Aspect object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}]}}}}
```

## The Position object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}]}}}}
```

## The StatisticType object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}]}}}}
```

## The TestCategory object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}]}}}}
```

## The BodyRegion object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}]}}}}
```

## The ContractionType object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}]}}}}
```

## The BiomechanicalMovement object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}]}}}}
```

## The ExerciseType object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}]}}}}
```

## The TestType object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}]}}}}
```

## The Variation object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}]}}}}
```

## The MetricType object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"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"}]}}}}
```

## The AthletePartialUpdate object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"AthletePartialUpdate":{"type":"object","properties":{"athlete_id":{"type":"string","description":"Unique identifier of the athlete to update."},"active":{"type":"boolean","description":"Whether the athlete is active."},"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."}},"required":["athlete_id"]}}}}
```

## The BulkPatchResponse object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"BulkPatchResponse":{"type":"object","properties":{"data":{"type":"array","description":"Array of successfully updated athlete objects.","items":{"$ref":"#/components/schemas/Athlete"}},"errors":{"type":"array","description":"Array of errors for failed updates.","items":{"$ref":"#/components/schemas/ErrorItem"}}},"required":["data","errors"]},"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"}}},"ErrorItem":{"type":"object","properties":{"athlete_id":{"type":"string","description":"ID of the athlete for which the error occurred."},"error":{"type":"string","description":"Error message."}}}}}}
```

## The ErrorItem object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"schemas":{"ErrorItem":{"type":"object","properties":{"athlete_id":{"type":"string","description":"ID of the athlete for which the error occurred."},"error":{"type":"string","description":"Error message."}}}}}}
```

## The UnauthorizedProblem object

```json
{"openapi":"3.2.0","info":{"title":"Terra API Team-Based API","version":"2026.11.19"},"components":{"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"]}}}}
```
