> ## Documentation Index > Fetch the complete documentation index at: https://docs.sportsapipro.com/llms.txt > Use this file to discover all available pages before exploring further. # Recent Form > Retrieve a team's recent match results to analyze current form and performance trends ## 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 The competitor/team ID to retrieve recent form for Number of recent games to return (typically 5-10) Application type identifier (auto-resolved) Language identifier (auto-resolved) 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. User's country for localization (auto-resolved) ## Response Structure Array of sport definitions Sport ID Sport name URL-friendly name Whether draws are possible Image version for caching Array of country definitions for teams in the results Country ID Country name URL-friendly name Sport type IDs available Image version International region flag Array of competitions the team played in Competition ID Country ID Sport ID Competition name Full competition name Abbreviated name Has league standings Has tournament brackets Has statistics URL-friendly name Popularity ranking Image version Brand color (hex) Current season number International competition Has historical data Array of all teams involved in the matches Competitor ID Country ID Sport ID Team name Abbreviated name Full official name 3-letter code Score in last match Won last match URL-friendly name Image version Primary color (hex) Away kit color (hex) Primary league ID Has squad data Red cards (if any) Array of recent match results Game ID Sport ID Competition ID Season number Stage number Round number Round name Full display name ISO 8601 start time Status group (4=Ended) Human-readable status Abbreviated status Home team with score and outcome Away team with score and outcome Match outcome for requested team Winner indicator (1=home, 2=away, 0=draw) Array of \[homeScore, awayScore] 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 ```bash theme={null} curl -X GET "https://v1.football.sportsapipro.com/competitors/recentForm?competitor=110&numOfGames=5" \ -H "x-api-key: YOUR_API_KEY" ``` ## Example Response ```json theme={null} { "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 ```javascript theme={null} 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 ``` ## OpenAPI ````yaml GET /competitors/recentForm openapi: 3.1.0 info: title: SportsAPI Pro - Basketball API description: >- Professional basketball data API providing live scores, standings, player statistics, betting odds, and more for NBA, EuroLeague, and 50+ leagues worldwide. version: 1.0.0 contact: name: SportsAPI Pro Support email: support@sportsapipro.com servers: - url: https://v1.basketball.sportsapipro.com description: Production API Server security: - ApiKeyAuth: [] tags: - name: Games description: Live scores, fixtures, and game data - name: Competitions description: Leagues and tournaments - name: Standings description: League standings and rankings - name: Athletes description: Player statistics and data - name: Betting description: Betting lines, props, and predictions - name: Search description: Search entities - name: Account description: Account status and usage paths: /competitors/recentForm: get: tags: - Competitions summary: Team Recent Form description: Get recent game results and form for a basketball team operationId: getRecentForm parameters: - name: competitor in: query required: true description: Team/Competitor ID schema: type: integer example: 2827 - name: numOfGames in: query description: Number of recent games to return schema: type: integer default: 5 responses: '200': description: Recent form retrieved successfully components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: Your SportsAPI Pro API key ````