API Endpoints

Authentication

Integrations

Get detailed information about available integrations

get

Returns detailed information about available providers, including required login fields and logos.

Responses

200

Integrations retrieved successfully.

application/json

get

/integrations/detailed

HTTPcURLJavaScriptPython

GET /v2/teams/integrations/detailed HTTP/1.1
Host: api.tryterra.co
Accept: */*

200

Integrations retrieved successfully.

{
  "providers": [
    {
      "provider": "text",
      "name": "text",
      "icon": "text",
      "types": {
        "tests": true,
        "activities": true
      },
      "login_fields": [
        {
          "field": "text",
          "name": "text",
          "type": "text",
          "required": true,
          "options": [
            "text"
          ]
        }
      ]
    }
  ]
}

Coach management

List all coaches

get

Authorizations

apiKeyAuth & devIdAuth

x-api-keystringRequired

dev-idstringRequired

Responses

200

A list of coaches

application/json

get

/coaches

HTTPcURLJavaScriptPython

GET /v2/teams/coaches HTTP/1.1
Host: api.tryterra.co
x-api-key: YOUR_API_KEY
dev-id: YOUR_API_KEY
Accept: */*

200

A list of coaches

{
  "data": [
    {
      "coach_id": "text",
      "external_coach_id": "text",
      "reference_id": "text",
      "region": "text",
      "provider": "text",
      "created_at": "2026-02-28T17:27:51.154Z"
    }
  ]
}

Create a new coach

post

Registers a new coach with credentials and integration specifics.

Authorizations

apiKeyAuth & devIdAuth

x-api-keystringRequired

dev-idstringRequired

Body

application/json

coach_idstringRead-onlyOptional

Unique identifier for the coach, generated by the server.

external_coach_idstringRead-onlyOptional

Identifier of the coach on the provider's systems

reference_idstringOptional

ID of the coach on your system

regionstringOptional

Region in which the coach operates.

providerstringOptional

Integration provider associated with the coach (e.g., VALD, Catapult).

created_atstring · date-timeOptional

The date and time when the coach was registered.

client_idstringWrite-onlyOptional

Public identifier for the coach.

client_secretstringWrite-onlyOptional

Secret key or token for authentication.

tokenstringWrite-onlyOptional

API key or token for the coach object

Responses

201

Coach created successfully

application/json

400

Invalid input, object invalid

409

The coach already exists for your dev-id

post

/coaches

HTTPcURLJavaScriptPython

POST /v2/teams/coaches HTTP/1.1
Host: api.tryterra.co
x-api-key: YOUR_API_KEY
dev-id: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 154

{
  "reference_id": "text",
  "region": "text",
  "provider": "text",
  "created_at": "2026-02-28T17:27:51.154Z",
  "client_id": "text",
  "client_secret": "text",
  "token": "text"
}

{
  "coach_id": "text",
  "external_coach_id": "text",
  "reference_id": "text",
  "region": "text",
  "provider": "text",
  "created_at": "2026-02-28T17:27:51.154Z"
}

Delete a coach

delete

Deletes a coach and all associated athletes, activities, and tests.

Authorizations

apiKeyAuth & devIdAuth

x-api-keystringRequired

dev-idstringRequired

Path parameters

coachIdstringRequired

Unique identifier of the coach to be deleted.

Responses

204

Coach deleted successfully.

404

Coach not found.

application/json

delete

/coaches/{coachId}

HTTPcURLJavaScriptPython

DELETE /v2/teams/coaches/{coachId} HTTP/1.1
Host: api.tryterra.co
x-api-key: YOUR_API_KEY
dev-id: YOUR_API_KEY
Accept: */*

No content

Coach Data retrieval

Retrieve all athletes under a specific coach

get

Authorizations

apiKeyAuth & devIdAuth

x-api-keystringRequired

dev-idstringRequired

Path parameters

coachIdstringRequired

Responses

200

An array of athletes coached by the specified coach

application/json

get

/coaches/{coachId}/athletes

HTTPcURLJavaScriptPython

GET /v2/teams/coaches/{coachId}/athletes HTTP/1.1
Host: api.tryterra.co
x-api-key: YOUR_API_KEY
dev-id: YOUR_API_KEY
Accept: */*

200

An array of athletes coached by the specified coach

{
  "coach": {
    "coach_id": "text",
    "external_coach_id": "text",
    "reference_id": "text",
    "region": "text",
    "provider": "text",
    "created_at": "2026-02-28T17:27:51.154Z"
  },
  "data": [
    {
      "coach_id": "text",
      "athlete_id": "text",
      "external_athlete_id": "text",
      "reference_id": "text",
      "provider": "text",
      "first_name": "text",
      "last_name": "text",
      "email": "text",
      "created_at": "2026-02-28T17:27:51.154Z",
      "date_of_birth": "2026-02-28",
      "last_updated_at": "2026-02-28T17:27:51.154Z",
      "active": true
    }
  ]
}

Retrieve all activities recorded by athletes under a specific coach

get

Authorizations

apiKeyAuth & devIdAuth

x-api-keystringRequired

dev-idstringRequired

Path parameters

coachIdstringRequired

Query parameters

start_datestring · dateRequired

Start date for the query range (YYYY-MM-DD).

Example: 2025-01-01

end_datestring · dateOptional

End date for the query range (YYYY-MM-DD). Defaults to start_date + 1 day if omitted.

Example: 2025-01-07

to_destinationstring · enumOptional

When true, data is sent asynchronously to your configured webhook and the endpoint returns HTTP 202 with a reference ID. When false (default), data is returned inline in the response body.

Default: falsePossible values:

Responses

200

List of activities within the specified time range for all athletes under the coach

application/json

202

Data dispatch accepted. Returned when to_destination=true. Data will be sent to your configured webhook.

application/json

get

/coaches/{coachId}/activities

HTTPcURLJavaScriptPython

GET /v2/teams/coaches/{coachId}/activities?start_date=2025-01-01 HTTP/1.1
Host: api.tryterra.co
x-api-key: YOUR_API_KEY
dev-id: YOUR_API_KEY
Accept: */*

{
  "coach": {
    "coach_id": "text",
    "external_coach_id": "text",
    "reference_id": "text",
    "region": "text",
    "provider": "text",
    "created_at": "2026-02-28T17:27:51.154Z"
  },
  "data": [
    {
      "activity_id": "text",
      "start_timestamp_us": 1,
      "end_timestamp_us": 1,
      "description": "text",
      "teams": [
        {
          "name": "text",
          "is_home": 1
        }
      ],
      "athletes": [
        {
          "coach_id": "text",
          "athlete_id": "text",
          "external_athlete_id": "text",
          "reference_id": "text",
          "provider": "text",
          "first_name": "text",
          "last_name": "text",
          "email": "text",
          "created_at": "2026-02-28T17:27:51.154Z",
          "date_of_birth": "2026-02-28",
          "last_updated_at": "2026-02-28T17:27:51.154Z",
          "active": true
        }
      ],
      "athlete_participation": {
        "full": [
          "text"
        ],
        "partial": [
          "text"
        ],
        "unknown": [
          "text"
        ]
      },
      "tz_offset_seconds": 0,
      "periods": [
        {
          "period_id": "text",
          "name": "text",
          "athlete_participation": {
            "full": [
              "text"
            ],
            "partial": [
              "text"
            ],
            "unknown": [
              "text"
            ]
          },
          "detailed_athlete_participation": [
            {
              "athlete_id": "text",
              "external_athlete_id": "text",
              "is_home_team": 1,
              "participation": 1,
              "function": "text"
            }
          ],
          "start_timestamp_us": 1,
          "end_timestamp_us": 1,
          "athlete_metrics": [
            {
              "athlete_id": "text",
              "metrics": [
                {
                  "name": "text",
                  "value": 1,
                  "unit": "text"
                }
              ]
            }
          ]
        }
      ],
      "activity_metrics": [
        {
          "name": "text",
          "value": 1,
          "unit": "text"
        }
      ],
      "athlete_metrics": {
        "ANY_ADDITIONAL_PROPERTY": [
          {
            "name": "text",
            "value": 1,
            "unit": "text"
          }
        ]
      },
      "events": [
        "text"
      ]
    }
  ]
}

Retrieve activity metrics schema for a coach

get

Returns the schema of activity metrics available for the specified coach.

Authorizations

apiKeyAuth & devIdAuth

x-api-keystringRequired

dev-idstringRequired

Path parameters

coachIdstringRequired

Unique identifier of the coach.

Query parameters

to_destinationstring · enumOptional

When true, data is sent asynchronously to your configured webhook and the endpoint returns HTTP 202 with a reference ID. When false (default), data is returned inline in the response body.

Default: falsePossible values:

Responses

200

Schema retrieved successfully.

application/json

202

Data dispatch accepted. Returned when to_destination=true. Data will be sent to your configured webhook.

application/json

404

Coach not found.

application/json

get

/coaches/{coachId}/activities/metrics/schema

HTTPcURLJavaScriptPython

GET /v2/teams/coaches/{coachId}/activities/metrics/schema HTTP/1.1
Host: api.tryterra.co
x-api-key: YOUR_API_KEY
dev-id: YOUR_API_KEY
Accept: */*

{
  "coach": {
    "coach_id": "text",
    "external_coach_id": "text",
    "reference_id": "text",
    "region": "text",
    "provider": "text",
    "created_at": "2026-02-28T17:27:51.154Z"
  },
  "data": [
    {
      "key": "text",
      "display_name": "text",
      "unit": "text",
      "type": "text",
      "sport": 1
    }
  ]
}

Retrieve all tests conducted by athletes under a specific coach

get

Authorizations

apiKeyAuth & devIdAuth

x-api-keystringRequired

dev-idstringRequired

Path parameters

coachIdstringRequired

Query parameters

start_datestring · dateRequired

Start date for the query range (YYYY-MM-DD).

Example: 2025-01-01

end_datestring · dateOptional

End date for the query range (YYYY-MM-DD). Defaults to start_date + 1 day if omitted.

Example: 2025-01-07

to_destinationstring · enumOptional

When true, data is sent asynchronously to your configured webhook and the endpoint returns HTTP 202 with a reference ID. When false (default), data is returned inline in the response body.

Default: falsePossible values:

Responses

200

List of tests within the specified time range for all athletes under the coach

application/json

202

Data dispatch accepted. Returned when to_destination=true. Data will be sent to your configured webhook.

application/json

get

/coaches/{coachId}/tests

HTTPcURLJavaScriptPython

GET /v2/teams/coaches/{coachId}/tests?start_date=2025-01-01 HTTP/1.1
Host: api.tryterra.co
x-api-key: YOUR_API_KEY
dev-id: YOUR_API_KEY
Accept: */*

{
  "coach": {
    "coach_id": "text",
    "external_coach_id": "text",
    "reference_id": "text",
    "region": "text",
    "provider": "text",
    "created_at": "2026-02-28T17:27:51.154Z"
  },
  "data": [
    {
      "test_id": "text",
      "display_name": "text",
      "timestamp_us": 1,
      "test_type": 1,
      "exercise_type": 1,
      "athlete_weight": 1,
      "movement": 1,
      "tz_offset_seconds": 0,
      "category": 1,
      "duration_us": 1,
      "body_region": 1,
      "position": 1,
      "notes": "text",
      "device": "text",
      "test_result_metrics": [
        {
          "side": 1,
          "aspect": 1,
          "statistic_type": 1,
          "metric_type": 1,
          "contraction_type": 1,
          "value": 1
        }
      ],
      "sets": [
        {
          "metrics": [
            {
              "side": 1,
              "aspect": 1,
              "statistic_type": 1,
              "metric_type": 1,
              "contraction_type": 1,
              "value": 1
            }
          ],
          "timestamp_us": 1,
          "duration_us": 1,
          "side": 0,
          "aspect": -1,
          "reps": [
            {
              "offset_us": 1,
              "duration_us": 1,
              "metrics": [
                {
                  "side": 1,
                  "aspect": 1,
                  "statistic_type": 1,
                  "metric_type": 1,
                  "contraction_type": 1,
                  "value": 1
                }
              ]
            }
          ],
          "weight": 1,
          "exercise_name": "text",
          "variations": [
            null
          ],
          "movement": -1
        }
      ]
    }
  ]
}

Athlete Management

List all athletes

get

Authorizations

apiKeyAuth & devIdAuth

x-api-keystringRequired

dev-idstringRequired

Responses

200

An array of athletes

application/json

get

/athletes

HTTPcURLJavaScriptPython

GET /v2/teams/athletes HTTP/1.1
Host: api.tryterra.co
x-api-key: YOUR_API_KEY
dev-id: YOUR_API_KEY
Accept: */*

200

An array of athletes

{
  "data": [
    {
      "coach_id": "text",
      "athlete_id": "text",
      "external_athlete_id": "text",
      "reference_id": "text",
      "provider": "text",
      "first_name": "text",
      "last_name": "text",
      "email": "text",
      "created_at": "2026-02-28T17:27:51.154Z",
      "date_of_birth": "2026-02-28",
      "last_updated_at": "2026-02-28T17:27:51.154Z",
      "active": true
    }
  ]
}

Update an athlete's information

patch

Authorizations

apiKeyAuth & devIdAuth

x-api-keystringRequired

dev-idstringRequired

Path parameters

athleteIdstringRequired

Body

application/json

coach_idstringRead-onlyOptional

The ID of the coach to which the athlete belongs

athlete_idstringRead-onlyOptional

Unique identifier for the athlete, generated by the server.

external_athlete_idstringRead-onlyOptional

Unique identifier for the athlete on the provider's system, generated by the provider (e.g. VALD, Catapult)

reference_idstringOptional

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.

providerstringRead-onlyOptional

Integration provider associated with the Athlete (e.g., VALD, Catapult).

first_namestringOptional

Athlete's first name.

last_namestringOptional

Athlete's last name

emailstringOptional

Athlete's email

created_atstring · date-timeRead-onlyOptional

The date and time when the athlete was registered.

date_of_birthstring · dateOptional

The date of birth of the athlete

last_updated_atstring · date-timeRead-onlyOptional

The date and time when the athlete was last updated (e.g. updated their first and last name).

activebooleanOptional

Determines whether or not Terra will send webhooks for the given athlete

Responses

200

Athlete updated

No content

patch

/athletes/{athleteId}

HTTPcURLJavaScriptPython

PATCH /v2/teams/athletes/{athleteId} HTTP/1.1
Host: api.tryterra.co
x-api-key: YOUR_API_KEY
dev-id: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 120

{
  "reference_id": "text",
  "first_name": "text",
  "last_name": "text",
  "email": "text",
  "date_of_birth": "2026-02-28",
  "active": true
}

200

Athlete updated

No content

Bulk update multiple athletes

patch

Allows a developer to partially update multiple athlete records in a single request.

Authorizations

apiKeyAuth & devIdAuth

x-api-keystringRequired

dev-idstringRequired

Header parameters

dev-idstringRequired

Your developer ID

Example: testingTerra

x-api-keystringRequired

Your API key

Example: OtHJok60oQmT8zhnUWc4SWBJI7ztPTs88C0gOsJJ

Body

application/json

Responses

200

All athlete updates were successful.

application/json

207

Partial success, some athletes updated while others failed.

application/json

400

Bad Request. Invalid input or all updates failed due to validation errors.

application/json

403

Unauthorized. Invalid credentials provided.

application/json

patch

/athletes

HTTPcURLJavaScriptPython

PATCH /v2/teams/athletes HTTP/1.1
Host: api.tryterra.co
x-api-key: text
dev-id: text
Content-Type: application/json
Accept: */*
Content-Length: 68

{
  "data": [
    {
      "athlete_id": "text",
      "active": true,
      "reference_id": "text"
    }
  ]
}

{
  "data": [
    {
      "coach_id": "text",
      "athlete_id": "text",
      "external_athlete_id": "text",
      "reference_id": "text",
      "provider": "text",
      "first_name": "text",
      "last_name": "text",
      "email": "text",
      "created_at": "2026-02-28T17:27:51.154Z",
      "date_of_birth": "2026-02-28",
      "last_updated_at": "2026-02-28T17:27:51.154Z",
      "active": true
    }
  ],
  "errors": [
    {
      "athlete_id": "text",
      "error": "text"
    }
  ]
}

Retrieve a specific athlete by their ID

get

Authorizations

apiKeyAuth & devIdAuth

x-api-keystringRequired

dev-idstringRequired

Path parameters

athleteIdstringRequired

Responses

200

Detailed information about the athlete

application/json

coach_idstringRead-onlyOptional

The ID of the coach to which the athlete belongs

athlete_idstringRead-onlyOptional

Unique identifier for the athlete, generated by the server.

external_athlete_idstringRead-onlyOptional

Unique identifier for the athlete on the provider's system, generated by the provider (e.g. VALD, Catapult)

reference_idstringOptional

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.

providerstringRead-onlyOptional

Integration provider associated with the Athlete (e.g., VALD, Catapult).

first_namestringOptional

Athlete's first name.

last_namestringOptional

Athlete's last name

emailstringOptional

Athlete's email

created_atstring · date-timeRead-onlyOptional

The date and time when the athlete was registered.

date_of_birthstring · dateOptional

The date of birth of the athlete

last_updated_atstring · date-timeRead-onlyOptional

The date and time when the athlete was last updated (e.g. updated their first and last name).

activebooleanOptional

Determines whether or not Terra will send webhooks for the given athlete

get

/athletes/{athleteId}

HTTPcURLJavaScriptPython

GET /v2/teams/athletes/{athleteId} HTTP/1.1
Host: api.tryterra.co
x-api-key: YOUR_API_KEY
dev-id: YOUR_API_KEY
Accept: */*

200

Detailed information about the athlete

{
  "coach_id": "text",
  "athlete_id": "text",
  "external_athlete_id": "text",
  "reference_id": "text",
  "provider": "text",
  "first_name": "text",
  "last_name": "text",
  "email": "text",
  "created_at": "2026-02-28T17:27:51.154Z",
  "date_of_birth": "2026-02-28",
  "last_updated_at": "2026-02-28T17:27:51.154Z",
  "active": true
}