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.
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. On Nagent, API-Sports is exposed as a fully-configurable developer tools integration that any agent can call — 67 actions, and API key authentication. No code is required to wire API-Sports into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use API-Sports to automate the kinds of tasks developer tools teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire API-Sports into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against API-Sports, with input parameters and output schema. Drop these into any step of an agent built in Helix.
API_SPORTS_GET_AFL_GAMESTool 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
The id of the game
A valid date in YYYY-MM-DD format
The id of the team
The id of the league
The season of the league (requires league parameter)
IANA timezone to retrieve games in the time zone of your choice
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_AFL_GAMES_STATISTICS_PLAYERSTool 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
The id of the game. At least one of: id, ids, or date must be provided.
One or more games ids (format: id-id-id). At least one of: id, ids, or date must be provided.
Date to retrieve player statistics for (format: YYYY-MM-DD). At least one of: id, ids, or date must be provided.
The id of the player to filter statistics by.
A valid season to filter statistics by.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_AFL_SEASONSTool 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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_AFL_STANDINGSTool to retrieve AFL standings for a league. Use when needing current team rankings, points, and positions for a specific season.
Input parameters
Unique identifier of the team to filter standings.
Unique identifier of the AFL league (required with season). AFL Premiership league ID is 1.
Season year (required). Use 4-digit year format.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_BASEBALL_GAMES_H2HTool to get head-to-head baseball games between two teams. Use when comparing the match history between two specific baseball teams.
Input parameters
Team IDs in 'ID-ID' format for head-to-head comparison, e.g., '132-134'
Filter games by a specific date in YYYY-MM-DD format
The ID of the league to filter games
The season of the league in YYYY or YYYY-YYYY format
Specify IANA timezone for game dates, e.g., 'Europe/London'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_BASKETBALL_BETSTool to get all available basketball bet types. Use when you need to retrieve available betting options for basketball games.
Input parameters
The id of the bet to filter by.
The name of the bet to search for (partial match).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_BASKETBALL_BOOKMAKERSTool to get all available basketball bookmakers. Use when you need to retrieve available bookmakers for basketball odds and betting data.
Input parameters
The id of the bookmaker to filter by.
The name of the bookmaker to search for (partial match).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_BASKETBALL_STATISTICSTool 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
A limit date in YYYY-MM-DD format to filter statistics up to that date
The id of the team
The id of the basketball league
The season of the league in YYYY-YYYY format
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_CIRCUITSTool to get the list of available Formula 1 circuits. Use when searching for circuits by id, competition, name, or search term.
Input parameters
The id of the circuit
The name of the circuit
Allow to search for a circuit name
The id of the competition
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_COACHSTool to fetch coaches and their career history. Use when you need coach info by ID, team filter, or name search.
Input parameters
Coach ID to filter by
Team ID to filter coaches by
Search term for coach name (min length 4)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_COUNTRIESTool to fetch available countries for league queries. Use when filtering by name, code, or search string before retrieving leagues.
Input parameters
Alpha-2 country code to filter by (e.g., 'FR', 'GB').
Exact country name to filter by (e.g., 'Chile').
Partial match search on country name (e.g., 'Uni' for 'United Kingdom').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_FIGHTERS_RECORDSTool to get fighter career statistics. Use when you need a fighter's complete record including wins, losses, draws, knockouts, and submissions.
Input parameters
The id of the fighter
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_FIXTURESTool 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
Unique identifier of the fixture.
End date for date range (YYYY-MM-DD).
A valid date (YYYY-MM-DD).
Start date for date range (YYYY-MM-DD).
Number of last fixtures to retrieve. Capped at ~20 fixtures; use league with from/to for extended range coverage.
Get all live fixtures (all) or only those with events (all-events).
Number of next fixtures to retrieve.
Unique identifier of the team.
Round of the fixture.
Unique identifier of the venue.
Unique identifier of the league.
Season year (4-digit year).
Status of the fixture (NS, LIVE, FT, etc.).
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_FIXTURES_EVENTSTool 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
ID of the team to filter events by (optional)
Type of event to filter (e.g., goal, card, substitution, VAR) (optional)
ID of the player to filter events by (optional)
ID of the fixture to fetch events for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_FIXTURES_HEADTOHEADTool to get head-to-head fixtures between two teams. Use after determining team IDs to compare their direct match history.
Input parameters
End date for filtering (YYYY-MM-DD)
Team IDs in 'ID-ID' format, e.g., '33-34'
Filter fixtures by a specific date in YYYY-MM-DD format
Start date for filtering (YYYY-MM-DD)
Number of most recent past fixtures to retrieve
Number of upcoming fixtures to retrieve
League ID to filter fixtures
Season year in YYYY format, e.g., 2020
Filter fixtures by status code, e.g., 'FT'
Specify IANA timezone, e.g., 'Europe/London'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_FIXTURES_LINEUPSTool 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
Filter by team ID
Filter by lineup section: 'startXI' or 'substitutes'
Filter by player ID
Unique ID of the fixture
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_FIXTURES_PLAYERSTool 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
ID of the team to filter player statistics by (optional)
ID of the fixture to retrieve player statistics for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_FIXTURES_ROUNDSTool 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
If true, include dates of each round in the response
League ID (from /leagues endpoint)
Season year in YYYY format (from /leagues/seasons endpoint)
If true, only return the current round
Valid timezone (IANA) for formatting dates (from /timezone endpoint)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_FIXTURES_STATISTICSTool 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
If true, includes halftime statistics in the response. Available for fixtures from the 2024 season onward.
Optional team ID to filter statistics Must be obtained from upstream tools (e.g., GetTeams); never guess or fabricate.
Statistic type to filter results (must match API's available types)
ID of the fixture for which statistics are requested Must be obtained from upstream tools (e.g., GetFixtures); never guess or fabricate.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_FORMULA1_COMPETITIONSTool to retrieve Formula 1 competitions (Grand Prix races). Use when filtering competitions by id, name, country, city, or search term.
Input parameters
The id of the competition
The name of the city
The name of the competition
Allow to search for a competition name
The name of the country
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_FORMULA1_RACESTool 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
The unique identifier of a specific race
A valid date to filter races (YYYY-MM-DD format)
Number of last/previous races to retrieve
Number of next upcoming races to retrieve
Enum for Formula 1 race types.
The season year for which to retrieve races (required)
The unique identifier of the circuit to filter by
A valid IANA timezone to convert race times
The unique identifier of the competition to filter by
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_FORMULA1_RANKINGS_STARTINGGRIDTool 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
The id of the race (required).
The id of the team to filter results.
The id of the driver to filter results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_GAMES_EVENTSTool to get events (goals, penalties, etc.) from a game. Use when you need detailed event data after confirming the game ID.
Input parameters
The ID of the game to fetch events for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_GAMES_QUARTERSTool to retrieve AFL game quarter scores. Use when you need detailed scoring breakdown by quarter for one or multiple AFL games.
Input parameters
The id of the game.
One or more games ids separated by hyphens (e.g., id-id-id).
A valid date in YYYY-MM-DD format.
A valid IANA timezone string.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_GAMES_STATISTICS_TEAMSTool 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
The id of the game for which team statistics are requested
One or more game ids separated by hyphens (e.g., '457911-457912-457913')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_INJURIESTool 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
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 (YYYY-MM-DD) to filter injuries. At least one of: league, fixture, team, player, date, or ids is required.
Team ID to filter injuries. At least one of: league, fixture, team, player, date, or ids is required.
League ID to filter injuries. At least one of: league, fixture, team, player, date, or ids is required.
Player ID to filter injuries. At least one of: league, fixture, team, player, date, or ids is required.
Season (YYYY). Required when using league, team, or player filters.
Fixture ID to filter injuries. At least one of: league, fixture, team, player, date, or ids is required.
Timezone name from the /timezone endpoint.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_LEAGUESTool to retrieve leagues and cups. Use when filtering competitions by id, name, country, code, season, team, type, current, search, or last.
Input parameters
League ID to filter by
Alpha code of the country (2 to 6 chars)
Number of most recently added leagues or cups to return (1 to 99)
Name of the league or cup
Team ID to filter leagues in which the team has played
Competition type: 'league' or 'cup'
Search term for league name or country (min 3 chars) Cannot be combined with `country` in the same request.
4-digit season year (e.g., 2021)
Country name of the competition
Return only currently active competitions (true/false)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_LEAGUES_SEASONSTool to get the list of available seasons for all leagues. Use when you need season filters for other league endpoints.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_MMA_CATEGORIESTool 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
The name of the category to search for (e.g., 'Flyweight').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_MMA_FIGHTERSTool to fetch MMA fighters data. Use when you need to get fighter information by id, team, name, category, or search term.
Input parameters
The id of the fighter
The name of the fighter
The id of the team
The name of the fighter to search for
The category of the fighter
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_MMA_FIGHTSTool 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
The id of the fight.
A valid date in YYYY-MM-DD format to filter fights by date.
A valid season year in YYYY format to filter fights by season.
The id of the fighter to filter fights by specific fighter. When using fighter, either date or season must also be provided.
The name of the weight class category (e.g., 'Flyweight', 'Lightweight').
A valid IANA timezone (e.g., 'Europe/London', 'America/New_York') for date conversion. Defaults to UTC if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_MMA_FIGHTS_RESULTSTool 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
The id of a specific fight to get results for.
One or more fight ids separated by hyphens (e.g., '1-2-3') to get results for multiple fights.
A valid date in YYYY-MM-DD format to filter fight results by date.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_MMA_FIGHTS_STATISTICS_FIGHTERSTool 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
The id of the fight
One or more fights ids separated by hyphens (e.g., '1-2-3')
A valid date in YYYY-MM-DD format to get fighter statistics from fights on that date
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_NBA_GAMES_STATISTICSTool 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
The id of the NBA game for which to retrieve statistics
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_NFL_STANDINGS_CONFERENCESTool 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
The ID of the NFL league (use 1 for NFL)
The season year in YYYY format (e.g., 2024)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_ODDSTool 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
Filter odds by bet ID
Filter odds by date (YYYY-MM-DD)
Page number for pagination (10 results per page)
Filter odds by league ID
Filter odds by season (4-digit year)
Filter odds by fixture ID
IANA timezone for date conversion, e.g., 'Europe/London'
Filter odds by bookmaker ID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_ODDS_BETSTool to get all available pre-match bet types. Use when filtering by bet ID or searching bet names before fetching odds.
Input parameters
Filter by bet ID.
Partial match search on bet name (minimum 3 characters).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_ODDS_BOOKMAKERSTool to list all available pre-match bookmakers. Use when you need to discover or filter bookmakers before fetching odds.
Input parameters
Filter by bookmaker ID.
Partial match search on bookmaker name (minimum 3 characters).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_ODDS_LIVETool to fetch in-play odds for fixtures in progress. Use during live matches to get in-play odds.
Input parameters
Filter by bet ID for live odds.
Filter by league ID for live odds.
Filter by fixture ID for live odds.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_ODDS_LIVE_BETSTool 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
Bet ID to filter by.
Search term for bet name (min 3 characters).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_ODDS_MAPPINGTool 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
Page number for pagination. Use this to navigate through paginated results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_PLAYERSTool 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
Unique player ID to filter by
Page number for pagination Increment from 1 to retrieve all records when expecting large result sets.
Team ID to filter players by
League ID to filter players by
Search term for player name (min 3 chars)
Season year in YYYY format Always supply to avoid ambiguous cross-season results; stats are season-specific.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_PLAYERS_PROFILESTool to get the list of all available players. Use when you need player profiles optionally filtered by ID, name search, or page.
Input parameters
Page number for pagination
Filter by specific player ID
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_PLAYERS_SEASONSTool to list all available seasons for player statistics. Use when building a player statistics query, optionally filtering by a specific player id.
Input parameters
Player id to filter seasons by (optional)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_PLAYERS_SQUADSTool 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
Team ID to get the current squad of players. Use this to fetch all players in a team's squad.
Player ID to get the set of teams associated with the player. Use this to find which team(s) a player belongs to.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_PLAYERS_STATISTICSTool 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
The id of the game (required). This parameter must be used alone.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_PLAYERS_TEAMSTool 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
Unique ID of the player.
Season year to filter results (e.g., 2020).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_PLAYERS_TOP_ASSISTSTool to get the 20 best players (top assists) for a league or cup. Use after confirming league and season.
Input parameters
League ID to retrieve top assist players for An incorrect ID silently returns data for the wrong league with no error.
Season year (e.g., 2023) Always provide explicitly; omitting may return unintended season data.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_PLAYERS_TOP_RED_CARDSTool to get the 20 players with the most red cards for a league or cup. Use after confirming league and season.
Input parameters
Page number for pagination
Team ID to filter the top red cards leaderboard
League ID to retrieve top red card players for
Season year (e.g., 2023)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_PLAYERS_TOP_SCORERSTool to get the 20 best players (top scorers) for a league or cup. Use after confirming league and season.
Input parameters
Page number for pagination
Team ID to filter the top scorers leaderboard
League ID to retrieve top scorers for Must be exact; an incorrect ID silently returns data for a different league with no error.
Season year (e.g., 2023) Required; omitting or passing null defaults to the current season and may return unintended data.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_PLAYERS_TOP_YELLOW_CARDSTool to get the 20 players with the most yellow cards for a league or cup. Use after confirming league and season.
Input parameters
Page number for pagination
Team ID to filter the top yellow cards leaderboard
League ID to retrieve top yellow card players for
Season year (e.g., 2023)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_PREDICTIONSTool 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
Fixture ID to retrieve predictions for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_RANKINGS_DRIVERSTool 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
The id of the team to filter by.
The id of the driver to filter by.
The season year (required). Must be a 4-digit year.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_RANKINGS_FASTEST_LAPSTool 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
The id of the race
The id of the team to filter by
The id of the driver to filter by
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_RANKINGS_RACESTool 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
The id of the race
The id of the team to filter rankings
The id of the driver to filter rankings
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_RANKINGS_TEAMSTool 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
The ID of a specific team to filter rankings. If provided, returns only the ranking for that team.
The season year for which to retrieve team rankings (e.g., '2023'). This parameter is required.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_SIDELINEDTool to get sidelined information (injuries, suspensions, etc.). Use when you need current sidelined records filtered by player or coach.
Input parameters
Coach ID to filter sidelined records. At least one of coach or player must be provided.
Player ID to filter sidelined records. At least one of coach or player must be provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_STANDINGS_DIVISIONSTool 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
The ID of the NFL league (e.g., 1 for NFL)
The season year in 4-digit format (e.g., 2024)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_STANDINGS_GROUPSTool 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
The ID of the league
The season of the league in format YYYY or YYYY-YYYY
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_STANDINGS_STAGESTool 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
The ID of the league
The season of the league (format: YYYY or YYYY-YYYY, e.g., '2023-2024')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_TEAMSTool 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
Unique identifier of the team.
Three-letter team code (e.g., 'MUN' for Manchester United).
Name of the team.
Unique identifier of the team's home venue.
Unique identifier of the league to filter teams.
Search term for team name (min length 3).
Season year (e.g., 2021).
Name of the country the team represents.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_TEAMS_SEASONSTool 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
The id of the team
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_TEAMS_STATISTICSTool to get detailed statistics of a team for a given league and season. Use after confirming league, season, and team ID.
Input parameters
End date for filtering stats (YYYY-MM-DD)
Limit statistics up to a certain date (YYYY-MM-DD)
Start date for filtering stats (YYYY-MM-DD)
Team ID for which to retrieve statistics
Filter statistics by venue: 'home' or 'away'
League ID for which to retrieve team statistics
Season year of the league (e.g., 2022)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_TIMEZONETool 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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_TRANSFERSTool to get all available transfers for players and teams. Use when you need transfer history filtered by player or team.
Input parameters
Team ID to filter transfers by (optional)
Player ID to filter transfers by (optional)
Season year to filter transfers by (optional)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_TROPHIESTool to get trophies for a player or coach. Use when you need to list honors filtered by player(s) or coach(es).
Input parameters
Coach ID to filter trophies by
Dash-separated list of up to 20 coach IDs (e.g. '2-6-44')
Player ID to filter trophies by
Dash-separated list of up to 20 player IDs (e.g. '276-278')
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
API_SPORTS_GET_VENUESTool to retrieve available venues. Use when filtering venues by id, name, city, country, or search before fetching detailed venue data.
Input parameters
The id of the venue.
The city of the venue.
The name of the venue.
The name, city or the country of the venue.
The country name of the venue.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 56 agents privately built on Nagent that already use API-Sports.
Build on Nagent
Connect API-Sports to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find API-Sports, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, API-Sports is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once API-Sports is connected, you configure its 67 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop API-Sports steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a API-Sports event fires, the agent kicks off automatically.
Every API-Sports action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While API-Sports ships with 67 pre-built developer tools actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching API-Sports together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build API-Sports-based workflows tailored to your business.