Recent Form

GET

competitors

recentForm

Team Recent Form

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

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.sportsapipro.com/v1/basketball/competitors/recentForm', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sportsapipro.com/v1/basketball/competitors/recentForm",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sportsapipro.com/v1/basketball/competitors/recentForm"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sportsapipro.com/v1/basketball/competitors/recentForm")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

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

integer

required

The competitor/team ID to retrieve recent form for

integer

default:"5"

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

integer

Application type identifier (auto-resolved)

integer

Language identifier (auto-resolved)

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.

integer

User’s country for localization (auto-resolved)

Response Structure

array

Array of sport definitions

Show Sport Object

integer

Sport ID

string

Sport name

string

URL-friendly name

boolean

Whether draws are possible

integer

Image version for caching

array

Array of country definitions for teams in the results

Show Country Object

integer

Country ID

string

Country name

string

URL-friendly name

array

Sport type IDs available

integer

Image version

boolean

International region flag

array

Array of competitions the team played in

Show Competition Object

integer

Competition ID

integer

Country ID

integer

Sport ID

string

Competition name

string

Full competition name

string

Abbreviated name

boolean

Has league standings

boolean

Has tournament brackets

boolean

Has statistics

string

URL-friendly name

integer

Popularity ranking

integer

Image version

string

Brand color (hex)

integer

Current season number

boolean

International competition

boolean

Has historical data

array

Array of all teams involved in the matches

Show Competitor Object

integer

Competitor ID

integer

Country ID

integer

Sport ID

string

Team name

string

Abbreviated name

string

Full official name

string

3-letter code

number

Score in last match

boolean

Won last match

string

URL-friendly name

integer

Image version

string

Primary color (hex)

string

Away kit color (hex)

integer

Primary league ID

boolean

Has squad data

integer

Red cards (if any)

array

Array of recent match results

Show Game Object

integer

Game ID

integer

Sport ID

integer

Competition ID

integer

Season number

integer

Stage number

integer

Round number

string

Round name

string

Full display name

string

ISO 8601 start time

integer

Status group (4=Ended)

string

Human-readable status

string

Abbreviated status

object

Home team with score and outcome

object

Away team with score and outcome

integer

Match outcome for requested team

integer

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

array

Array of [homeScore, awayScore]

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://api.sportsapipro.com/v1/football/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

Form Analysis: Display W-D-L streak (e.g., “WWWWW” for 5 consecutive wins)
Betting Insights: Analyze recent performance before placing bets
Match Previews: Show both teams’ recent form before a match
Team Profiles: Display current momentum and recent results
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

Last modified on June 29, 2026

Team Recent Form

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

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.sportsapipro.com/v1/basketball/competitors/recentForm', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sportsapipro.com/v1/basketball/competitors/recentForm",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sportsapipro.com/v1/basketball/competitors/recentForm"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.sportsapipro.com/v1/basketball/competitors/recentForm")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

API Reference

Guides

Popular Sports

Team Sports

Racquet & Precision Sports

Specialty Sports

V3 API

V4 Odds API

V6 AiScore API

V1 Legacy

Football V1

Basketball V1

Tennis V1

Hockey V1

Overview

Query Parameters

Response Structure

Outcome Values

Winner Values

Example Request

Example Response

Use Cases

Calculating Form String

Authorizations

Query Parameters

Response

​Overview

​Query Parameters

​Response Structure

​Outcome Values

​Winner Values

​Example Request

​Example Response

​Use Cases

​Calculating Form String

Authorizations

Query Parameters

Response

Overview

Query Parameters

Response Structure

Outcome Values

Winner Values

Example Request

Example Response

Use Cases

Calculating Form String