# Competitions ## Competitions Categories > \## 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\*\*: \` > \ > \ > \### 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. ```json {"openapi":"3.0.0","info":{"title":"FOOTBALL API V1","version":"1.0.0"},"tags":[{"name":"Competitions"}],"servers":[{"url":"https://apiv3.sportsapi360.com"}],"security":[{"apikeyAuth":[]}],"components":{"securitySchemes":{"apikeyAuth":{"type":"http","scheme":"x-api-key"}}},"paths":{"/football/api/v1/competitions/categories":{"get":{"tags":["Competitions"],"summary":"Competitions Categories","description":"## Get Competition Categories\n\nThis endpoint retrieves a list of competition categories in the football API. It allows users to access various categories associated with football competitions.\n\n### Request\n\n- **Method**: GET\n \n- **URL**: `https://apiv3.sportsapi360.com/football/api/v1/competitions/categories`\n \n\n### Response\n\nThe response from this endpoint will be in JSON format and contains the following structure:\n\n- **status** (boolean): Indicates the success of the request.\n \n- **statusCode** (integer): A code representing the status of the response.\n \n- **message** (string): A message providing additional information about the request.\n \n- **response** (array): An array of competition category objects, each containing:\n \n - **name** (string): The name of the competition category.\n \n - **slug** (string): A URL-friendly version of the category name.\n \n - **id** (integer): A unique identifier for the category.\n \n - **flag** (string): A URL or path to the flag associated with the category.\n \n - **alpha2** (string): The two-letter country code associated with the category.\n \n\nThis endpoint does not require any request body, as it is a simple GET request to retrieve data.","parameters":[{"name":"x-api-key","in":"header","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"text/plain":{"schema":{"type":"string"}}}}}}}}} ``` ## Default Competitions > \## Get Competitions by Country\ > \ > This endpoint retrieves a list of football competitions based on the specified country.\ > \ > \### Request\ > \ > \- \*\*Method\*\*: \`GET\`\ > \ > \- \*\*Endpoint\*\*: \` > \ > \- \*\*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. ```json {"openapi":"3.0.0","info":{"title":"FOOTBALL API V1","version":"1.0.0"},"tags":[{"name":"Competitions"}],"servers":[{"url":"https://apiv3.sportsapi360.com"}],"security":[{"apikeyAuth":[]}],"components":{"securitySchemes":{"apikeyAuth":{"type":"http","scheme":"x-api-key"}}},"paths":{"/football/api/v1/competitions/default":{"get":{"tags":["Competitions"],"summary":"Default Competitions","description":"## Get Competitions by Country\n\nThis endpoint retrieves a list of football competitions based on the specified country.\n\n### Request\n\n- **Method**: `GET`\n \n- **Endpoint**: `https://apiv3.sportsapi360.com/football/api/v1/competitions/default`\n \n- **Query Parameters**:\n \n - `country` (string): The country code for which to fetch the competitions. For example, `ES` for Spain.\n \n\n### Response\n\nThe response will return a JSON object with the following structure:\n\n- **status** (boolean): Indicates the success of the request.\n \n- **statusCode** (integer): A code representing the status of the response.\n \n- **message** (string): A message providing additional information about the response.\n \n- **response** (array): An array of competition objects, each containing:\n \n - **name** (string): The name of the competition.\n \n - **category** (object): An object containing details about the competition category:\n \n - **name** (string): The name of the category.\n \n - **id** (integer): The unique identifier for the category.\n \n - **flag** (string): The URL or path to the flag image associated with the category.\n \n - **alpha2** (string): The two-letter country code for the category.\n \n - **id** (integer): The unique identifier for the competition.\n \n - **displayInverseHomeAwayTeams** (boolean): A flag indicating whether to display teams in an inverse home/away format.\n \n\nThis endpoint is useful for applications that need to display or utilize information about football competitions in a specific country.","parameters":[{"name":"x-api-key","in":"header","schema":{"type":"string"}},{"name":"country","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"text/plain":{"schema":{"type":"string"}}}}}}}}} ``` ## Top Competitions > \## API Request Description\ > \ > \### Method\ > \ > \*\*GET\*\*\ > \ > \### Endpoint\ > \ > \` > \ > \### 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. ```json {"openapi":"3.0.0","info":{"title":"FOOTBALL API V1","version":"1.0.0"},"tags":[{"name":"Competitions"}],"servers":[{"url":"https://apiv3.sportsapi360.com"}],"security":[{"apikeyAuth":[]}],"components":{"securitySchemes":{"apikeyAuth":{"type":"http","scheme":"x-api-key"}}},"paths":{"/football/api/v1/competitions/top":{"get":{"tags":["Competitions"],"summary":"Top Competitions","description":"## API Request Description\n\n### Method\n\n**GET**\n\n### Endpoint\n\n`https://apiv3.sportsapi360.com/football/api/v1/competitions/top`\n\n### Query Parameters\n\n- **country** (string): The country code for which to retrieve the top football competitions. In this example, the value is `ES` for Spain.\n \n\n### Expected Response Format\n\nThe response will be in JSON format and includes the following fields:\n\n- **status** (boolean): Indicates whether the request was successful.\n \n- **statusCode** (integer): A code representing the status of the request.\n \n- **message** (string): A message providing additional information about the request status.\n \n- **response** (array): An array of objects containing details about the top competitions, where each object includes:\n \n - **name** (string): The name of the competition.\n \n - **category** (object): An object containing:\n \n - **name** (string): The name of the category.\n \n - **id** (integer): The unique identifier for the category.\n \n - **flag** (string): A URL or identifier for the category's flag.\n \n - **id** (integer): The unique identifier for the competition.\n \n - **displayInverseHomeAwayTeams** (boolean): A flag indicating if the home and away teams should be displayed inversely.\n \n\nThis endpoint allows users to retrieve a list of the top football competitions for a specified country, along with relevant details about each competition.","parameters":[{"name":"x-api-key","in":"header","schema":{"type":"string"}},{"name":"country","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"text/plain":{"schema":{"type":"string"}}}}}}}}} ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docsv3.sportsapi360.com/football-docs/api-collection-football/competitions.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.