StatsHub Docs
APIEndpoint referenceFixtures

/v2/fixtures

List fixtures

GET
/api/v2/fixtures

List fixtures

Query Parameters

limit?integer

Maximum resources to return; defaults to 25

Range1 <= value <= 100
Default25
after?string

Opaque cursor for the next page

before?string

Opaque cursor for the previous page

competitionId?string

Filter by competition

Match^[1-9][0-9]*$
seasonId?string

Filter by season

Match^[1-9][0-9]*$
teamId?string

Filter by either participating team

Match^[1-9][0-9]*$
refereeId?string

Filter by referee

Match^[1-9][0-9]*$
status?string

Canonical fixture status

Value in

  • "scheduled"
  • "live"
  • "finished"
  • "postponed"
  • "cancelled"
  • "unknown"
kickoffFrom?string

Inclusive kickoff lower bound

Formatdate-time
kickoffTo?string

Exclusive kickoff upper bound

Formatdate-time
sort?string

Kickoff order

Value in

  • "kickoffAt"
  • "-kickoffAt"

Response Body

application/json

application/problem+json

application/problem+json

curl -X GET "https://example.com/api/v2/fixtures"
{  "data": [    {      "awayTeam": {        "id": "string",        "name": "string",        "shortName": "string",        "slug": "string"      },      "competition": {        "id": "string",        "name": "string",        "slug": "string"      },      "coverage": {        "lineup": "string",        "odds": true,        "playerStatistics": true,        "statistics": true      },      "homeTeam": {        "id": "string",        "name": "string",        "shortName": "string",        "slug": "string"      },      "id": "string",      "kickoffAt": "2019-08-24T14:15:22Z",      "phase": {        "id": "string",        "name": "string",        "slug": "string"      },      "referee": {        "id": "string",        "name": "string",        "slug": "string"      },      "round": 0,      "score": {        "away": 0,        "awayNormal": 0,        "home": 0,        "homeNormal": 0      },      "season": {        "id": "string",        "name": "string",        "slug": "string"      },      "slug": "string",      "status": "string",      "venue": {        "cityName": "string",        "id": "string",        "name": "string",        "slug": "string"      }    }  ],  "links": {    "next": "string",    "previous": "string",    "self": "string"  },  "page": {    "hasNext": true,    "hasPrevious": true,    "limit": 0,    "nextCursor": "string",    "previousCursor": "string"  }}