Competitions

Competitions Categories

get

Get Competition Categories

This endpoint retrieves a list of competition categories in the football API. It allows users to access various categories associated with football competitions.

Request

• Method: GET

• URL: https://apiv3.sportsapi360.com/football/api/v1/competitions/categories

Response

The response from this endpoint will be in JSON format and contains the following structure:

• status (boolean): Indicates the success of the request.

• statusCode (integer): A code representing the status of the response.

• message (string): A message providing additional information about the request.

• response (array): An array of competition category objects, each containing:

  • name (string): The name of the competition category.

  • slug (string): A URL-friendly version of the category name.

  • id (integer): A unique identifier for the category.

  • flag (string): A URL or path to the flag associated with the category.

  • alpha2 (string): The two-letter country code associated with the category.

This endpoint does not require any request body, as it is a simple GET request to retrieve data.

Authorizations

apikeyAuth

HTTPRequired

Header parameters

x-api-keystringOptional

Responses

200

OK

text/plain

Responsestring

get

/football/api/v1/competitions/categories

HTTPcURLJavaScriptPython

GET /football/api/v1/competitions/categories HTTP/1.1
Host: apiv3.sportsapi360.com
Authorization: x-api-key YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
    "status": true,
    "statusCode": 200,
    "message": "Data fetch successfully",
    "response": [
        {
            "name": "Afghanistan",
            "slug": "afghanistan",
            "id": 1084,
            "flag": "afghanistan",
            "alpha2": "AF"
        },
        {
            "name": "Africa",
            "slug": "africa",
            "id": 1466,
            "flag": "africa"
        },
        {
            "name": "Albania",
            "slug": "albania",
            "id": 257,
            "flag": "albania",
            "alpha2": "AL"
        },
        {
            "name": "Algeria",
            "slug": "algeria",
            "id": 304,
            "flag": "algeria",
            "alpha2": "DZ"
        }
        ]
    }
}

Default Competitions

get

Get Competitions by Country

This endpoint retrieves a list of football competitions based on the specified country.

Request

• Method: GET

• Endpoint: https://apiv3.sportsapi360.com/football/api/v1/competitions/default

• Query Parameters:

  • country (string): The country code for which to fetch the competitions. For example, ES for Spain.

Response

The response will return a JSON object with the following structure:

• status (boolean): Indicates the success of the request.

• statusCode (integer): A code representing the status of the response.

• message (string): A message providing additional information about the response.

• response (array): An array of competition objects, each containing:

  • name (string): The name of the competition.

  • category (object): An object containing details about the competition category:

    • name (string): The name of the category.

    • id (integer): The unique identifier for the category.

    • flag (string): The URL or path to the flag image associated with the category.

    • alpha2 (string): The two-letter country code for the category.

  • id (integer): The unique identifier for the competition.

  • displayInverseHomeAwayTeams (boolean): A flag indicating whether to display teams in an inverse home/away format.

This endpoint is useful for applications that need to display or utilize information about football competitions in a specific country.

Authorizations

apikeyAuth

HTTPRequired

Query parameters

countrystringOptionalExample: ES

Header parameters

x-api-keystringOptional

Responses

200

OK

text/plain

Responsestring

get

/football/api/v1/competitions/default

HTTPcURLJavaScriptPython

GET /football/api/v1/competitions/default HTTP/1.1
Host: apiv3.sportsapi360.com
Authorization: x-api-key YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
    "status": true,
    "statusCode": 200,
    "message": "Data fetch successfully",
    "response": [
        {
            "name": "LaLiga",
            "category": {
                "name": "Spain",
                "id": 32,
                "flag": "spain",
                "alpha2": "ES"
            },
            "id": 8,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "FIFA World Cup",
            "category": {
                "name": "World",
                "id": 1468,
                "flag": "international"
            },
            "id": 16,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "UEFA Champions League",
            "category": {
                "name": "Europe",
                "id": 1465,
                "flag": "europe"
            },
            "id": 7,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "Premier League",
            "category": {
                "name": "England",
                "id": 1,
                "flag": "england",
                "alpha2": "EN"
            },
            "id": 17,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "Serie A",
            "category": {
                "name": "Italy",
                "id": 31,
                "flag": "italy",
                "alpha2": "IT"
            },
            "id": 23,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "Copa del Rey",
            "category": {
                "name": "Spain",
                "id": 32,
                "flag": "spain",
                "alpha2": "ES"
            },
            "id": 329,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "Bundesliga",
            "category": {
                "name": "Germany",
                "id": 30,
                "flag": "germany",
                "alpha2": "DE"
            },
            "id": 35,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "Ligue 1",
            "category": {
                "name": "France",
                "id": 7,
                "flag": "france",
                "alpha2": "FR"
            },
            "id": 34,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "EURO",
            "category": {
                "name": "Europe",
                "id": 1465,
                "flag": "europe"
            },
            "id": 1,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "Supercopa de España",
            "category": {
                "name": "Spain",
                "id": 32,
                "flag": "spain",
                "alpha2": "ES"
            },
            "id": 213,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "UEFA Europa League",
            "category": {
                "name": "Europe",
                "id": 1465,
                "flag": "europe"
            },
            "id": 679,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "UEFA Conference League",
            "category": {
                "name": "Europe",
                "id": 1465,
                "flag": "europe"
            },
            "id": 17015,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "UEFA Nations League",
            "category": {
                "name": "Europe",
                "id": 1465,
                "flag": "europe"
            },
            "id": 10783,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "LaLiga 2",
            "category": {
                "name": "Spain",
                "id": 32,
                "flag": "spain",
                "alpha2": "ES"
            },
            "id": 54,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "World Cup Qual. UEFA",
            "category": {
                "name": "Europe",
                "id": 1465,
                "flag": "europe"
            },
            "id": 11,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "EURO, Qualification",
            "category": {
                "name": "Europe",
                "id": 1465,
                "flag": "europe"
            },
            "id": 27,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "UEFA Super Cup",
            "category": {
                "name": "Europe",
                "id": 1465,
                "flag": "europe"
            },
            "id": 465,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "FIFA Club World Cup",
            "category": {
                "name": "World",
                "id": 1468,
                "flag": "international"
            },
            "id": 357,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "Copa América",
            "category": {
                "name": "South America",
                "id": 1470,
                "flag": "south-america"
            },
            "id": 133,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "Primera Federación",
            "category": {
                "name": "Spain",
                "id": 32,
                "flag": "spain",
                "alpha2": "ES"
            },
            "id": 17073,
            "displayInverseHomeAwayTeams": false
        }
    ]
}

Top Competitions

get

API Request Description

Method

GET

Endpoint

https://apiv3.sportsapi360.com/football/api/v1/competitions/top

Query Parameters

• country (string): The country code for which to retrieve the top football competitions. In this example, the value is ES for Spain.

Expected Response Format

The response will be in JSON format and includes the following fields:

• status (boolean): Indicates whether the request was successful.

• statusCode (integer): A code representing the status of the request.

• message (string): A message providing additional information about the request status.

• response (array): An array of objects containing details about the top competitions, where each object includes:

  • name (string): The name of the competition.

  • category (object): An object containing:

    • name (string): The name of the category.

    • id (integer): The unique identifier for the category.

    • flag (string): A URL or identifier for the category's flag.

  • id (integer): The unique identifier for the competition.

  • displayInverseHomeAwayTeams (boolean): A flag indicating if the home and away teams should be displayed inversely.

This endpoint allows users to retrieve a list of the top football competitions for a specified country, along with relevant details about each competition.

Authorizations

apikeyAuth

HTTPRequired

Query parameters

countrystringOptionalExample: ES

Header parameters

x-api-keystringOptional

Responses

200

OK

text/plain

Responsestring

get

/football/api/v1/competitions/top

HTTPcURLJavaScriptPython

GET /football/api/v1/competitions/top HTTP/1.1
Host: apiv3.sportsapi360.com
Authorization: x-api-key YOUR_SECRET_TOKEN
Accept: */*

200

OK

{
    "status": true,
    "statusCode": 200,
    "message": "Data fetch successfully",
    "response": [
        {
            "name": "UEFA Champions League",
            "category": {
                "name": "Europe",
                "id": 1465,
                "flag": "europe"
            },
            "id": 7,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "UEFA Europa League",
            "category": {
                "name": "Europe",
                "id": 1465,
                "flag": "europe"
            },
            "id": 679,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "Premier League",
            "category": {
                "name": "England",
                "id": 1,
                "flag": "england",
                "alpha2": "EN"
            },
            "id": 17,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "LaLiga",
            "category": {
                "name": "Spain",
                "id": 32,
                "flag": "spain",
                "alpha2": "ES"
            },
            "id": 8,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "Bundesliga",
            "category": {
                "name": "Germany",
                "id": 30,
                "flag": "germany",
                "alpha2": "DE"
            },
            "id": 35,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "Serie A",
            "category": {
                "name": "Italy",
                "id": 31,
                "flag": "italy",
                "alpha2": "IT"
            },
            "id": 23,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "Ligue 1",
            "category": {
                "name": "France",
                "id": 7,
                "flag": "france",
                "alpha2": "FR"
            },
            "id": 34,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "UEFA Conference League",
            "category": {
                "name": "Europe",
                "id": 1465,
                "flag": "europe"
            },
            "id": 17015,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "Brasileirão Betano",
            "category": {
                "name": "Brazil",
                "id": 13,
                "flag": "brazil",
                "alpha2": "BR"
            },
            "id": 325,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "CONMEBOL Libertadores",
            "category": {
                "name": "South America",
                "id": 1470,
                "flag": "south-america"
            },
            "id": 384,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "FIFA World Cup",
            "category": {
                "name": "World",
                "id": 1468,
                "flag": "international"
            },
            "id": 16,
            "displayInverseHomeAwayTeams": false
        },
        {
            "name": "FIFA Club World Cup",
            "category": {
                "name": "World",
                "id": 1468,
                "flag": "international"
            },
            "id": 357,
            "displayInverseHomeAwayTeams": false
        }
    ]
}