Skip to main content

Team Endpoints

Team endpoints use string-based team IDs (e.g., Wtn9Stg0).

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
Response:
{
  "teamId": "Wtn9Stg0",
  "page": 0,
  "transfers": [
    {
      "direction": "in",
      "playerName": "Savinho",
      "fromTeam": "Troyes",
      "toTeam": "Manchester City",
      "type": "Transfer",
      "fee": "€40M",
      "date": "2025-07-01",
      "country": "Brazil",
      "position": "Forward"
    }
  ]
}

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)
Response:
{
  "teamId": "Wtn9Stg0",
  "teamName": "Manchester City",
  "fixtures": [
    {
      "id": "xpzR5OKq",
      "date": "2026-04-04T15:00:00.000Z",
      "league": "Premier League",
      "homeTeam": { "name": "Manchester City", "id": "Wtn9Stg0" },
      "awayTeam": { "name": "Arsenal", "id": "ppjDR086" },
      "status": "finished",
      "homeScore": 2,
      "awayScore": 1
    },
    {
      "id": "yzAB1CDe",
      "date": "2026-04-11T15:00:00.000Z",
      "league": "Premier League",
      "homeTeam": { "name": "Chelsea", "id": "hKmJn3pQ" },
      "awayTeam": { "name": "Manchester City", "id": "Wtn9Stg0" },
      "status": "not_started",
      "homeScore": null,
      "awayScore": null
    }
  ]
}

Team News

GET /api/v1/team/{teamId}/news
Returns news articles related to the team. Response:
{
  "teamId": "Wtn9Stg0",
  "teamName": "Manchester City",
  "articles": [
    {
      "title": "Manchester City confirm new signing",
      "description": "The club have completed the transfer of...",
      "url": "https://example.com/article/456",
      "publishedAt": "2026-04-03T10:00:00.000Z",
      "source": "Sports News"
    }
  ]
}