Teams

Look up teams and players across all sports and leagues. Returns team names, aliases, league memberships, and current event counts. Useful for building search/autocomplete, mapping team names across sportsbooks, and understanding what’s currently active.

GET /api/v1/teams

Authentication

Requires an API key. Available on all tiers (Free included). Unauthenticated requests return 401.

Query Parameters

Example Requests

# Get all NBA teams
curl "https://api.sharpapi.io/api/v1/teams?league=NBA" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Search for a team by name
curl "https://api.sharpapi.io/api/v1/teams?q=lakers" \
  -H "X-API-Key: YOUR_API_KEY"
 
# Get all basketball teams
curl "https://api.sharpapi.io/api/v1/teams?sport=basketball" \
  -H "X-API-Key: YOUR_API_KEY"

// Search for a team
const response = await fetch(
  'https://api.sharpapi.io/api/v1/teams?q=arsenal',
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } },
);
const { data, meta } = await response.json();
 
data.forEach(team => {
  console.log(`${team.name} (${team.sport}) - ${team.event_count} events`);
  if (team.aliases.length) {
    console.log(`  Also known as: ${team.aliases.join(', ')}`);
  }
});

import requests
 
response = requests.get(
    'https://api.sharpapi.io/api/v1/teams',
    params={'sport': 'basketball', 'league': 'NBA'},
    headers={'X-API-Key': 'YOUR_API_KEY'},
)
result = response.json()
 
print(f"Found {result['meta']['count']} NBA teams")
for team in result['data'][:10]:
    aliases = ', '.join(team['aliases']) if team['aliases'] else 'none'
    print(f"  {team['name']} ({team['id']}) - aliases: {aliases}")

Response

Success (200)

{
  "data": [
    {
      "id": "arsenal",
      "numerical_id": 1042,
      "name": "Arsenal",
      "abbreviation": "ARS",
      "logo": "https://cdn.opticodds.com/team-logos/soccer/12.png",
      "city": "London",
      "mascot": "Arsenal",
      "conference": "England - Premier League",
      "division": null,
      "sport": "soccer",
      "leagues": [
        "EPL",
        "England - FA Cup",
        "England - Premier League",
        "England - EFL Cup"
      ],
      "aliases": [
        "Arsenal Fc"
      ],
      "event_count": 18,
      "live_count": 0
    },
    {
      "id": "alabama-crimson-tide",
      "numerical_id": 318,
      "name": "Alabama Crimson Tide",
      "abbreviation": "ALA",
      "logo": "https://cdn.opticodds.com/team-logos/basketball/333.png",
      "city": "Alabama",
      "mascot": "Crimson Tide",
      "conference": "SEC",
      "division": null,
      "sport": "basketball",
      "leagues": [
        "NCAAB"
      ],
      "aliases": [
        "Alabama",
        "Bama",
        "Crimson Tide"
      ],
      "event_count": 6,
      "live_count": 0
    }
  ],
  "meta": {
    "count": 15038,
    "sport_filter": null,
    "league_filter": null,
    "query": null,
    "total_events": 17113,
    "total_live": 13160,
    "updated": "2026-02-11T21:00:00.000Z"
  }
}

Team Object Schema

New (May 2026): numerical_id, abbreviation, and team metadata

numerical_id is a frozen, dense-from-1 integer assigned per team in the SharpAPI atlas (~24,000 entries across all sports). The new metadata fields (abbreviation, logo, city, mascot, conference, division) are sourced from the SharpAPI atlas and populated for the broad majority of teams (≈93% on logo, with comparable coverage on the rest).

• Frozen: numerical_id is never reused or remapped, even if the team renames or moves leagues.
• Optional: every new field is absent (or null) for teams that haven’t been mapped or for individual-sport competitors (tennis players, MMA fighters, golfers, drivers — they’re not “teams” in the conventional sense). The slug id and name are always present.
• Domain-scoped: numerical_id is unique across teams only.

Every odds row and opportunity leg also carries home and away blocks with the same shape ({id, numerical_id, name, abbreviation, logo, city, mascot, conference, division}), so you don’t need to second-fetch this endpoint just to label rows. See Entity reference IDs for the full contract.

Meta Object

Use Cases

Team Name Mapping

Different sportsbooks use different names for the same team. The aliases field helps you map across books:

curl "https://api.sharpapi.io/api/v1/teams?q=man%20city"

{
  "id": "manchester-city",
  "name": "Manchester City",
  "aliases": ["Man City", "Manchester City Fc", "Man. City"]
}

Search / Autocomplete

Use the q parameter to power a search-as-you-type UI:

curl "https://api.sharpapi.io/api/v1/teams?q=lak"

Active Teams

Filter by event_count or live_count client-side to show only teams with current or live events.

Related Endpoints

• Events - Get events for specific teams
• Leagues - List available leagues
• Sports - List available sports