---
title: "API-Sports integration for LuumenAI"
url: "https://www.luumen.ai/integrations/api-sports/"
entity: SoftwareIntegration
category: "Source control & CI/CD"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# API-Sports integration for LuumenAI

Query sports fixtures, standings, and player stats from your terminal

## What LuumenAI can do with API-Sports

LuumenAI connects to API-Sports with an API token and exposes 70 tools (70 read-only). Every tool is read-only, so it can answer questions from API-Sports but cannot change anything in it. Read actions still follow the configured access and approval policy.

## Key facts

- Authentication: API token
- Tools available: 70 tools (70 read-only)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: Source control & CI/CD

## About API-Sports with LuumenAI

Ask for a league table, a fixture list, or a player's box score and get the answer in the terminal. API-Sports covers competitions across football codes, basketball, baseball, and Formula 1, with seasons going back years. Luumen connects with an API key and reads only — tools like API_SPORTS_GET_BASKETBALL_STANDINGS and API_SPORTS_GET_AFL_GAMES_STATISTICS_PLAYERS return data without changing anything.

## Example tools

Read-only (70 in total):

- `API_SPORTS_GET_AFL_GAMES` — Retrieve AFL games and matches.
- `API_SPORTS_GET_AFL_GAMES_STATISTICS_PLAYERS` — Retrieve player statistics from AFL (Australian Football League) game(s).
- `API_SPORTS_GET_AFL_SEASONS` — Get the list of available seasons for AFL.
- `API_SPORTS_GET_AFL_STANDINGS` — Retrieve AFL standings for a league.
- `API_SPORTS_GET_BASEBALL_GAMES_H2H` — Get head-to-head baseball games between two teams.
- `API_SPORTS_GET_BASKETBALL_BETS` — Get all available basketball bet types.
- `API_SPORTS_GET_BASKETBALL_BOOKMAKERS` — Get all available basketball bookmakers.
- `API_SPORTS_GET_BASKETBALL_GAMES` — Retrieve Basketball games for a league and season, optionally by team.

## Frequently asked questions

### How does LuumenAI connect to API-Sports?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in API-Sports on its own?

No. Every one of the 70 tools is read-only, so LuumenAI can answer questions from API-Sports but cannot change anything in it. Read actions still follow the configured access and approval policy.

### Is there an audit trail?

Every call to API-Sports is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/api-sports/