Available operations
| Method | Path | Purpose |
|---|---|---|
| GET | /v1/football/teams | Search and paginate the team catalog. |
| GET | /v1/football/teams/{team_id} | Retrieve one team by stable ID. |
Search
Use q for a case-insensitive name search. Results can contain clubs with similar names, so retain the returned ID and country metadata rather than matching by display name alone.
Example
GET /v1/football/teams?q=united&page=1&limit=25
Current scope
The beta team record covers identity and country metadata. Squads, players, injuries, lineups, and team statistics are planned operations and are not silently synthesized.