Skip to main content
GET
/
TournamentMatchList
Tournament Match List
curl --request GET \
  --url 'https://api.example.com/TournamentMatchList?key='
{
  "result": "string",
  "message": "string",
  "data": [
    {
      "_type": "MATCH",
      "matchId": "integer",
      "tournament": "string",
      "season": "string",
      "round": "integer|null",

      "home": {
        "_type": "TEAM",
        "id": "integer",
        "name": "string"
      },

      "away": {
        "_type": "TEAM",
        "id": "integer",
        "name": "string"
      },

      "dateTime": "YYYY-MM-DD HH:MM:SS",
      "dtLastUpdateDateTime": "YYYY-MM-DD HH:MM:SS",

      "stadium": {
        "_type": "STADIUM",
        "id": "integer",
        "name": "string"
      },

      "referee": {
        "_type": "REFEREE",
        "id": "integer",
        "name": "string",
        "dob": "YYYY-MM-DD|null",
        "nationality": {
          "_type": "NATIONALITY",
          "id": "integer",
          "name": "string"
        }
      },

      "assistant1": {
        "_type": "string",
        "id": "integer",
        "name": "string",
        "dob": "YYYY-MM-DD|null",
        "gender": "string|null",
        "nationality": "object|null"
      },

      "assistant2": {
        "_type": "string",
        "id": "integer",
        "name": "string",
        "dob": "YYYY-MM-DD|null",
        "gender": "string|null",
        "nationality": "object|null"
      },

      "score": {
        "home": "integer|null",
        "away": "integer|null"
      }
    }
  ]
}

​
Overview

This endpoint returns all matches for a given tournament. Each match includes:
  • Match identifiers and competition context (tournament, season, round)
  • Home and away teams
  • Match datetime + last update datetime
  • Stadium
  • Match officials (referee, assistants)
  • Final score (if available)

​
Typical use cases:

  • Build fixture/results lists
  • Load matches for analytics pipelines
  • Power match selector UIs
  • Generate competition calendars
GET /api.php

​
Parameters

​
module
string
Always use api
​
api
string
The API name, use TournamentMatchList
​
version
string
The API version (use V2)
​
lang
string
en for English, ar for Arabic
​
response
string
Output format (json or xml)
​
key
string
Your API key
​
tournament_id
string
The tournament ID (example: 211)

​
Example Request

curl --request GET \
  --url "{{Base URL}}?module=api&api=TournamentMatchList&version=V2&lang=en&response=json&key=YOUR_API_KEY&tournament_id=211"

​
Response

{
  "result": "string",
  "message": "string",
  "data": [
    {
      "_type": "MATCH",
      "matchId": "integer",
      "tournament": "string",
      "season": "string",
      "round": "integer|null",

      "home": {
        "_type": "TEAM",
        "id": "integer",
        "name": "string"
      },

      "away": {
        "_type": "TEAM",
        "id": "integer",
        "name": "string"
      },

      "dateTime": "YYYY-MM-DD HH:MM:SS",
      "dtLastUpdateDateTime": "YYYY-MM-DD HH:MM:SS",

      "stadium": {
        "_type": "STADIUM",
        "id": "integer",
        "name": "string"
      },

      "referee": {
        "_type": "REFEREE",
        "id": "integer",
        "name": "string",
        "dob": "YYYY-MM-DD|null",
        "nationality": {
          "_type": "NATIONALITY",
          "id": "integer",
          "name": "string"
        }
      },

      "assistant1": {
        "_type": "string",
        "id": "integer",
        "name": "string",
        "dob": "YYYY-MM-DD|null",
        "gender": "string|null",
        "nationality": "object|null"
      },

      "assistant2": {
        "_type": "string",
        "id": "integer",
        "name": "string",
        "dob": "YYYY-MM-DD|null",
        "gender": "string|null",
        "nationality": "object|null"
      },

      "score": {
        "home": "integer|null",
        "away": "integer|null"
      }
    }
  ]
}

Authorizations

​
key
string
query
required

API key passed as a query parameter named key.

Query Parameters

​
module
string
default:api

Module API fixed and cannot be changed

​
version
string
default:V2

The API version

​
response
string
default:json

The response returned by the API. The value of this field could be "json" or "xml"

​
lang
string
default:en

The language is english by default, pass "ar" to return the values in Arabic language.

​
tournament_id
integer
required

The tournament ID can be retrieve from the TournamentList API.

Response

Successful response

The response is of type object.