V3 Team Endpoints

V3 team endpoints: transfers, schedule, and news

Team Endpoints

Team endpoints use string-based team IDs (e.g., Wtn9Stg0). Discover team IDs from score responses or search.

---

Team Transfers

GET /api/v1/team/{teamId}/transfers?page=0

Returns player transfers for a team with pagination.

Parameters:

• page (optional, default 0) — Page number for pagination

Transfer object fields:

• direction — "in" or "out"
• playerName, playerId, playerUrl
• type — e.g. "Transfer", "Loan", "Return from loan", "Free transfer", or "-" when unspecified
• fee — string, may be "None" when undisclosed
• fromTeam, fromTeamUrl, toTeam, toTeamUrl

---

Team Schedule

GET /api/v1/team/{teamId}/schedule?country=198&sport=1&offset=0

Returns upcoming/past fixtures for a team.

Parameters:

• country (optional) — Country ID
• sport (optional, default 1) — Sport ID
• offset (optional, default 0) — Day offset (0=today, 1=tomorrow, -1=yesterday)

---

Team News

GET /api/v1/team/{teamId}/news

Returns news articles related to the team.

Article object fields:

• title — article headline
• url — article path (relative)
• image — thumbnail URL
• timestamp — Unix seconds
• date — ISO 8601 datetime
• source — publisher name

---

Key Notes

• Team IDs in V3 are strings (e.g., "Wtn9Stg0"), not numeric like V1/V2
• Team images are returned as full URLs in score responses (e.g., "image": "https://images.sportsapipro.com/res/image/data/...")
• No separate image proxy endpoint needed — use the URL directly from the response

Example

cURL — Team Transfers

curl -H "x-api-key: YOUR_API_KEY" \
  "https://v3.football.sportsapipro.com/api/v1/team/Wtn9Stg0/transfers?page=0"