Skip to content
datasportsAPI

FixturesPre-match form

Documentation

/

Type to filter the docs by title or path.

FixturesEndpoint 18 of 116

Pre-match form

GET

/v2/fixtures/{id}/form

Plan
All plans
Auth
Bearer dsa_live_…
Parameters
1 required · 0 optional
Returns
PregameForm

Pre-match form for both teams: recent results in this competition (oldest first), table position, the numeric table figure (points in football; wins, draws and losses in W-L / W-D-L sports) and average rating — plus each team’s latest matches across all competitions (lastFixtures: fixture id, competition, opponent, home / away, result, score).

Worth knowing

  • Provided for covered leagues, both before and after the match.
  • results mirrors the competition’s own form guide, in which an ice-hockey loss in overtime or a shoot-out (OTL at the source) counts as a loss.
  • lastFixtures (since 2026-11-04) lists up to five of the team’s latest finished matches in any competition — league, cup, European or friendly — in chronological order, each carrying our fixture id (usable with /v2/fixtures/{id}); scoreFor / scoreAgainst hold the sides’ current scores (sets in tennis).
  • The source has no tennis form guide, so a player’s side comes with empty results and null table figures, though lastFixtures is still populated.
  • If a fixture has neither, the response is 200 with home and away null; 404 is returned only for ids that do not exist.

01Parameters

  • idpathRequired

    fixture id issued by DataSportsAPI, a positive integer

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/fixtures/{id}/form"

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data
PregameForm
Example response
{ "data": {
    "home": { "results": ["win", "loss", "loss"], "position": 27, "points": 3, "wins": null, "draws": null, "losses": null, "avgRating": 7.03,
      "lastFixtures": [ …,
        { "fixtureId": 222801, "startTime": "2026-10-28T18:30:00.000Z", "league": { "id": 40121, "name": "Superbet Greek Cup", … },
          "side": "away", "opponent": { "id": 3251, "name": "PAOK", … }, "scoreFor": 1, "scoreAgainst": 3, "result": "loss" },
        { "fixtureId": 219964, "startTime": "2026-11-01T19:30:00.000Z", "league": { "id": 1185, "name": "Stoiximan Super League", … },
          "side": "away", "opponent": { "id": 3248, "name": "Panathinaikos FC", … }, "scoreFor": 0, "scoreAgainst": 2, "result": "loss" } ] },
    "away": { "results": ["win", "win", "win"], "position": 5, "points": 9, "wins": null, "draws": null, "losses": null, "avgRating": 7.97,
      "lastFixtures": [ … ] } } }

04Errors

Nothing specific to this endpoint: only the account-wide errors below apply.

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code