Retrieving results

This page describes the way of requesting results, during a live session or after it.

Endpoints and includes for retrieving results

Results are retrievable via includes available on all Live and Fixtures endpoints, however they can also be retrieved via most endpoints where you can include fixtures. For example on the GET Fixture by ID endpoint:

https://api.sportmonks.com/v3/motorsport/fixtures/19408487
?api_token=YOUR_TOKEN
&include=results

Or, if you want to get the results for the whole season, you can use a nested include:

https://api.sportmonks.com/v3/motorsport/seasons/25273
?api_token=YOUR_TOKEN
&include=fixtures.results

The response will show the results under the fixture:

{
  "data": {
    "id": 19408487,
    "sport_id": 2,
    "league_id": 3468,
    "season_id": 25273,
    "stage_id": 77476128,
    "name": "Race",
    "starting_at": "2025-12-07 13:00:00",
    // ...
    "results": [
      {
        "id": 17567017,
        "fixture_id": 19408487,
        "type_id": 9729,
        "participant_id": 37920819,
        "description": "TYRE",
        "result": {
          "compound": "HARD",
          "age_since_start": 0
        }
      },
      {
        "id": 17567189,
        "fixture_id": 19408487,
        "type_id": 9732,
        "participant_id": 37920801,
        "description": "GAP_TO_LEADER",
        "result": {
          "gap": "1 lap"
        }
      },
      {
        "id": 17566940,
        "fixture_id": 19408487,
        "type_id": 9733,
        "participant_id": 37920804,
        "description": "INTERVAL",
        "result": {
          "interval": "6.707"
        }
      },
      {
        "id": 17566957,
        "fixture_id": 19408487,
        "type_id": 9711,
        "participant_id": 37920802,
        "description": "POSITION",
        "result": {
          "position": 3
        }
      },
      {
        "id": 17567344,
        "fixture_id": 19408487,
        "type_id": 9708,
        "participant_id": 37920815,
        "description": "TIME",
        "result": {
          "time": "1:31.291"
        }
      },
      // ...

These types are available in the result include:

Developer name (description)	Explanation
TIME	The latest lap time (races) The fastest lap time (practices and qualifications)
INTERVAL	Interval between this driver and the driver ahead (if the driver is not leading; no + prefix) The amount of laps behind (if the driver is not leading, e.g. '1 lap'; no + prefix) The total racing time, if available (If the driver is P1)
GAP_TO_LEADER	The time gap between this driver and the leading driver (if the driver is not leading, no + prefix) The amount of laps behind (if the driver is not leading, e.g. '1 lap', no + prefix) The total racing time, if available (if the driver is P1) DNS/DNF status (Note: We recommend to use the dedicated STATUS type instead - this is available in the lineup details, described further on this page)
POSITION	The current position of the driver in the race
TYRE	The current used tyre comound (SOFT, MEDIUM, HARD, INTERMEDIATE, WET, TEST_UNKNOWN*) and age since start (in number of laps) *TEST_UNKNOWN is a type only used during pre-season testing sessions, and means that a driver is testing prototype tyres

Matching results to the driver

To match each result to a driver, you have three options:

1. Pre-load all the drivers into your application using the GET All Drivers endpoint (Recommended for an initial data load)

2. Use the lineups.driver nested include to retrieve all the drivers for the fixture (Recommended at least at the session start, to retrieve any new drivers)

3. Including the driver on the result using the results.participant nested include (Not recommended due to decreased performance and larger responses)

The 'lineup details' alternative

The results include gives you a subset of the most important result data. Do you need more?You can use the lineups.details include to retrieve the full set of types using this endpoint:

https://api.sportmonks.com/v3/motorsport/fixtures/19408487
?api_token=YOUR_TOKEN
&include=lineups.details

In the table below is an explanation of all the types available using this include:

Developer name	Explanation
TIME	The latest lap time (races) The fastest lap time (practices and qualifications)
INTERVAL	Interval between this driver and the driver ahead (if the driver is not leading; no + prefix) The amount of laps behind (if the driver is not leading, e.g. '1 lap'; no + prefix) The total racing time, if available (If the driver is P1)
GAP_TO_LEADER	The time gap between this driver and the leading driver (if the driver is not leading, no + prefix) The amount of laps behind (if the driver is not leading, e.g. '1 lap', no + prefix) The total racing time, if available (if the driver is P1) DNS/DNF status (Note: We recommend to use the dedicated STATUS type instead - see STATUS below)
POSITION	The current position of the driver in the race
STATUS	The status of the driver: DNS/DNF/DSQ
TYRE	The current used tyre comound (SOFT, MEDIUM, HARD, INTERMEDIATE, WET, TEST_UNKNOWN*) and age since start (in number of laps) *TEST_UNKNOWN is a type only used during pre-season testing sessions, and means that a driver is testing prototype tyres
LAPS	The amount of laps
PITSTOPS	The amount of pitstops
FASTEST_LAP	The driver fastest lap time and the lap number
POINTS	The points that would be assigned to the driver if they finish on their current position (live) or the points received for the race (after race), only available for race type sessions
GRID_POSITION	The grid position, only available for race type sessions

This include is a bit more advanced, as the type is not included by default. However, with the lineups include, the driver name, number and grid position is also included in the response. In the example below, the include is enriched with types by using lineups.details.type:

{
  "data": {
    "id": 19408487,
    "sport_id": 2,
    "league_id": 3468,
    "season_id": 25273,
    "stage_id": 77476128,
    // ...
    "lineups": [
      {
        "id": 14671697707,
        "sport_id": 2,
        "fixture_id": 19408487,
        "player_id": 37920803,
        "team_id": 276189,
        "position_id": 9730,
        "type_id": 11,
        "grid_position": 16,
        "driver_name": "Lewis Hamilton",
        "driver_number": 44,
        "details": [
          {
            "id": 1816685465,
            "fixture_id": 19408487,
            "player_id": 37920803,
            "team_id": 276189,
            "lineup_id": 14671697707,
            "type_id": 9707,
            "data": {
              "points": 4
            },
            "type": {
              "id": 9707,
              "name": "Points",
              "code": "points",
              "developer_name": "POINTS",
              "model_type": "score",
              "stat_group": null
            }
          },
          {
            // ...
            "type_id": 9712,
            "data": {
              "position": 16
            },
            "type": {
              "id": 9712,
              "name": "Grid Position",
              "code": "grid-position",
              "developer_name": "GRID_POSITION",
              "model_type": "score",
              "stat_group": null
            }
          },
          {
            // ...
            "type_id": 9710,
            "data": {
              "laps": 58
            },
            "type": {
              "id": 9710,
              "name": "Laps",
              "code": "laps",
              "developer_name": "LAPS",
              "model_type": "score",
              "stat_group": null
            }
          },
          {
            // ...
            "type_id": 9709,
            "data": {
              "stops": 2
            },
            "type": {
              "id": 9709,
              "name": "Pitstops",
              "code": "pitstops",
              "developer_name": "PITSTOPS",
              "model_type": "score",
              "stat_group": null
            }
          },
          {
            // ...
            "type_id": 9716,
            "data": {
              "time": "1:28.094",
              "lap_number": 36
            },
            "type": {
              "id": 9716,
              "name": "Fastest Lap",
              "code": "fastest-lap",
              "developer_name": "FASTEST_LAP",
              "model_type": "score",
              "stat_group": null
            }
          },
          {
            // ...
            "type_id": 9733,
            "data": {
              "interval": "2.794"
            },
            "type": {
              "id": 9733,
              "name": "Interval",
              "code": "interval",
              "developer_name": "INTERVAL",
              "model_type": "score",
              "stat_group": null
            }
          }
        ]
      },
      // ...