SofaScore event point-by-point API

Endpoint facts

Method

GET

API path

/sofascore/event-point-by-point

Auth

apiKey

Credits

2 credits/request

Charged on

Successful 2xx responses only

Platform

SofaScore

Response schema

#/definitions/sofascore.eventPointByPointResponseDoc

How this endpoint behaves

Query parameters:

• id: required. Numeric SofaScore event (match) id of a tennis, table tennis or badminton match, e.g. 17257382. Get it from sofascore/live-events, sofascore/team-events or sofascore/scheduled-events.

Notable response behavior:

• Tennis sets list games; every game lists its points with the score after each point: home_point and away_point are 0, 15, 30, 40 and A in a normal game and a plain count in a tie-break. A game score holds the games won in the set after that game (home_score, away_score), the server and the game winner (home or away). winner is omitted while the game is being played and server when SofaScore does not know it yet. A game can come without a score when SofaScore did not record one.
• description is ace or double_fault where SofaScore flags the point (description_code 1 or 2; 0 means no flag). Double faults matched the match statistics exactly on two matches checked; the ace flag is a lower bound (on one match it flagged 18 of the 26 aces in the statistics), so use sofascore/event-statistics for totals.
• home_point_type and away_point_type are SofaScore's per-player point codes. home_marker and away_marker name the two opportunity codes: break_point (code 2, the returner holds a break point after the point) and set_or_match_point (code 3; SofaScore reports a match point with the same code as a set point). Codes 1 and 5 mark an ordinary point (1 for the player who won it, 5 otherwise; the last point of a tie-break can carry 5 for both players), and code 6 appears only in tie-breaks; other codes carry no marker.
• Table tennis and badminton sets have no games: each set lists its points directly and carries a score with the points won in the set.
• Darts matches list legs instead of games and return 404. An empty sets array is a valid response (a match with no point yet).
• Returns 404 when SofaScore has no point-by-point data for the match. This includes matches that have not started, sports other than tennis, table tennis and badminton, and unknown ids.

Example response (shortened):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "event_id": 17257382,
    "source_url": "https://api.sofascore.com/api/v1/event/17257382/point-by-point",
    "fetched_at": "2026-10-07T17:00:00Z",
    "set_count": 3,
    "sets": [
      {
        "set": 1,
        "games": [
          {
            "game": 1,
            "score": {
              "home_score": 1,
              "away_score": 0,
              "server": "home",
              "winner": "home"
            },
            "points": [
              {
                "home_point": "15",
                "away_point": "0",
                "description_code": 0,
                "home_point_type": 1,
                "away_point_type": 5
              },
              {
                "home_point": "15",
                "away_point": "15",
                "description_code": 0,
                "home_point_type": 5,
                "away_point_type": 1
              },
              {
                "home_point": "30",
                "away_point": "15",
                "description_code": 0,
                "home_point_type": 1,
                "away_point_type": 5
              }
            ]
          },
          "...",
          {
            "game": 13,
            "score": {
              "home_score": 7,
              "away_score": 6,
              "server": "away",
              "winner": "home"
            },
            "points": [
              {
                "home_point": "1",
                "away_point": "0",
                "description_code": 0,
                "home_point_type": 1,
                "away_point_type": 5
              },
              {
                "home_point": "2",
                "away_point": "0",
                "description": "double_fault",
                "description_code": 2,
                "home_point_type": 6,
                "away_point_type": 5
              },
              {
                "home_point": "6",
                "away_point": "3",
                "description_code": 0,
                "home_point_type": 3,
                "away_point_type": 6,
                "home_marker": "set_or_match_point"
              },
              {
                "home_point": "7",
                "away_point": "3",
                "description_code": 0,
                "home_point_type": 5,
                "away_point_type": 5
              }
            ]
          }
        ]
      },
      "...",
      {
        "set": 3,
        "games": [
          "...",
          {
            "game": 10,
            "score": {
              "home_score": 4,
              "away_score": 6,
              "server": "away",
              "winner": "away"
            },
            "points": [
              {
                "home_point": "15",
                "away_point": "30",
                "description_code": 0,
                "home_point_type": 5,
                "away_point_type": 1
              },
              {
                "home_point": "15",
                "away_point": "40",
                "description_code": 0,
                "home_point_type": 5,
                "away_point_type": 3,
                "away_marker": "set_or_match_point"
              }
            ]
          }
        ]
      }
    ]
  }
}

Live monitoring

Monitored request

GET /sofascore/event-point-by-point?id=17257382

Checks passed, 7 days to 14 Oct 2026

100%

Median response time

1.01 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026

GET /sofascore/event-point-by-point?id=17257382

Items in sets

3

Fields filled in every checked item

2

Shared guides

Related