History API¶
This endpoint returns the score with the latest timestamp less than or equal to the provided "scoreDate" (UTC). If no "scoreDate" is specified, the score nearest to the current UTC time is returned. Example format for "scoreDate": 2025-09-16T21:59:59.999Z. Time to live (TTL) of scoreboard is 14 days.
GET /v1/sport/v0/score/history/{id}¶
Retrieve the score nearest to the specified scoreDate for event with {id}.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| scoreDate | query | DateTime | false | Date and time for score. If no scoreDate is specified, the score nearest to the current UTC time is returned. Score TTL = 14 days |
| Authorization | header | string | true | none |
| X-Brand | header | string | true | none |
| X-Operator-Id | header | string | true | none |
Example responses¶
200 Response¶
{
"id": {
"eventId": "14301291",
"dataVersion": 82
},
"timestamp": "2025-09-16T14:38:14.5340154Z",
"sourceTimestamp": "0001-01-01T00:00:00Z",
"removedTimestamp": null,
"eventStatus": 1,
"currentGameStage": 3,
"currentGameSubStage": null,
"serverNumber": null,
"server": 0,
"periodScores": [
{
"type": "Goals",
"typePlatformId": 1,
"period": 1,
"subPeriod": null,
"score": "4-0"
},
{
"type": "Goals",
"typePlatformId": 1,
"period": 2,
"subPeriod": null,
"score": "3-0"
},
{
"type": "Goals",
"typePlatformId": 1,
"period": 3,
"subPeriod": null,
"score": "1-0"
},
{
"type": "Goals",
"typePlatformId": 1,
"period": 4,
"subPeriod": null,
"score": "4-0"
},
{
"type": "Corners",
"typePlatformId": 4,
"period": 1,
"subPeriod": null,
"score": "4-1"
},
{
"type": "Corners",
"typePlatformId": 4,
"period": 2,
"subPeriod": null,
"score": "2-0"
},
{
"type": "Corners",
"typePlatformId": 4,
"period": 3,
"subPeriod": null,
"score": "2-1"
},
{
"type": "Corners",
"typePlatformId": 4,
"period": 4,
"subPeriod": null,
"score": "4-1"
},
{
"type": "YellowCards",
"typePlatformId": 8,
"period": 1,
"subPeriod": null,
"score": "1-1"
},
{
"type": "YellowCards",
"typePlatformId": 8,
"period": 2,
"subPeriod": null,
"score": "0-1"
},
{
"type": "YellowCards",
"typePlatformId": 8,
"period": 3,
"subPeriod": null,
"score": "1-0"
},
{
"type": "YellowCards",
"typePlatformId": 8,
"period": 4,
"subPeriod": null,
"score": "1-1"
},
{
"type": "RedCards",
"typePlatformId": 16,
"period": 4,
"subPeriod": null,
"score": "0-0"
}
],
"pointInfos": [
{
"competitorId": "274438",
"type": "Goals",
"typePlatformId": 1,
"number": 1,
"minuteOfPoint": 14
},
{
"competitorId": "274438",
"type": "Goals",
"typePlatformId": 1,
"number": 2,
"minuteOfPoint": 22
},
{
"competitorId": "274438",
"type": "Goals",
"typePlatformId": 1,
"number": 3,
"minuteOfPoint": 45
},
{
"competitorId": "274438",
"type": "Goals",
"typePlatformId": 1,
"number": 4,
"minuteOfPoint": 62
}
],
"competitorInfos": [],
"isLineForEvent": true,
"hiddenResPage": false,
"sport": "Football",
"metadataSport": 1
}
400 Response¶
500 Response¶
Responses¶
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | Accepted | In case of success | None |
| 400 | Bad Request | In case of invalid request | None |
| 500 | Internal Server Error | In case some internal error | None |