# API-Sports

API-Sports provides comprehensive sports data APIs covering over 2,000 competitions with more than 15 years of historical data, offering real-time updates and easy integration for developers.

- **Category:** developer tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 67
- **Triggers:** 0
- **Slug:** `API_SPORTS`
- **Version:** 20260309_00

## Tools

### Get AFL Games

**Slug:** `API_SPORTS_GET_AFL_GAMES`

Tool to retrieve AFL games and matches. Use when filtering games by id, date, league, season, team, or timezone to get upcoming, past, or live matches.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | No | The id of the game |
| `date` | string | No | A valid date in YYYY-MM-DD format |
| `team` | integer | No | The id of the team |
| `league` | integer | No | The id of the league |
| `season` | string | No | The season of the league (requires league parameter) |
| `timezone` | string | No | IANA timezone to retrieve games in the time zone of your choice |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get AFL Game Player Statistics

**Slug:** `API_SPORTS_GET_AFL_GAMES_STATISTICS_PLAYERS`

Tool to retrieve player statistics from AFL (Australian Football League) game(s). Use when you need detailed player performance data for specific AFL games by game ID, player ID, or season.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | The id of the game. At least one of: id, ids, or date must be provided. |
| `ids` | string | No | One or more games ids (format: id-id-id). At least one of: id, ids, or date must be provided. |
| `date` | string | No | Date to retrieve player statistics for (format: YYYY-MM-DD). At least one of: id, ids, or date must be provided. |
| `player` | integer | No | The id of the player to filter statistics by. |
| `season` | string | No | A valid season to filter statistics by. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get AFL Seasons

**Slug:** `API_SPORTS_GET_AFL_SEASONS`

Tool to get the list of available seasons for AFL. All seasons are 4-digit keys (e.g., 2018 for 2018-2019 season). Use when you need season filters for AFL endpoints.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get AFL Standings

**Slug:** `API_SPORTS_GET_AFL_STANDINGS`

Tool to retrieve AFL standings for a league. Use when needing current team rankings, points, and positions for a specific season.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `team` | integer | No | Unique identifier of the team to filter standings. |
| `league` | integer | Yes | Unique identifier of the AFL league (required with season). AFL Premiership league ID is 1. |
| `season` | integer | Yes | Season year (required). Use 4-digit year format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Baseball Games Head-to-Head

**Slug:** `API_SPORTS_GET_BASEBALL_GAMES_H2H`

Tool to get head-to-head baseball games between two teams. Use when comparing the match history between two specific baseball teams.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `h2h` | string | Yes | Team IDs in 'ID-ID' format for head-to-head comparison, e.g., '132-134' |
| `date` | string | No | Filter games by a specific date in YYYY-MM-DD format |
| `league` | integer | No | The ID of the league to filter games |
| `season` | string | No | The season of the league in YYYY or YYYY-YYYY format |
| `timezone` | string | No | Specify IANA timezone for game dates, e.g., 'Europe/London' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Basketball Bets

**Slug:** `API_SPORTS_GET_BASKETBALL_BETS`

Tool to get all available basketball bet types. Use when you need to retrieve available betting options for basketball games.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | No | The id of the bet to filter by. |
| `search` | string | No | The name of the bet to search for (partial match). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Basketball Bookmakers

**Slug:** `API_SPORTS_GET_BASKETBALL_BOOKMAKERS`

Tool to get all available basketball bookmakers. Use when you need to retrieve available bookmakers for basketball odds and betting data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | No | The id of the bookmaker to filter by. |
| `search` | string | No | The name of the bookmaker to search for (partial match). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get basketball statistics

**Slug:** `API_SPORTS_GET_BASKETBALL_STATISTICS`

Tool to get basketball statistics for a team in a given league and season. Use when you need detailed basketball team statistics including games played, wins, losses, points, and other performance metrics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | A limit date in YYYY-MM-DD format to filter statistics up to that date |
| `team` | integer | Yes | The id of the team |
| `league` | integer | Yes | The id of the basketball league |
| `season` | string | Yes | The season of the league in YYYY-YYYY format |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Formula 1 Circuits

**Slug:** `API_SPORTS_GET_CIRCUITS`

Tool to get the list of available Formula 1 circuits. Use when searching for circuits by id, competition, name, or search term.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | No | The id of the circuit |
| `name` | string | No | The name of the circuit |
| `search` | string | No | Allow to search for a circuit name |
| `competition` | integer | No | The id of the competition |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Coaches

**Slug:** `API_SPORTS_GET_COACHS`

Tool to fetch coaches and their career history. Use when you need coach info by ID, team filter, or name search.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | No | Coach ID to filter by |
| `team` | integer | No | Team ID to filter coaches by |
| `search` | string | No | Search term for coach name (min length 4) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Countries

**Slug:** `API_SPORTS_GET_COUNTRIES`

Tool to fetch available countries for league queries. Use when filtering by name, code, or search string before retrieving leagues.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `code` | string | No | Alpha-2 country code to filter by (e.g., 'FR', 'GB'). |
| `name` | string | No | Exact country name to filter by (e.g., 'Chile'). |
| `search` | string | No | Partial match search on country name (e.g., 'Uni' for 'United Kingdom'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Fighters Records

**Slug:** `API_SPORTS_GET_FIGHTERS_RECORDS`

Tool to get fighter career statistics. Use when you need a fighter's complete record including wins, losses, draws, knockouts, and submissions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The id of the fighter |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Fixtures

**Slug:** `API_SPORTS_GET_FIXTURES`

Tool to retrieve football fixtures/matches. Use when filtering fixtures by id, date, league, season, team, or date ranges to get upcoming or past matches. Always provide at least one of season, date, team, or league to avoid oversized payloads. Never guess IDs — obtain valid league, season, team, or fixture IDs before calling this tool.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | No | Unique identifier of the fixture. |
| `to` | string | No | End date for date range (YYYY-MM-DD). |
| `date` | string | No | A valid date (YYYY-MM-DD). |
| `from` | string | No | Start date for date range (YYYY-MM-DD). |
| `last` | integer | No | Number of last fixtures to retrieve. Capped at ~20 fixtures; use league with from/to for extended range coverage. |
| `live` | string | No | Get all live fixtures (all) or only those with events (all-events). |
| `next` | integer | No | Number of next fixtures to retrieve. |
| `team` | integer | No | Unique identifier of the team. |
| `round` | string | No | Round of the fixture. |
| `venue` | integer | No | Unique identifier of the venue. |
| `league` | integer | No | Unique identifier of the league. |
| `season` | integer | No | Season year (4-digit year). |
| `status` | string | No | Status of the fixture (NS, LIVE, FT, etc.). |
| `timezone` | string | No | IANA timezone for date conversion. Set correctly to avoid empty results when filtering by date, live, or status, as all times default to UTC. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get fixtures events

**Slug:** `API_SPORTS_GET_FIXTURES_EVENTS`

Tool to get events (goals, cards, substitutions, VAR, etc.) from a fixture. Use when you need detailed event data after confirming the fixture ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `team` | integer | No | ID of the team to filter events by (optional) |
| `type` | string | No | Type of event to filter (e.g., goal, card, substitution, VAR) (optional) |
| `player` | integer | No | ID of the player to filter events by (optional) |
| `fixture` | integer | Yes | ID of the fixture to fetch events for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Head-to-Head Fixtures

**Slug:** `API_SPORTS_GET_FIXTURES_HEADTOHEAD`

Tool to get head-to-head fixtures between two teams. Use after determining team IDs to compare their direct match history.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to` | string | No | End date for filtering (YYYY-MM-DD) |
| `h2h` | string | Yes | Team IDs in 'ID-ID' format, e.g., '33-34' |
| `date` | string | No | Filter fixtures by a specific date in YYYY-MM-DD format |
| `from` | string | No | Start date for filtering (YYYY-MM-DD) |
| `last` | integer | No | Number of most recent past fixtures to retrieve |
| `next` | integer | No | Number of upcoming fixtures to retrieve |
| `league` | integer | No | League ID to filter fixtures |
| `season` | integer | No | Season year in YYYY format, e.g., 2020 |
| `status` | string | No | Filter fixtures by status code, e.g., 'FT' |
| `timezone` | string | No | Specify IANA timezone, e.g., 'Europe/London' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Fixture Lineups

**Slug:** `API_SPORTS_GET_FIXTURES_LINEUPS`

Tool to retrieve starting XI and substitutes for a fixture. Use after confirming fixture ID; optionally filter by team, player, or section (startXI/substitutes). Lineups appear ~20-40 minutes before kickoff for supported competitions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `team` | integer | No | Filter by team ID |
| `type` | string ("startXI" | "substitutes") | No | Filter by lineup section: 'startXI' or 'substitutes' |
| `player` | integer | No | Filter by player ID |
| `fixture` | integer | Yes | Unique ID of the fixture |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get fixtures players

**Slug:** `API_SPORTS_GET_FIXTURES_PLAYERS`

Tool to get player statistics from a fixture. Use when you need detailed per-player stats for a specific match. Optionally filter by team.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `team` | integer | No | ID of the team to filter player statistics by (optional) |
| `fixture` | integer | Yes | ID of the fixture to retrieve player statistics for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Fixtures Rounds

**Slug:** `API_SPORTS_GET_FIXTURES_ROUNDS`

Tool to get the rounds for a league or cup. Use after confirming league and season to retrieve available round identifiers (optionally with dates) for filtering fixtures.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `dates` | boolean | No | If true, include dates of each round in the response |
| `league` | integer | Yes | League ID (from /leagues endpoint) |
| `season` | integer | Yes | Season year in YYYY format (from /leagues/seasons endpoint) |
| `current` | boolean | No | If true, only return the current round |
| `timezone` | string | No | Valid timezone (IANA) for formatting dates (from /timezone endpoint) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get fixture statistics

**Slug:** `API_SPORTS_GET_FIXTURES_STATISTICS`

Tool to get statistics for a fixture. Use when you need detailed match stats (shots, fouls, possession, cards, passes, etc.), optionally filtered by team, statistic type, or including halftime data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `half` | boolean | No | If true, includes halftime statistics in the response. Available for fixtures from the 2024 season onward. |
| `team` | integer | No | Optional team ID to filter statistics Must be obtained from upstream tools (e.g., GetTeams); never guess or fabricate. |
| `type` | string ("Shots on Goal" | "Shots off Goal" | "Shots insidebox" | "Shots outsidebox" | "Total Shots" | "Blocked Shots" | "Fouls" | "Corner Kicks" | "Offsides" | "Ball Possession" | "Yellow Cards" | "Red Cards" | "Goalkeeper Saves" | "Total passes" | "Passes accurate" | "Passes %") | No | Statistic type to filter results (must match API's available types) |
| `fixture` | integer | Yes | ID of the fixture for which statistics are requested Must be obtained from upstream tools (e.g., GetFixtures); never guess or fabricate. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Formula 1 Competitions

**Slug:** `API_SPORTS_GET_FORMULA1_COMPETITIONS`

Tool to retrieve Formula 1 competitions (Grand Prix races). Use when filtering competitions by id, name, country, city, or search term.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | No | The id of the competition |
| `city` | string | No | The name of the city |
| `name` | string | No | The name of the competition |
| `search` | string | No | Allow to search for a competition name |
| `country` | string | No | The name of the country |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Formula 1 Races

**Slug:** `API_SPORTS_GET_FORMULA1_RACES`

Tool to retrieve Formula 1 race information for a given season. Use when you need to get race schedules, results, or details for a specific Formula 1 competition season.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | No | The unique identifier of a specific race |
| `date` | string | No | A valid date to filter races (YYYY-MM-DD format) |
| `last` | integer | No | Number of last/previous races to retrieve |
| `next` | integer | No | Number of next upcoming races to retrieve |
| `type` | string ("Race" | "1st Qualifying" | "2nd Qualifying" | "3rd Qualifying" | "Sprint" | "1st Sprint Shootout" | "2nd Sprint Shootout" | "3rd Sprint Shootout" | "1st Practice" | "2nd Practice" | "3rd Practice") | No | Enum for Formula 1 race types. |
| `season` | integer | Yes | The season year for which to retrieve races (required) |
| `circuit` | integer | No | The unique identifier of the circuit to filter by |
| `timezone` | string | No | A valid IANA timezone to convert race times |
| `competition` | integer | No | The unique identifier of the competition to filter by |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Formula 1 Starting Grid

**Slug:** `API_SPORTS_GET_FORMULA1_RANKINGS_STARTINGGRID`

Tool to retrieve the starting grid for a Formula 1 race. Use when you need to get the qualifying positions and times for drivers before a race starts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `race` | integer | Yes | The id of the race (required). |
| `team` | integer | No | The id of the team to filter results. |
| `driver` | integer | No | The id of the driver to filter results. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get games events

**Slug:** `API_SPORTS_GET_GAMES_EVENTS`

Tool to get events (goals, penalties, etc.) from a game. Use when you need detailed event data after confirming the game ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `game` | integer | Yes | The ID of the game to fetch events for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get AFL Games Quarters

**Slug:** `API_SPORTS_GET_GAMES_QUARTERS`

Tool to retrieve AFL game quarter scores. Use when you need detailed scoring breakdown by quarter for one or multiple AFL games.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | No | The id of the game. |
| `ids` | string | No | One or more games ids separated by hyphens (e.g., id-id-id). |
| `date` | string | No | A valid date in YYYY-MM-DD format. |
| `timezone` | string | No | A valid IANA timezone string. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get game statistics by teams

**Slug:** `API_SPORTS_GET_GAMES_STATISTICS_TEAMS`

Tool to get team statistics from a game by ID. Use when you need detailed team stats (assists, blocks, field goals, rebounds, steals, turnovers, etc.) for a specific game or multiple games.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | The id of the game for which team statistics are requested |
| `ids` | string | No | One or more game ids separated by hyphens (e.g., '457911-457912-457913') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Injuries

**Slug:** `API_SPORTS_GET_INJURIES`

Tool to get injured or suspended players. Use when you need a list of sidelined players filtered by league, season, fixture, team, player, date, ids, or timezone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ids` | string | No | One or more fixture IDs, hyphen-separated (max 20), e.g. '123-456'. At least one of: league, fixture, team, player, date, or ids is required. |
| `date` | string | No | Date (YYYY-MM-DD) to filter injuries. At least one of: league, fixture, team, player, date, or ids is required. |
| `team` | integer | No | Team ID to filter injuries. At least one of: league, fixture, team, player, date, or ids is required. |
| `league` | integer | No | League ID to filter injuries. At least one of: league, fixture, team, player, date, or ids is required. |
| `player` | integer | No | Player ID to filter injuries. At least one of: league, fixture, team, player, date, or ids is required. |
| `season` | integer | No | Season (YYYY). Required when using league, team, or player filters. |
| `fixture` | integer | No | Fixture ID to filter injuries. At least one of: league, fixture, team, player, date, or ids is required. |
| `timezone` | string | No | Timezone name from the /timezone endpoint. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Leagues

**Slug:** `API_SPORTS_GET_LEAGUES`

Tool to retrieve leagues and cups. Use when filtering competitions by id, name, country, code, season, team, type, current, search, or last.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | No | League ID to filter by |
| `code` | string | No | Alpha code of the country (2 to 6 chars) |
| `last` | integer | No | Number of most recently added leagues or cups to return (1 to 99) |
| `name` | string | No | Name of the league or cup |
| `team` | integer | No | Team ID to filter leagues in which the team has played |
| `type` | string ("league" | "cup") | No | Competition type: 'league' or 'cup' |
| `search` | string | No | Search term for league name or country (min 3 chars) Cannot be combined with `country` in the same request. |
| `season` | integer | No | 4-digit season year (e.g., 2021) |
| `country` | string | No | Country name of the competition |
| `current` | boolean | No | Return only currently active competitions (true/false) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get League Seasons

**Slug:** `API_SPORTS_GET_LEAGUES_SEASONS`

Tool to get the list of available seasons for all leagues. Use when you need season filters for other league endpoints.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get MMA Categories

**Slug:** `API_SPORTS_GET_MMA_CATEGORIES`

Tool to fetch the list of all available MMA categories. Use when you need to get weight class categories (e.g., 'Flyweight', 'Lightweight', 'Heavyweight') for MMA fights.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `search` | string | No | The name of the category to search for (e.g., 'Flyweight'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get MMA Fighters

**Slug:** `API_SPORTS_GET_MMA_FIGHTERS`

Tool to fetch MMA fighters data. Use when you need to get fighter information by id, team, name, category, or search term.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | No | The id of the fighter |
| `name` | string | No | The name of the fighter |
| `team` | integer | No | The id of the team |
| `search` | string | No | The name of the fighter to search for |
| `category` | string | No | The category of the fighter |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get MMA Fights

**Slug:** `API_SPORTS_GET_MMA_FIGHTS`

Tool to retrieve the list of MMA fights according to given parameters. Use when filtering fights by id, date, season, fighter, or weight category to get upcoming or past MMA fight details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | No | The id of the fight. |
| `date` | string | No | A valid date in YYYY-MM-DD format to filter fights by date. |
| `season` | integer | No | A valid season year in YYYY format to filter fights by season. |
| `fighter` | integer | No | The id of the fighter to filter fights by specific fighter. When using fighter, either date or season must also be provided. |
| `category` | string | No | The name of the weight class category (e.g., 'Flyweight', 'Lightweight'). |
| `timezone` | string | No | A valid IANA timezone (e.g., 'Europe/London', 'America/New_York') for date conversion. Defaults to UTC if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get MMA Fight Results

**Slug:** `API_SPORTS_GET_MMA_FIGHTS_RESULTS`

Tool to retrieve results from one or several MMA fights. Use when you need outcome details like victory method, round, time, knockout type, or judge scores for specific fights by id(s) or date.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | No | The id of a specific fight to get results for. |
| `ids` | string | No | One or more fight ids separated by hyphens (e.g., '1-2-3') to get results for multiple fights. |
| `date` | string | No | A valid date in YYYY-MM-DD format to filter fight results by date. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get MMA Fighter Statistics

**Slug:** `API_SPORTS_GET_MMA_FIGHTS_STATISTICS_FIGHTERS`

Tool to get fighter statistics from MMA fights. Use when you need detailed strike, takedown, and grappling statistics for fighters in specific fights or on a specific date.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | No | The id of the fight |
| `ids` | string | No | One or more fights ids separated by hyphens (e.g., '1-2-3') |
| `date` | string | No | A valid date in YYYY-MM-DD format to get fighter statistics from fights on that date |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get NBA game statistics

**Slug:** `API_SPORTS_GET_NBA_GAMES_STATISTICS`

Tool to get NBA game statistics including player stats for both teams. Use when you need detailed statistics for a specific NBA game such as points, rebounds, assists, field goals, free throws, and other performance metrics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The id of the NBA game for which to retrieve statistics |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get NFL Standings Conferences

**Slug:** `API_SPORTS_GET_NFL_STANDINGS_CONFERENCES`

Tool to retrieve the list of available conferences for the NFL to be used in the standings endpoint. Use when you need to know which conferences are available for a specific NFL league and season before fetching detailed standings data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `league` | integer | Yes | The ID of the NFL league (use 1 for NFL) |
| `season` | integer | Yes | The season year in YYYY format (e.g., 2024) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Odds

**Slug:** `API_SPORTS_GET_ODDS`

Tool to fetch pre-match odds. Use when you need odds filterable by fixture, league, season, date, timezone, bookmaker, bet, or to navigate pages.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `bet` | integer | No | Filter odds by bet ID |
| `date` | string | No | Filter odds by date (YYYY-MM-DD) |
| `page` | integer | No | Page number for pagination (10 results per page) |
| `league` | integer | No | Filter odds by league ID |
| `season` | integer | No | Filter odds by season (4-digit year) |
| `fixture` | integer | No | Filter odds by fixture ID |
| `timezone` | string | No | IANA timezone for date conversion, e.g., 'Europe/London' |
| `bookmaker` | integer | No | Filter odds by bookmaker ID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Odds Bets

**Slug:** `API_SPORTS_GET_ODDS_BETS`

Tool to get all available pre-match bet types. Use when filtering by bet ID or searching bet names before fetching odds.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | No | Filter by bet ID. |
| `search` | string | No | Partial match search on bet name (minimum 3 characters). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Odds Bookmakers

**Slug:** `API_SPORTS_GET_ODDS_BOOKMAKERS`

Tool to list all available pre-match bookmakers. Use when you need to discover or filter bookmakers before fetching odds.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | No | Filter by bookmaker ID. |
| `search` | string | No | Partial match search on bookmaker name (minimum 3 characters). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get In-Play Odds

**Slug:** `API_SPORTS_GET_ODDS_LIVE`

Tool to fetch in-play odds for fixtures in progress. Use during live matches to get in-play odds.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `bet` | integer | No | Filter by bet ID for live odds. |
| `league` | integer | No | Filter by league ID for live odds. |
| `fixture` | integer | No | Filter by fixture ID for live odds. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Live Odds Bets

**Slug:** `API_SPORTS_GET_ODDS_LIVE_BETS`

Tool to fetch all available bet types for in-play odds. Use when you need to retrieve bet IDs or names (optionally filtering by id or search) before fetching live odds.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | No | Bet ID to filter by. |
| `search` | string | No | Search term for bet name (min 3 characters). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Odds Mapping

**Slug:** `API_SPORTS_GET_ODDS_MAPPING`

Tool to get the list of available fixture IDs for the odds endpoint. Use when you need to discover which fixtures have odds data available.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. Use this to navigate through paginated results. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Players

**Slug:** `API_SPORTS_GET_PLAYERS`

Tool to get player statistics. Use when fetching players by id, team, league, season, search, or pagination. Returned player IDs are used as inputs to downstream tools such as fixtures statistics, predictions, and odds.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | No | Unique player ID to filter by |
| `page` | integer | No | Page number for pagination Increment from 1 to retrieve all records when expecting large result sets. |
| `team` | integer | No | Team ID to filter players by |
| `league` | integer | No | League ID to filter players by |
| `search` | string | No | Search term for player name (min 3 chars) |
| `season` | integer | No | Season year in YYYY format Always supply to avoid ambiguous cross-season results; stats are season-specific. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Players Profiles

**Slug:** `API_SPORTS_GET_PLAYERS_PROFILES`

Tool to get the list of all available players. Use when you need player profiles optionally filtered by ID, name search, or page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `player` | integer | No | Filter by specific player ID |
| `search` | string | No | Search players by last name substring, at least 4 characters May return multiple players; cross-reference league, team, or birth data to confirm the correct player ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Players Seasons

**Slug:** `API_SPORTS_GET_PLAYERS_SEASONS`

Tool to list all available seasons for player statistics. Use when building a player statistics query, optionally filtering by a specific player id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `player` | integer | No | Player id to filter seasons by (optional) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Players Squads

**Slug:** `API_SPORTS_GET_PLAYERS_SQUADS`

Tool to get player squads. Use when fetching the current squad of a team (with team ID) or finding which teams a player belongs to (with player ID).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `team` | integer | No | Team ID to get the current squad of players. Use this to fetch all players in a team's squad. |
| `player` | integer | No | Player ID to get the set of teams associated with the player. Use this to find which team(s) a player belongs to. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get player statistics

**Slug:** `API_SPORTS_GET_PLAYERS_STATISTICS`

Tool to get player statistics for a specific basketball game. Use when you need detailed performance stats like points, rebounds, assists, field goals, three pointers, free throws, etc. Requires at least a game ID to retrieve player statistics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | Yes | The id of the game (required). This parameter must be used alone. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Players Teams

**Slug:** `API_SPORTS_GET_PLAYERS_TEAMS`

Tool to get the list of teams and seasons in which a player played during his career. Use after confirming the player ID to retrieve club history.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `player` | integer | Yes | Unique ID of the player. |
| `season` | integer | No | Season year to filter results (e.g., 2020). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Players Top Assists

**Slug:** `API_SPORTS_GET_PLAYERS_TOP_ASSISTS`

Tool to get the 20 best players (top assists) for a league or cup. Use after confirming league and season.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `league` | integer | Yes | League ID to retrieve top assist players for An incorrect ID silently returns data for the wrong league with no error. |
| `season` | string | Yes | Season year (e.g., 2023) Always provide explicitly; omitting may return unintended season data. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Players Top Red Cards

**Slug:** `API_SPORTS_GET_PLAYERS_TOP_RED_CARDS`

Tool to get the 20 players with the most red cards for a league or cup. Use after confirming league and season.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `team` | integer | No | Team ID to filter the top red cards leaderboard |
| `league` | integer | Yes | League ID to retrieve top red card players for |
| `season` | string | Yes | Season year (e.g., 2023) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Players Top Scorers

**Slug:** `API_SPORTS_GET_PLAYERS_TOP_SCORERS`

Tool to get the 20 best players (top scorers) for a league or cup. Use after confirming league and season.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `team` | integer | No | Team ID to filter the top scorers leaderboard |
| `league` | integer | Yes | League ID to retrieve top scorers for Must be exact; an incorrect ID silently returns data for a different league with no error. |
| `season` | string | Yes | Season year (e.g., 2023) Required; omitting or passing null defaults to the current season and may return unintended data. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Players Top Yellow Cards

**Slug:** `API_SPORTS_GET_PLAYERS_TOP_YELLOW_CARDS`

Tool to get the 20 players with the most yellow cards for a league or cup. Use after confirming league and season.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `team` | integer | No | Team ID to filter the top yellow cards leaderboard |
| `league` | integer | Yes | League ID to retrieve top yellow card players for |
| `season` | string | Yes | Season year (e.g., 2023) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Predictions

**Slug:** `API_SPORTS_GET_PREDICTIONS`

Tool to get predictions about a fixture. Use when you need calculated predictions for a given fixture ID. Predictions may not be available for all fixtures; empty or null responses indicate no predictions exist, not an error.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fixture` | integer | Yes | Fixture ID to retrieve predictions for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Formula 1 Driver Rankings

**Slug:** `API_SPORTS_GET_RANKINGS_DRIVERS`

Tool to retrieve Formula 1 driver rankings for a season. Use when querying driver standings, championship positions, or filtering by specific driver or team.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `team` | integer | No | The id of the team to filter by. |
| `driver` | integer | No | The id of the driver to filter by. |
| `season` | integer | Yes | The season year (required). Must be a 4-digit year. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Fastest Laps Rankings

**Slug:** `API_SPORTS_GET_RANKINGS_FASTEST_LAPS`

Tool to get the ranking of the fastest laps for a Formula 1 race. Use when retrieving fastest lap times, speeds, and rankings by race, team, or driver.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `race` | integer | Yes | The id of the race |
| `team` | integer | No | The id of the team to filter by |
| `driver` | integer | No | The id of the driver to filter by |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Race Rankings

**Slug:** `API_SPORTS_GET_RANKINGS_RACES`

Tool to retrieve rankings for a specific Formula 1 race. Use when you need to get finishing positions, lap times, and pit stop information for drivers in a race.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `race` | integer | Yes | The id of the race |
| `team` | integer | No | The id of the team to filter rankings |
| `driver` | integer | No | The id of the driver to filter rankings |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Formula 1 Team Rankings

**Slug:** `API_SPORTS_GET_RANKINGS_TEAMS`

Tool to retrieve Formula 1 team rankings for a specific season. Use when you need to get championship standings showing teams ordered by points.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `team` | integer | No | The ID of a specific team to filter rankings. If provided, returns only the ranking for that team. |
| `season` | string | Yes | The season year for which to retrieve team rankings (e.g., '2023'). This parameter is required. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Sidelined

**Slug:** `API_SPORTS_GET_SIDELINED`

Tool to get sidelined information (injuries, suspensions, etc.). Use when you need current sidelined records filtered by player or coach.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `coach` | integer | No | Coach ID to filter sidelined records. At least one of coach or player must be provided. |
| `player` | integer | No | Player ID to filter sidelined records. At least one of coach or player must be provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Standings Divisions

**Slug:** `API_SPORTS_GET_STANDINGS_DIVISIONS`

Tool to retrieve the list of available divisions for an NFL competition to be used in the standings endpoint. Use when you need to know which divisions are available for a specific league and season before fetching detailed standings data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `league` | integer | Yes | The ID of the NFL league (e.g., 1 for NFL) |
| `season` | integer | Yes | The season year in 4-digit format (e.g., 2024) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Standings Groups

**Slug:** `API_SPORTS_GET_STANDINGS_GROUPS`

Tool to retrieve the list of available groups for a league to be used in the standings endpoint. Use when querying standings groups for a specific league and season before fetching detailed standings data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `league` | integer | Yes | The ID of the league |
| `season` | string | Yes | The season of the league in format YYYY or YYYY-YYYY |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Standings Stages

**Slug:** `API_SPORTS_GET_STANDINGS_STAGES`

Tool to retrieve the list of available stages for a league to be used in the standings endpoint. Use when you need to know which stages or groups are available for a specific league and season before fetching standings data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `league` | integer | Yes | The ID of the league |
| `season` | string | Yes | The season of the league (format: YYYY or YYYY-YYYY, e.g., '2023-2024') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Teams

**Slug:** `API_SPORTS_GET_TEAMS`

Tool to retrieve available teams. Use when filtering teams by id, name, league, season, country, code, venue, or search before fetching detailed team data. Team IDs are not inferrable from names; use `name` or `search` to look up and confirm the correct `id` before passing it to downstream requests.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | No | Unique identifier of the team. |
| `code` | string | No | Three-letter team code (e.g., 'MUN' for Manchester United). |
| `name` | string | No | Name of the team. |
| `venue` | integer | No | Unique identifier of the team's home venue. |
| `league` | integer | No | Unique identifier of the league to filter teams. |
| `search` | string | No | Search term for team name (min length 3). |
| `season` | integer | No | Season year (e.g., 2021). |
| `country` | string | No | Name of the country the team represents. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Team Seasons

**Slug:** `API_SPORTS_GET_TEAMS_SEASONS`

Tool to get the list of seasons available for a team. Use when you need to know which seasons a specific team has data for.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `team` | integer | Yes | The id of the team |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get team statistics

**Slug:** `API_SPORTS_GET_TEAMS_STATISTICS`

Tool to get detailed statistics of a team for a given league and season. Use after confirming league, season, and team ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `to` | string | No | End date for filtering stats (YYYY-MM-DD) |
| `date` | string | No | Limit statistics up to a certain date (YYYY-MM-DD) |
| `from` | string | No | Start date for filtering stats (YYYY-MM-DD) |
| `team` | integer | Yes | Team ID for which to retrieve statistics |
| `venue` | string ("home" | "away") | No | Filter statistics by venue: 'home' or 'away' |
| `league` | integer | Yes | League ID for which to retrieve team statistics |
| `season` | integer | Yes | Season year of the league (e.g., 2022) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Timezone

**Slug:** `API_SPORTS_GET_TIMEZONE`

Tool to fetch the complete list of available timezones for fixture queries. Use when you need valid timezone identifiers (e.g., 'Europe/London') before calling fixtures endpoints.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Transfers

**Slug:** `API_SPORTS_GET_TRANSFERS`

Tool to get all available transfers for players and teams. Use when you need transfer history filtered by player or team.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `team` | integer | No | Team ID to filter transfers by (optional) |
| `player` | integer | No | Player ID to filter transfers by (optional) |
| `season` | integer | No | Season year to filter transfers by (optional) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Trophies

**Slug:** `API_SPORTS_GET_TROPHIES`

Tool to get trophies for a player or coach. Use when you need to list honors filtered by player(s) or coach(es).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `coach` | integer | No | Coach ID to filter trophies by |
| `coachs` | string | No | Dash-separated list of up to 20 coach IDs (e.g. '2-6-44') |
| `player` | integer | No | Player ID to filter trophies by |
| `players` | string | No | Dash-separated list of up to 20 player IDs (e.g. '276-278') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Venues

**Slug:** `API_SPORTS_GET_VENUES`

Tool to retrieve available venues. Use when filtering venues by id, name, city, country, or search before fetching detailed venue data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | integer | No | The id of the venue. |
| `city` | string | No | The city of the venue. |
| `name` | string | No | The name of the venue. |
| `search` | string | No | The name, city or the country of the venue. |
| `country` | string | No | The country name of the venue. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
