Teams & Players API Endpoints

Overview

Endpoints for retrieving team rosters, player information, statistics, and fantasy data.

Endpoint Summary

Endpoint Method Auth Description
/v1/teams GET None Get all teams
/v1/teams-schedule GET None Get team schedules
/v1/team-standings GET None Get team standings
/v1/players GET None Get all players
/v1/teams/{teamId}/players GET None Get players by team
/v1/players/fantasy GET None Get fantasy player data
/v1/players/fantasy-predictions GET None Get fantasy predictions
/v1/players/fantasy-markets GET None Get fantasy market data
/v1/players/fantasy/predictions/season GET None Get season fantasy predictions
/v1/matches/players/stats GET None Get player match stats
/v1/matches/players/league-season-stats GET None Get player season stats

Teams Endpoints

1. GET /v1/teams

Description: Retrieves a list of all teams with optional filtering.

Query Parameters:

Parameter Type Description
LeagueId long[] Filter by league IDs
SportId long[] Filter by sport IDs
TeamId long[] Filter specific team IDs
Limit int Maximum results

Response: IEnumerable<Team>

[
  {
    "id": 123,
    "name": "Dallas Cowboys",
    "code": "DAL",
    "colorHex": "#003594",
    "colorHexSecondary": "#869397",
    "colorHexTertiary": "#FFFFFF",
    "city": "Dallas",
    "logoUrl": "https://cdn.example.com/teams/cowboys.png",
    "websiteUrl": "https://www.dallascowboys.com",
    "geoLocationImageUrl": "https://...",
    "stockImageUrl": "https://...",
    "wikipediaUrl": "https://en.wikipedia.org/wiki/Dallas_Cowboys",
    "leagueFranchise": true,
    "sportId": 1,
    "sportCode": "NFL",
    "sportName": "Football",
    "sportLogoUrl": "https://...",
    "leagueId": 1,
    "leagueCode": "NFL",
    "leagueName": "National Football League",
    "leagueLogoUrl": "https://...",
    "analysisText": "The Cowboys are..."
  }
]

Response Fields:

Field Type Description
id long Unique team identifier
name string Full team name
code string Short team code (e.g., "DAL")
colorHex string Primary team color
colorHexSecondary string Secondary team color
colorHexTertiary string Tertiary team color
city string Team city
logoUrl string Team logo URL
websiteUrl string Official team website
geoLocationImageUrl string Map/location image
stockImageUrl string Stock team image
wikipediaUrl string Wikipedia page URL
leagueFranchise bool Whether team is a league franchise
sportId long Sport identifier
sportCode string Sport code
sportName string Sport name
leagueId long League identifier
leagueCode string League code
leagueName string League name
analysisText string Team analysis/description

2. GET /v1/teams-schedule or /v1/team-schedules

Description: Retrieves team schedule information.

Query Parameters:

Parameter Type Description
TeamId long[] Team IDs to get schedules for
LeagueId long[] Filter by league
StartDate DateTime Schedule start date
EndDate DateTime Schedule end date

Response: TeamScheduleResponse

{
  "teams": [
    {
      "teamId": 123,
      "teamName": "Dallas Cowboys",
      "schedule": [
        {
          "matchId": 12345,
          "date": "2025-11-29",
          "opponent": "New York Giants",
          "homeAway": "home",
          "time": "4:25 PM ET"
        }
      ]
    }
  ]
}

3. GET /v1/team-standings or /v1/teams-standing

Description: Retrieves team standings information.

Query Parameters:

Parameter Type Description
LeagueId long[] Filter by league
LeagueBreakdownLevelId long[] Filter by division/conference

Response: TeamScheduleResponse (standings format)

{
  "teams": [
    {
      "teamId": 123,
      "teamName": "Dallas Cowboys",
      "wins": 8,
      "losses": 3,
      "ties": 0,
      "winPercentage": 0.727,
      "conferenceRecord": "5-2",
      "divisionRecord": "3-1",
      "streak": "W2"
    }
  ]
}

Players Endpoints

4. GET /v1/players

Description: Retrieves a list of all players with optional filtering.

Query Parameters:

Parameter Type Description
TeamId long[] Filter by team IDs
LeagueId long[] Filter by league
PlayerName string Search by player name
Limit int Maximum results

Response: IEnumerable<Player>

[
  {
    "id": 456,
    "name": "Dak Prescott",
    "position": "QB",
    "number": 4,
    "teamId": 123,
    "teamName": "Dallas Cowboys",
    "imageUrl": "https://...",
    "status": "Active"
  }
]

5. GET /v1/teams/{teamId}/players

Description: Retrieves all players for a specific team.

Path Parameters:

Query Parameters:

Parameter Type Description
Limit int Maximum results

Response: IEnumerable<Player>

6. GET /v1/players/fantasy

Description: Retrieves fantasy sports player data including projections.

Query Parameters:

Parameter Type Description
LeagueId long[] Filter by league
Date DateTime Specific date
Limit int Maximum results

Response: Fantasy player data with projections

7. GET /v1/players/fantasy-predictions

Description: Retrieves fantasy predictions for upcoming games.

Query Parameters:

Parameter Type Description
LeagueId long[] Filter by league
Date DateTime Prediction date
MatchIds long[] Filter by match IDs

Response: Fantasy prediction data

8. GET /v1/players/fantasy-markets

Description: Retrieves fantasy market data (props, lines).

Query Parameters:

Parameter Type Description
LeagueId long[] Filter by league
Date DateTime Market date

Response: Fantasy market data

9. GET /v1/players/fantasy/predictions/season

Description: Retrieves season-long fantasy predictions.

Query Parameters:

Parameter Type Description
LeagueId long[] Filter by league

Response: Season fantasy predictions

Player Stats Endpoints

10. GET /v1/matches/players/stats

Description: Retrieves player statistics for matches.

Query Parameters:

Parameter Type Description
MatchIds long[] Match IDs to get stats for
TeamId long[] Filter by team

Response: MatchesPlayersStatsResponse

11. GET /v1/matches/players/league-season-stats

Description: Retrieves season statistics for players.

Query Parameters:

Parameter Type Description
LeagueId long[] Filter by league
TeamId long[] Filter by team

Response: PlayersSeasonStatsResponse

Examples

Get All NFL Teams

curl -X GET "https://api.example.com/v1/teams?LeagueId=1"

Get Cowboys Roster

curl -X GET "https://api.example.com/v1/teams/123/players"

Get NFL Standings

curl -X GET "https://api.example.com/v1/team-standings?LeagueId=1"

Get Fantasy Predictions for Today

curl -X GET "https://api.example.com/v1/players/fantasy-predictions?LeagueId=1&Date=2025-11-29"

Search Players by Name

curl -X GET "https://api.example.com/v1/players?PlayerName=Prescott"

Related Endpoints