Teams

Team fixtures, results, identity, and logos.

The competitor resource powers every team-scoped view in V1. Team data is embedded inline in scores/standings, plus there are two dedicated endpoints for schedules.

Endpoints

Endpoint	Returns
GET /api/v1/competitor/{id}/games	Upcoming + recent games for one team.
GET /api/v1/competitor/{id}/results	Past results, paginated, with competitionFilters[].

Both also work under a sport slug: GET /api/v1/{sport}/competitor/{id}/games.

Sample

curl -H "x-api-key: YOUR_API_KEY" \
  https://v1.football.sportsapipro.com/api/v1/competitor/131/results

{
  "competitor": { "id": 131, "name": "Real Madrid", "symbolicName": "RMA" },
  "competitionFilters": [
    { "id": 11, "name": "LaLiga", "isDefault": true },
    { "id": 572, "name": "UEFA Champions League" }
  ],
  "games": [
    {
      "id": 4467358,
      "startTime": "2026-04-04T14:15:00+00:00",
      "statusGroup": 4,
      "homeCompetitor": { "id": 142, "name": "Mallorca", "score": 2 },
      "awayCompetitor": { "id": 131, "name": "Real Madrid", "score": 1 }
    }
  ],
  "paging": { "currentPage": 1, "totalPages": 6, "nextPage": 2 }
}

Filter to a single competition with ?competitionId={id}.

Team identity fields

Anywhere a team appears (standings, scores, lineups), expect these keys:

Field	Notes
id	Stable team ID — use as your foreign key.
name / shortName / symbolicName	”FC Barcelona” / “Barcelona” / “BAR”.
nameForURL	URL-safe slug.
color / awayColor	Brand hex colors for badges.
mainCompetitionId	The league the team’s primarily playing in.
hasSquad / hasTransfers	Capability flags.
imageVersion	Cache-buster for the logo URL.

Logos

https://v1.football.sportsapipro.com/images/competitors/{id}?imageVersion={v}

No API key needed for V1 images. See Images for sizes and other entity types.

Related

• Competitions — list teams via standings.
• Head-to-Head — compare two teams directly.
• Search — resolve “Real Madrid” to ID 131.