# Teams

> **🏎️ Motorsport API Required**
>
> All Teams endpoints require an active Motorsport API subscription (€79/mo, 3,000 API calls/hr).
>
> [View pricing →](https://www.sportmonks.com/formula-one-api/)

A **team** represents a constructor competing in a motorsport championship - for example, Ferrari, McLaren, or Red Bull Racing. In Formula 1, teams are also referred to as constructors, and their championship points are tracked separately from drivers via the Constructors' Championship.

Use the Teams endpoints to retrieve constructor profiles, look up team IDs for use in standings and race results endpoints, filter by country, or list all teams competing in a season.

{% hint style="info" %}
Use the `seasonDetails` include to enrich team responses with per-season information such as car details, team principal, and branding. The type reference for these details is described in the [Metadata & Per-Season Data Type Reference](https://docs.sportmonks.com/v3/motorsport-api/welcome/metadata-and-per-season-data-type-reference).
{% endhint %}

#### **Available endpoints**

* [**GET All Teams**](https://docs.sportmonks.com/v3/motorsport-api/endpoints-and-entities/endpoints/teams/get-all-teams): returns all teams available in the Motorsport API.
* [**GET Team by ID**](https://docs.sportmonks.com/v3/motorsport-api/endpoints-and-entities/endpoints/teams/get-team-by-id): returns a single team by its ID.
* [**GET Teams by Season ID**](https://docs.sportmonks.com/v3/motorsport-api/endpoints-and-entities/endpoints/teams/get-teams-by-season-id): returns all teams competing in a provided season.
* [**GET Teams by Country ID**](https://docs.sportmonks.com/v3/motorsport-api/endpoints-and-entities/endpoints/teams/get-teams-by-country-id): returns teams for a provided country ID.
* [**GET Teams by Search**](https://docs.sportmonks.com/v3/motorsport-api/endpoints-and-entities/endpoints/teams/get-teams-by-search): returns teams matching a provided search query.

#### **Include options**

You can enrich team responses using `include`:

[`sport`](https://docs.sportmonks.com/v3/core-api/entities/core#sport) [`country`](https://docs.sportmonks.com/v3/core-api/entities/core#country) [`drivers`](https://docs.sportmonks.com/v3/motorsport-api/endpoints-and-entities/entities/driver) [`latest`](https://docs.sportmonks.com/v3/motorsport-api/endpoints-and-entities/entities/fixture) [`upcoming`](https://docs.sportmonks.com/v3/motorsport-api/endpoints-and-entities/entities/fixture) [`seasons`](https://docs.sportmonks.com/v3/motorsport-api/endpoints-and-entities/entities/season) `seasonDetails` `seasonDrivers`

{% hint style="info" %}
The `drivers` include returns driver participation information for the current season. To include the full driver entity alongside it, use the `drivers.driver` nested include.

If you only need a few fields, use `select` to request specific fields and reduce response size. See: [Request options](https://docs.sportmonks.com/v3/motorsport-api/welcome/request-options)
{% endhint %}

> **Include depth:** Teams endpoints support a maximum of **3** nested includes.

#### **Working with team fields**

* **`id`** - the unique team ID. This is the same value referenced as `team_id` in lineup objects and race results responses. Use it as the join key when combining team profiles with standings or race result data.
* **`country_id`** - the country the team is registered in or associated with. Resolve with `?include=country`.
* **`short_code`** - a 3-letter constructor abbreviation, e.g. `"FER"` for Ferrari, `"MCL"` for McLaren. Suitable for compact leaderboard displays.
* **`type`** - indicates the team's power unit type, e.g. `"hybrid"`. Reflects the engine technology classification used in the current regulatory era.
* **`last_played_at`** - the datetime of the team's most recent session. Useful for checking whether a team is currently active or has been retired from competition.
* **`placeholder`** - `true` for a team slot that exists structurally but has not yet been assigned to a real constructor. Filter these out when building team listings.
* **`founded`** - the team's founding year. Sparsely populated - handle `null` values in your application.
* **`venue_id`** - not used in the Motorsport API. Unlike football clubs, constructors do not have a home venue. This field is inherited from the shared v3 response structure and will always be `null`.

#### **Common requests**

**Look up a team by name:**

```http
GET /v3/motorsport/teams/search/ferrari?api_token=YOUR_TOKEN
```

**Full team profile with current drivers and country:**

```http
GET /v3/motorsport/teams/TEAM_ID
?api_token=YOUR_TOKEN&include=drivers.driver;country;seasonDetails
```

**All constructors in a season:**

```http
GET /v3/motorsport/teams/seasons/SEASON_ID
?api_token=YOUR_TOKEN
```

**All constructors in a season with their current drivers:**

```http
GET /v3/motorsport/teams/seasons/SEASON_ID
?api_token=YOUR_TOKEN&include=drivers.driver
```

**Lightweight team list (name, short code, and logo only):**

```http
GET /v3/motorsport/teams/seasons/SEASON_ID
?api_token=YOUR_TOKEN&select=id,name,short_code,image_path
```

{% hint style="info" %}
Use the search endpoint to find a team ID before calling standings or race results endpoints. The search accepts partial names - `"red bull"`, `"alpine"`, `"haas"` - and returns matching constructor records with their IDs.
{% endhint %}

#### **Related entities**

Get an overview and explanation of all the fields returned in the API response:

* [Team](https://docs.sportmonks.com/v3/motorsport-api/endpoints-and-entities/entities/team)

#### **Related pages**

* [Drivers](https://docs.sportmonks.com/v3/motorsport-api/endpoints-and-entities/endpoints/drivers) - The drivers competing for a team
* [Standings](https://docs.sportmonks.com/v3/motorsport-api/endpoints-and-entities/endpoints/standings) - Constructors' championship standings using team ID
* [Race Results](https://docs.sportmonks.com/v3/motorsport-api/endpoints-and-entities/endpoints/race-results) - Season result records using team ID
* [Seasons](https://docs.sportmonks.com/v3/motorsport-api/endpoints-and-entities/endpoints/seasons) - Look up season IDs
* [Metadata & Per-Season Data Type Reference](https://docs.sportmonks.com/v3/motorsport-api/welcome/metadata-and-per-season-data-type-reference)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sportmonks.com/v3/motorsport-api/endpoints-and-entities/endpoints/teams.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.