Recent Form

Retrieve a team’s recent match results to analyze current form and performance trends

GET /competitors/recentForm

Team Recent Form

cURL

curl --request GET \
  --url https://v1.basketball.sportsapipro.com/competitors/recentForm \
  --header 'x-api-key: <api-key>'

Overview

The Recent Form endpoint returns a team’s most recent completed matches, showing wins, draws, and losses. This data is essential for form analysis, betting insights, and understanding a team’s current momentum.

Query Parameters

competitor · integer · required

The competitor/team ID to retrieve recent form for

numOfGames · integer · default: "5"

Number of recent games to return (typically 5-10)

appTypeId · integer

Application type identifier (auto-resolved)

langId · integer

Language identifier (auto-resolved)

timezoneName · string

Timezone for date/time values (auto-resolved, or specify e.g., America/New_York). All startTime fields use ISO 8601 format with a dynamic timezone offset.

userCountryId · integer

User’s country for localization (auto-resolved)

Response Structure

sports · array

Array of sport definitions

Show Sport Object

id · integer

Sport ID

name · string

Sport name

nameForURL · string

URL-friendly name

drawSupport · boolean

Whether draws are possible

imageVersion · integer

Image version for caching

countries · array

Array of country definitions for teams in the results

Show Country Object

id · integer

Country ID

name · string

Country name

nameForURL · string

URL-friendly name

sportTypes · array

Sport type IDs available

imageVersion · integer

Image version

isInternational · boolean

International region flag

competitions · array

Array of competitions the team played in

Show Competition Object

id · integer

Competition ID

countryId · integer

Country ID

sportId · integer

Sport ID

name · string

Competition name

longName · string

Full competition name

shortName · string

Abbreviated name

hasStandings · boolean

Has league standings

hasBrackets · boolean

Has tournament brackets

hasStats · boolean

Has statistics

nameForURL · string

URL-friendly name

popularityRank · integer

Popularity ranking

imageVersion · integer

Image version

color · string

Brand color (hex)

currentSeasonNum · integer

Current season number

isInternational · boolean

International competition

hasHistory · boolean

Has historical data

competitors · array

Array of all teams involved in the matches

Show Competitor Object

id · integer

Competitor ID

countryId · integer

Country ID

sportId · integer

Sport ID

name · string

Team name

shortName · string

Abbreviated name

longName · string

Full official name

symbolicName · string

3-letter code

score · number

Score in last match

isWinner · boolean

Won last match

nameForURL · string

URL-friendly name

imageVersion · integer

Image version

color · string

Primary color (hex)

awayColor · string

Away kit color (hex)

mainCompetitionId · integer

Primary league ID

hasSquad · boolean

Has squad data

redCards · integer

Red cards (if any)

games · array

Array of recent match results

Show Game Object

id · integer

Game ID

sportId · integer

Sport ID

competitionId · integer

Competition ID

seasonNum · integer

Season number

stageNum · integer

Stage number

roundNum · integer

Round number

roundName · string

Round name

competitionDisplayName · string

Full display name

startTime · string

ISO 8601 start time

statusGroup · integer

Status group (4=Ended)

statusText · string

Human-readable status

shortStatusText · string

Abbreviated status

homeCompetitor · object

Home team with score and outcome

awayCompetitor · object

Away team with score and outcome

outcome · integer

Match outcome for requested team

winner · integer

Winner indicator (1=home, 2=away, 0=draw)

scores · array

Array of [homeScore, awayScore]

hasVideo · boolean

Video highlights available

Outcome Values

Value	Description
1	Win
2	Draw
3	Loss

Winner Values

Value	Description
0	Draw
1	Home team won
2	Away team won

Example Request

curl -X GET "https://v1.football.sportsapipro.com/competitors/recentForm?competitor=110&numOfGames=5" \
  -H "x-api-key: YOUR_API_KEY"

Example Response

{
  "sports": [
    {
      "id": 1,
      "name": "Football",
      "nameForURL": "football",
      "drawSupport": true,
      "imageVersion": 1
    }
  ],
  "countries": [
    {
      "id": 1,
      "name": "England",
      "nameForURL": "england",
      "imageVersion": 1
    }
  ],
  "competitions": [
    {
      "id": 7,
      "countryId": 1,
      "sportId": 1,
      "name": "Premier League",
      "shortName": "EPL",
      "hasStandings": true,
      "nameForURL": "premier-league",
      "color": "#075C9C"
    },
    {
      "id": 572,
      "countryId": 19,
      "sportId": 1,
      "name": "UEFA Champions League",
      "shortName": "UCL",
      "nameForURL": "uefa-champions-league",
      "color": "#09123E"
    }
  ],
  "competitors": [
    {
      "id": 110,
      "name": "Manchester City",
      "shortName": "Man City",
      "symbolicName": "MCI",
      "imageVersion": 1,
      "color": "#ABD1F5"
    }
  ],
  "games": [
    {
      "id": 4609055,
      "sportId": 1,
      "competitionId": 9,
      "competitionDisplayName": "EFL Cup - Quarter Finals",
      "startTime": "2025-12-17T19:30:00+00:00",
      "statusGroup": 4,
      "statusText": "Ended",
      "homeCompetitor": {
        "id": 110,
        "name": "Manchester City",
        "shortName": "Man City",
        "score": 2.0,
        "isWinner": true,
        "outcome": 1
      },
      "awayCompetitor": {
        "id": 63,
        "name": "Brentford",
        "score": 0.0,
        "isWinner": false,
        "outcome": 1
      },
      "outcome": 1,
      "winner": 1,
      "scores": [2.0, 0.0]
    },
    {
      "id": 4452723,
      "competitionDisplayName": "Premier League",
      "startTime": "2025-12-14T14:00:00+00:00",
      "statusText": "Ended",
      "homeCompetitor": {
        "id": 10,
        "name": "Crystal Palace",
        "score": 0.0,
        "isWinner": false,
        "outcome": 1
      },
      "awayCompetitor": {
        "id": 110,
        "name": "Manchester City",
        "score": 3.0,
        "isWinner": true,
        "outcome": 1
      },
      "outcome": 1,
      "winner": 2,
      "scores": [0.0, 3.0]
    }
  ]
}

Use Cases

1. Form Analysis: Display W-D-L streak (e.g., “WWWWW” for 5 consecutive wins)
2. Betting Insights: Analyze recent performance before placing bets
3. Match Previews: Show both teams’ recent form before a match
4. Team Profiles: Display current momentum and recent results
5. Head-to-Head Context: Combine with H2H data for comprehensive analysis

Calculating Form String

const getFormString = (games, competitorId) => {
  return games.map(game => {
    const isHome = game.homeCompetitor.id === competitorId;
    const teamScore = isHome ? game.scores[0] : game.scores[1];
    const oppScore = isHome ? game.scores[1] : game.scores[0];
    
    if (teamScore > oppScore) return 'W';
    if (teamScore < oppScore) return 'L';
    return 'D';
  }).join('');
};

// Example: "WWWWW" for Manchester City's last 5 games

Authorizations

x-api-key · string · header · required

Your SportsAPI Pro API key

Query Parameters

competitor · integer · required

Team/Competitor ID

Example:

2827

numOfGames · integer · default: 5

Number of recent games to return

Response

200

Recent form retrieved successfully