Manager, Referee & Venue Endpoints

Base URL

https://api.sportsapipro.com/v2/football

Finding IDs: Get manager, referee, and venue IDs from match details (/api/match/{matchId}). The response includes referee.id, venue.id, and manager data. You can also use /api/match/{matchId}/managers for manager IDs.

Shortcut for current team manager + home venue. GET /api/teams/{teamId} already returns the current manager object (name, shortName, country, id) and venue (name, capacity, city) in one call — no need to chain through match details. See World Cup 2026 — Managers & Venues.

Manager Endpoints

Manager Details

GET /api/managers/{managerId}

Returns manager profile: name, nationality, age, date of birth, current team, and preferred formation.

number

required

Numeric manager ID (e.g., 793451). Discover from match details or match managers endpoint.

Example response

Recorded 24 September 2026 from GET /v2/football/managers/811325 (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "manager": {
      "name": "Ralf Kettemann",
      "slug": "ralf-kettemann",
      "shortName": "R. Kettemann",
      "sport": {
        "name": "Football",
        "slug": "football",
        "id": 1
      },
      "teams": [
        {
          "name": "SC Paderborn 07",
          "slug": "sc-paderborn-07",
          "shortName": "Paderborn",
          "gender": "M",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "category": {
            "name": "Germany",
            "slug": "germany",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "priority": 8,
            "id": 30,
            "flag": "germany",
            "alpha2": "DE",
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "ألمانيا",
                "bn": "জার্মানি",
                "hi": "जर्मनी",
                "ru": "Германия"
              },
              "shortNameTranslation": {}
            },
            "transferPeriod": [
              {
                "activeFrom": "06-01 00:00",
                "activeTo": "09-18 00:00"
              }
            ]
          },
          "tournament": {
            "name": "2. Bundesliga",
            "slug": "2-bundesliga",
            "category": {
              "name": "Germany",
              "slug": "germany",
              "sport": {
                "name": "Football",
                "slug": "football",
                "id": 1
              },
              "priority": 8,
              "id": 30,
              "flag": "germany",
              "alpha2": "DE",
              "fieldTranslations": {
                "nameTranslation": {
                  "ar": "ألمانيا",
                  "bn": "জার্মানি",
                  "hi": "जर्मनी",
                  "ru": "Германия"
                },
                "shortNameTranslation": {}
              },
              "transferPeriod": [
                {
                  "activeFrom": "06-01 00:00",
                  "activeTo": "09-18 00:00"
                }
              ]
            },
            "uniqueTournament": {
              "name": "2. Bundesliga",
              "slug": "2-bundesliga",
              "primaryColorHex": "#919292",
              "secondaryColorHex": "#d20616",
              "category": {
                "name": "Germany",
                "slug": "germany",
                "sport": {
                  "name": "Football",
                  "slug": "football",
                  "id": 1
                },
                "priority": 8,
                "id": 30,
                "flag": "germany",
                "alpha2": "DE",
                "fieldTranslations": {
                  "nameTranslation": "...",
                  "shortNameTranslation": "..."
                },
                "transferPeriod": [
                  {
                    "activeFrom": "06-01 00:00",
                    "activeTo": "09-18 00:00"
                  }
                ]
              },
              "userCount": 57928,
              "hasPerformanceGraphFeature": true,
              "liveActivityEnabled": true,
              "id": 44,
              "displayInverseHomeAwayTeams": false,
              "fieldTranslations": {
                "nameTranslation": {
                  "ar": "الدوري الألماني الدرجة الثانية",
                  "bn": "2. বুন্দেসলিগা",
                  "hi": "2. बुंडेसलीगा",
                  "ru": "Бундеслига 2"
                },
                "shortNameTranslation": {}
              }
            },
            "priority": 355,
            "isLive": false,
            "id": 41,
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "الدوري الألماني الدرجة الثانية",
                "bn": "2. বুন্দেসলিগা",
                "hi": "2. बुंडेसलीगा",
                "ru": "Бундеслига 2"
              },
              "shortNameTranslation": {}
            }
          },
          "primaryUniqueTournament": {
            "name": "Bundesliga",
            "slug": "bundesliga",
            "primaryColorHex": "#e2080e",
            "secondaryColorHex": "#8e0902",
            "category": {
              "name": "Germany",
              "slug": "germany",
              "sport": {
                "name": "Football",
                "slug": "football",
                "id": 1
              },
              "priority": 8,
              "id": 30,
              "flag": "germany",
              "alpha2": "DE",
              "fieldTranslations": {
                "nameTranslation": {
                  "ar": "ألمانيا",
                  "bn": "জার্মানি",
                  "hi": "जर्मनी",
                  "ru": "Германия"
                },
                "shortNameTranslation": {}
              },
              "transferPeriod": [
                {
                  "activeFrom": "06-01 00:00",
                  "activeTo": "09-18 00:00"
                }
              ]
            },
            "userCount": 565701,
            "hasPerformanceGraphFeature": true,
            "liveActivityEnabled": true,
            "id": 35,
            "displayInverseHomeAwayTeams": false,
            "fieldTranslations": {
              "nameTranslation": {
                "bn": "বুন্দেসলীগা",
                "ar": "الدوري الألماني",
                "hi": "बुंडेसलीगा",
                "ru": "Бундеслига"
              },
              "shortNameTranslation": {}
            }
          },
          "userCount": 33644,
          "nameCode": "PAD",
          "disabled": false,
          "national": false,
          "type": 0,
          "id": 2561,
          "fullName": "SC Paderborn 07",
          "teamColors": {
            "primary": "#0000bb",
            "secondary": "#0000a6",
            "text": "#0000a6"
          },
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "بادربورن",
              "hi": "एससी पेडरबोर्न 07",
              "ru": "Падерборн 07"
            },
            "shortNameTranslation": {
              "ar": "بادربورن",
              "bn": "প্যাডারবর্ন",
              "hi": "पेडरबॉर्न",
              "ru": "Падерборн 07"
            }
          }
        }
      ],
      "preferredFormation": "3-4-2-1",
      "deceased": false,
      "country": {
        "alpha2": "DE",
        "name": "Germany"
      },
      "id": 811325,
      "team": {
        "name": "SC Paderborn 07",
        "slug": "sc-paderborn-07",
        "shortName": "Paderborn",
        "gender": "M",
        "sport": {
          "name": "Football",
          "slug": "football",
          "id": 1
        },
        "category": {
          "name": "Germany",
          "slug": "germany",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "priority": 8,
          "id": 30,
          "flag": "germany",
          "alpha2": "DE",
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "ألمانيا",
              "bn": "জার্মানি",
              "hi": "जर्मनी",
              "ru": "Германия"
            },
            "shortNameTranslation": {}
          },
          "transferPeriod": [
            {
              "activeFrom": "06-01 00:00",
              "activeTo": "09-18 00:00"
            }
          ]
        },
        "tournament": {
          "name": "2. Bundesliga",
          "slug": "2-bundesliga",
          "category": {
            "name": "Germany",
            "slug": "germany",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "priority": 8,
            "id": 30,
            "flag": "germany",
            "alpha2": "DE",
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "ألمانيا",
                "bn": "জার্মানি",
                "hi": "जर्मनी",
                "ru": "Германия"
              },
              "shortNameTranslation": {}
            },
            "transferPeriod": [
              {
                "activeFrom": "06-01 00:00",
                "activeTo": "09-18 00:00"
              }
            ]
          },
          "uniqueTournament": {
            "name": "2. Bundesliga",
            "slug": "2-bundesliga",
            "primaryColorHex": "#919292",
            "secondaryColorHex": "#d20616",
            "category": {
              "name": "Germany",
              "slug": "germany",
              "sport": {
                "name": "Football",
                "slug": "football",
                "id": 1
              },
              "priority": 8,
              "id": 30,
              "flag": "germany",
              "alpha2": "DE",
              "fieldTranslations": {
                "nameTranslation": {
                  "ar": "ألمانيا",
                  "bn": "জার্মানি",
                  "hi": "जर्मनी",
                  "ru": "Германия"
                },
                "shortNameTranslation": {}
              },
              "transferPeriod": [
                {
                  "activeFrom": "06-01 00:00",
                  "activeTo": "09-18 00:00"
                }
              ]
            },
            "userCount": 57928,
            "hasPerformanceGraphFeature": true,
            "liveActivityEnabled": true,
            "id": 44,
            "displayInverseHomeAwayTeams": false,
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "الدوري الألماني الدرجة الثانية",
                "bn": "2. বুন্দেসলিগা",
                "hi": "2. बुंडेसलीगा",
                "ru": "Бундеслига 2"
              },
              "shortNameTranslation": {}
            }
          },
          "priority": 355,
          "isLive": false,
          "id": 41,
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "الدوري الألماني الدرجة الثانية",
              "bn": "2. বুন্দেসলিগা",
              "hi": "2. बुंडेसलीगा",
              "ru": "Бундеслига 2"
            },
            "shortNameTranslation": {}
          }
        },
        "primaryUniqueTournament": {
          "name": "Bundesliga",
          "slug": "bundesliga",
          "primaryColorHex": "#e2080e",
          "secondaryColorHex": "#8e0902",
          "category": {
            "name": "Germany",
            "slug": "germany",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "priority": 8,
            "id": 30,
            "flag": "germany",
            "alpha2": "DE",
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "ألمانيا",
                "bn": "জার্মানি",
                "hi": "जर्मनी",
                "ru": "Германия"
              },
              "shortNameTranslation": {}
            },
            "transferPeriod": [
              {
                "activeFrom": "06-01 00:00",
                "activeTo": "09-18 00:00"
              }
            ]
          },
          "userCount": 565701,
          "hasPerformanceGraphFeature": true,
          "liveActivityEnabled": true,
          "id": 35,
          "displayInverseHomeAwayTeams": false,
          "fieldTranslations": {
            "nameTranslation": {
              "bn": "বুন্দেসলীগা",
              "ar": "الدوري الألماني",
              "hi": "बुंडेसलीगा",
              "ru": "Бундеслига"
            },
            "shortNameTranslation": {}
          }
        },
        "userCount": 33644,
        "nameCode": "PAD",
        "disabled": false,
        "national": false,
        "type": 0,
        "id": 2561,
        "fullName": "SC Paderborn 07",
        "teamColors": {
          "primary": "#0000bb",
          "secondary": "#0000a6",
          "text": "#0000a6"
        },
        "fieldTranslations": {
          "nameTranslation": {
            "ar": "بادربورن",
            "hi": "एससी पेडरबोर्न 07",
            "ru": "Падерборн 07"
          },
          "shortNameTranslation": {
            "ar": "بادربورن",
            "bn": "প্যাডারবর্ন",
            "hi": "पेडरबॉर्न",
            "ru": "Падерборн 07"
          }
        }
      },
      "nationality": "DEU",
      "nationalityISO2": "DE",
      "performance": {
        "total": 265,
        "wins": 138,
        "draws": 48,
        "losses": 79,
        "goalsScored": 502,
        "goalsConceded": 349,
        "totalPoints": 462
      },
      "dateOfBirthTimestamp": 524880000,
      "fieldTranslations": {
        "nameTranslation": {
          "ar": "رالف كيتيمان",
          "ru": "Ральф Кеттеманн"
        },
        "shortNameTranslation": {
          "ar": "ر. كيتيمان",
          "ru": "Р. Кеттеманн"
        }
      }
    }
  }
}

Manager Image

GET /api/managers/{managerId}/image

Returns the manager’s profile photo URL.

Example response

Recorded 24 September 2026 from GET /v2/football/managers/811325/image (lists trimmed to 2 items).

{
  "success": true,
  "managerId": 811325,
  "imageUrl": "https://api.provider.app/api/v1/manager/811325/image"
}

Manager Career History

GET /api/managers/{managerId}/career-history

Returns the complete managerial career history: teams managed, start/end dates, and win/draw/loss records per club.

There is no /api/managers/{managerId}/career endpoint — it returns 404 for every manager ID. Use /career-history as shown above.

Example response

Recorded 24 September 2026 from GET /v2/football/managers/811325/career-history (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "careerHistory": [
      {
        "team": {
          "name": "SC Paderborn 07",
          "slug": "sc-paderborn-07",
          "shortName": "Paderborn",
          "gender": "M",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "userCount": 33644,
          "nameCode": "PAD",
          "disabled": false,
          "national": false,
          "type": 0,
          "id": 2561,
          "teamColors": {
            "primary": "#0000bb",
            "secondary": "#0000a6",
            "text": "#0000a6"
          },
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "بادربورن",
              "hi": "एससी पेडरबोर्न 07",
              "ru": "Падерборн 07"
            },
            "shortNameTranslation": {
              "ar": "بادربورن",
              "bn": "প্যাডারবর্ন",
              "hi": "पेडरबॉर्न",
              "ru": "Падерборн 07"
            }
          }
        },
        "performance": {
          "total": 41,
          "wins": 20,
          "draws": 10,
          "losses": 11,
          "totalPoints": 70
        },
        "startTimestamp": 1751328000
      },
      {
        "team": {
          "name": "Karlsruher SC U19",
          "slug": "karlsruher-sc-u19",
          "shortName": "Karlsruhe U19",
          "gender": "M",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "userCount": 417,
          "nameCode": "KSC",
          "disabled": false,
          "national": false,
          "type": 0,
          "id": 43726,
          "teamColors": {
            "primary": "#0000dd",
            "secondary": "#0000a0",
            "text": "#0000a0"
          },
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "كارلشروهر إس سي تحت 19",
              "hi": "कार्ल्सरूहेर ऐससी U19",
              "ru": "Карлсрухер СК У19 U19"
            },
            "shortNameTranslation": {}
          }
        },
        "performance": {
          "total": 100,
          "wins": 58,
          "draws": 16,
          "losses": 26,
          "totalPoints": 190
        },
        "startTimestamp": 1625097600,
        "endTimestamp": 1751241600
      }
    ]
  }
}

Manager Last Events

GET /api/managers/{managerId}/events/last/{page}

Returns recent matches managed, paginated with results and scores.

number

required

Page number (0-indexed).

Example response

Recorded 24 September 2026 from GET /v2/football/managers/811325/events/last/0 (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "events": [
      {
        "eventState": {},
        "tournament": {
          "name": "2. Bundesliga",
          "slug": "2-bundesliga",
          "category": {
            "name": "Germany",
            "slug": "germany",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "priority": 8,
            "id": 30,
            "flag": "germany",
            "alpha2": "DE",
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "ألمانيا",
                "bn": "জার্মানি",
                "hi": "जर्मनी",
                "ru": "Германия"
              },
              "shortNameTranslation": {}
            }
          },
          "uniqueTournament": {
            "name": "2. Bundesliga",
            "slug": "2-bundesliga",
            "primaryColorHex": "#919292",
            "secondaryColorHex": "#d20616",
            "category": {
              "name": "Germany",
              "slug": "germany",
              "sport": {
                "name": "Football",
                "slug": "football",
                "id": 1
              },
              "priority": 8,
              "id": 30,
              "flag": "germany",
              "alpha2": "DE",
              "fieldTranslations": {
                "nameTranslation": {
                  "ar": "ألمانيا",
                  "bn": "জার্মানি",
                  "hi": "जर्मनी",
                  "ru": "Германия"
                },
                "shortNameTranslation": {}
              }
            },
            "userCount": 57928,
            "hasPerformanceGraphFeature": true,
            "liveActivityEnabled": true,
            "id": 44,
            "hasEventPlayerStatistics": true,
            "displayInverseHomeAwayTeams": false,
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "الدوري الألماني الدرجة الثانية",
                "bn": "2. বুন্দেসলিগা",
                "hi": "2. बुंडेसलीगा",
                "ru": "Бундеслига 2"
              },
              "shortNameTranslation": {}
            }
          },
          "priority": 355,
          "isGroup": false,
          "isLive": false,
          "id": 41,
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "الدوري الألماني الدرجة الثانية",
              "bn": "2. বুন্দেসলিগা",
              "hi": "2. बुंडेसलीगा",
              "ru": "Бундеслига 2"
            },
            "shortNameTranslation": {}
          }
        },
        "season": {
          "name": "2. Bundesliga 25/26",
          "year": "25/26",
          "editor": false,
          "id": 77354
        },
        "roundInfo": {
          "round": 18
        },
        "customId": "lbbsybb",
        "status": {
          "code": 100,
          "description": "Ended",
          "type": "finished"
        },
        "winnerCode": 1,
        "homeTeam": {
          "name": "Holstein Kiel",
          "slug": "holstein-kiel",
          "shortName": "Kiel",
          "gender": "M",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "userCount": 33638,
          "nameCode": "HOK",
          "disabled": false,
          "national": false,
          "type": 0,
          "id": 2573,
          "subTeams": [],
          "teamColors": {
            "primary": "#000099",
            "secondary": "#000099",
            "text": "#000099"
          },
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "هولشتاين كيل",
              "hi": "होल्सटीन किएल",
              "ru": "Хольштайн Киль"
            },
            "shortNameTranslation": {
              "ar": "كيل",
              "bn": "কিয়েল",
              "hi": "कील"
            }
          }
        },
        "awayTeam": {
          "name": "SC Paderborn 07",
          "slug": "sc-paderborn-07",
          "shortName": "Paderborn",
          "gender": "M",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "userCount": 33644,
          "nameCode": "PAD",
          "disabled": false,
          "national": false,
          "type": 0,
          "id": 2561,
          "subTeams": [],
          "teamColors": {
            "primary": "#0000bb",
            "secondary": "#0000a6",
            "text": "#0000a6"
          },
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "بادربورن",
              "hi": "एससी पेडरबोर्न 07",
              "ru": "Падерборн 07"
            },
            "shortNameTranslation": {
              "ar": "بادربورن",
              "bn": "প্যাডারবর্ন",
              "hi": "पेडरबॉर्न",
              "ru": "Падерборн 07"
            }
          }
        },
        "homeScore": {
          "current": 2,
          "display": 2,
          "period1": 1,
          "period2": 1,
          "normaltime": 2
        },
        "awayScore": {
          "current": 0,
          "display": 0,
          "period1": 0,
          "period2": 0,
          "normaltime": 0
        },
        "time": {
          "injuryTime1": 2,
          "injuryTime2": 8,
          "currentPeriodStartTimestamp": 1768743260
        },
        "changes": {
          "changes": [
            "status.code"
          ],
          "changeTimestamp": 1768746921
        },
        "hasGlobalHighlights": false,
        "hasXg": true,
        "hasEventPlayerStatistics": true,
        "hasEventPlayerHeatMap": true,
        "detailId": 1,
        "crowdsourcingDataDisplayEnabled": false,
        "correctAiInsight": false,
        "correctHalftimeAiInsight": false,
        "id": 14065402,
        "slug": "holstein-kiel-sc-paderborn-07",
        "startTimestamp": 1768739400,
        "finalResultOnly": false,
        "...": "3 more fields"
      }
    ],
    "hasNextPage": true,
    "incidentsMap": {
      "14065402": {
        "yellowCards": 1
      },
      "14065424": {
        "yellowCards": 1
      },
      "14065441": {
        "yellowCards": 1
      },
      "14065477": {
        "yellowCards": 1
      }
    },
    "managedTeamMap": {
      "14065402": 2561,
      "14065411": 2561,
      "14065424": 2561,
      "14065441": 2561,
      "14065449": 2561,
      "14065458": 2561,
      "14065466": 2561,
      "14065477": 2561,
      "14065485": 2561,
      "14065497": 2561,
      "14065502": 2561,
      "14065509": 2561,
      "14065519": 2561,
      "14065528": 2561,
      "14065538": 2561,
      "14065550": 2561,
      "15320518": 2561,
      "16163439": 2561,
      "16163444": 2561,
      "16287053": 2561,
      "16293567": 2561,
      "16400333": 2561,
      "16434024": 2561,
      "16434037": 2561,
      "16434044": 2561,
      "...": "6 more fields"
    }
  }
}

Manager Next Events

GET /api/managers/{managerId}/events/next/{page}

Returns upcoming matches for the manager’s current team, paginated.

No example: this endpoint returned HTTP 404 for our Bundesliga sample on 24 September 2026. It only returns data when the entity has it (for example knockout draws, penalties or media), so handle an empty or 404 response.

Referee Endpoints

Referee Details

GET /api/referee/{refereeId}

Returns referee profile: name, nationality, age, and career stats summary.

number

required

Numeric referee ID. Discover from match details (/api/match/{matchId}).

Example response

Recorded 24 September 2026 from GET /v2/football/referee/102955 (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "referee": {
      "name": "Daniel Schlager",
      "slug": "schlager-daniel",
      "yellowCards": 1305,
      "redCards": 27,
      "yellowRedCards": 34,
      "games": 303,
      "sport": {
        "id": 1,
        "slug": "football",
        "name": "Football"
      },
      "country": {
        "alpha2": "DE",
        "name": "Germany"
      },
      "id": 102955,
      "dateOfBirthTimestamp": 629078400,
      "fieldTranslations": {
        "nameTranslation": {
          "ar": "شلاغر، دانييل",
          "bn": "শ্লেগার, ড্যানিয়েল",
          "hi": "श्लेगर, डैनियल",
          "ru": "Даниэль Шлагер"
        },
        "shortNameTranslation": {}
      }
    }
  }
}

Referee Image

GET /api/referee/{refereeId}/image

Returns the referee’s profile photo URL.

Example response

Recorded 24 September 2026 from GET /v2/football/referee/102955/image (lists trimmed to 2 items).

{
  "success": true,
  "refereeId": 102955,
  "imageUrl": "https://api.provider.app/api/v1/referee/102955/image"
}

Referee Statistics

GET /api/referee/{refereeId}/statistics

Returns referee statistics per tournament: matches officiated, cards given, penalties awarded.

Example response

Recorded 24 September 2026 from GET /v2/football/referee/102955/statistics (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "statistics": [
      {
        "uniqueTournament": {
          "name": "Regionalliga Südwest",
          "slug": "regionalliga-sudwest",
          "primaryColorHex": "#132a54",
          "secondaryColorHex": "#0f48b0",
          "category": {
            "name": "Germany Amateur",
            "slug": "germany-amateur",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "priority": 0,
            "id": 122,
            "flag": "germany",
            "alpha2": "DE",
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "ألمانيا هواة",
                "ru": "Германия Любители"
              },
              "shortNameTranslation": {}
            }
          },
          "userCount": 1319,
          "liveActivityEnabled": false,
          "id": 1079,
          "displayInverseHomeAwayTeams": false,
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "الدوري الإقليمي جنوب غرب",
              "ru": "Региональная лига Юго-Запад"
            },
            "shortNameTranslation": {}
          }
        },
        "appearances": 40,
        "yellowCards": 126,
        "redCards": 5,
        "yellowRedCards": 4,
        "penalty": 11
      },
      {
        "uniqueTournament": {
          "name": "EURO, Qualification",
          "slug": "european-championship-qualification",
          "primaryColorHex": "#182026",
          "secondaryColorHex": "#730000",
          "category": {
            "name": "Europe",
            "slug": "europe",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "priority": 19,
            "id": 1465,
            "flag": "europe",
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "أوروبا",
                "bn": "ইউরোপ",
                "hi": "यूरोप",
                "ru": "Европа"
              },
              "shortNameTranslation": {}
            }
          },
          "userCount": 140822,
          "liveActivityEnabled": false,
          "id": 27,
          "displayInverseHomeAwayTeams": false,
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "بطولة أوروبا، تصفيات",
              "bn": "ইউরোপীয় চ্যাম্পিয়নশিপ, কোয়ালিফিকেশন",
              "hi": "यूरोपीयन चैंपियनशिप, क्वालिफिकेशन",
              "ru": "ЕВРО, Квалификация"
            },
            "shortNameTranslation": {}
          }
        },
        "appearances": 2,
        "yellowCards": 13,
        "redCards": 0,
        "yellowRedCards": 0,
        "penalty": 0
      }
    ]
  }
}

Referee Last Events

GET /api/referee/{refereeId}/events/last/{page}

Returns recent matches officiated by the referee, paginated.

Example response

Recorded 24 September 2026 from GET /v2/football/referee/102955/events/last/0 (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "events": [
      {
        "eventState": {},
        "tournament": {
          "name": "UEFA Europa Conference League, Qualification Playoff",
          "slug": "uefa-europa-conference-league-qualification-playoff",
          "category": {
            "name": "Europe",
            "slug": "europe",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "priority": 19,
            "id": 1465,
            "flag": "europe",
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "أوروبا",
                "bn": "ইউরোপ",
                "hi": "यूरोप",
                "ru": "Европа"
              },
              "shortNameTranslation": {}
            }
          },
          "uniqueTournament": {
            "name": "UEFA Conference League",
            "slug": "uefa-europa-conference-league",
            "secondaryColorHex": "#04be15",
            "category": {
              "name": "Europe",
              "slug": "europe",
              "sport": {
                "name": "Football",
                "slug": "football",
                "id": 1
              },
              "priority": 19,
              "id": 1465,
              "flag": "europe",
              "fieldTranslations": {
                "nameTranslation": {
                  "ar": "أوروبا",
                  "bn": "ইউরোপ",
                  "hi": "यूरोप",
                  "ru": "Европа"
                },
                "shortNameTranslation": {}
              }
            },
            "userCount": 242271,
            "hasPerformanceGraphFeature": false,
            "liveActivityEnabled": true,
            "id": 17015,
            "hasEventPlayerStatistics": true,
            "displayInverseHomeAwayTeams": false,
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "دوري مؤتمرات الإتحاد الأوروبي",
                "bn": "উয়েফা কনফারেন্স লীগ",
                "hi": "यूईएफए कॉन्फ्रेंस लीग",
                "ru": "Лига конференций УЕФА"
              },
              "shortNameTranslation": {}
            }
          },
          "priority": 653,
          "isGroup": false,
          "roundPrefix": "Qualification",
          "isLive": false,
          "id": 119973,
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "دوري المؤتمر الأوروبي، ملحق التصفيات",
              "bn": "উয়েফা ইউরোপা কনফারেন্স লীগ, কোয়ালিফিকেশন প্লেঅফ",
              "hi": "यूईएफए यूरोपा कॉन्फ्रेंस लीग, क्वालिफिकेशन प्लेऑफ",
              "ru": "UEFA Europa Conference League, Qualification Playoff"
            },
            "shortNameTranslation": {}
          },
          "qualificationOrPreliminary": true
        },
        "season": {
          "name": "UEFA Conference League 25/26",
          "year": "25/26",
          "editor": false,
          "id": 76960
        },
        "roundInfo": {
          "round": 636,
          "name": "Playoff round",
          "slug": "playoff-round"
        },
        "customId": "LlbsyzW",
        "status": {
          "code": 100,
          "description": "Ended",
          "type": "finished"
        },
        "winnerCode": 1,
        "aggregatedWinnerCode": 1,
        "homeTeam": {
          "name": "Universitatea Craiova",
          "slug": "cs-universitatea-craiova",
          "shortName": "U. Craiova",
          "gender": "M",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "userCount": 44475,
          "nameCode": "CSU",
          "disabled": false,
          "national": false,
          "type": 0,
          "id": 116223,
          "subTeams": [],
          "teamColors": {
            "primary": "#ffffff",
            "secondary": "#5b5bff",
            "text": "#5b5bff"
          },
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "يونيفيرسيتاتيا كرايوفا",
              "ru": "Университатя Крайова"
            },
            "shortNameTranslation": {
              "ar": "يو. كرايوفا",
              "bn": "ইউ. ক্রাইওভা",
              "hi": "यू. क्रायोवा"
            }
          }
        },
        "awayTeam": {
          "name": "Başakşehir FK",
          "slug": "basaksehir-fk",
          "shortName": "Başakşehir",
          "gender": "M",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "userCount": 77437,
          "nameCode": "BAS",
          "disabled": false,
          "national": false,
          "type": 0,
          "id": 3086,
          "subTeams": [],
          "teamColors": {
            "primary": "#fc5000",
            "secondary": "#3273dc",
            "text": "#3273dc"
          },
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "باشاك شهير إف كيه",
              "ru": "Истанбул Башакшехир"
            },
            "shortNameTranslation": {
              "ar": "باشاك شهير",
              "bn": "বাসাকসেহির",
              "hi": "बाशाकशेहिर"
            }
          }
        },
        "homeScore": {
          "current": 3,
          "display": 3,
          "period1": 2,
          "period2": 1,
          "normaltime": 3,
          "aggregated": 5
        },
        "awayScore": {
          "current": 1,
          "display": 1,
          "period1": 1,
          "period2": 0,
          "normaltime": 1,
          "aggregated": 2
        },
        "time": {
          "injuryTime1": 3,
          "injuryTime2": 6,
          "currentPeriodStartTimestamp": 1756406109
        },
        "changes": {
          "changes": [
            "status.code"
          ],
          "changeTimestamp": 1756409229
        },
        "hasGlobalHighlights": true,
        "hasEventPlayerStatistics": true,
        "hasEventPlayerHeatMap": true,
        "detailId": 1,
        "crowdsourcingDataDisplayEnabled": false,
        "correctAiInsight": true,
        "correctHalftimeAiInsight": true,
        "id": 14377053,
        "awayRedCards": 1,
        "slug": "universitatea-craiova-basaksehir-fk",
        "previousLegEventId": 14353432,
        "...": "5 more fields"
      }
    ],
    "hasNextPage": true
  }
}

Venue Endpoints

Venue Details

GET /api/venue/{venueId}

Returns venue information: name, city, country, capacity, surface type, coordinates, and photo.

number

required

Numeric venue ID (e.g., 624 for Emirates Stadium). Discover from match details (/api/match/{matchId}) or team details.

Example response

Recorded 24 September 2026 from GET /v2/football/venue/655 (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "venue": {
      "city": {
        "name": "Paderborn",
        "country": {
          "alpha2": "DE",
          "alpha3": "DEU",
          "name": "Germany",
          "slug": "germany"
        },
        "id": 19236
      },
      "venueCoordinates": {
        "latitude": 51.730897,
        "longitude": 8.710963
      },
      "hidden": false,
      "slug": "home-deluxe-arena",
      "name": "Home Deluxe Arena",
      "capacity": 15000,
      "mainTeams": [
        {
          "name": "SC Paderborn 07",
          "slug": "sc-paderborn-07",
          "shortName": "Paderborn",
          "gender": "M",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "userCount": 33644,
          "nameCode": "PAD",
          "disabled": false,
          "national": false,
          "type": 0,
          "country": {
            "alpha2": "DE",
            "alpha3": "DEU",
            "name": "Germany",
            "slug": "germany"
          },
          "id": 2561,
          "teamColors": {
            "primary": "#0000bb",
            "secondary": "#0000a6",
            "text": "#0000a6"
          },
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "بادربورن",
              "hi": "एससी पेडरबोर्न 07",
              "ru": "Падерборн 07"
            },
            "shortNameTranslation": {
              "ar": "بادربورن",
              "bn": "প্যাডারবর্ন",
              "hi": "पेडरबॉर्न",
              "ru": "Падерборн 07"
            }
          }
        }
      ],
      "country": {
        "alpha2": "DE",
        "alpha3": "DEU",
        "name": "Germany",
        "slug": "germany"
      },
      "id": 655,
      "fieldTranslations": {
        "nameTranslation": {
          "ar": "هوم ديلوكس أرينا",
          "hi": "होम डीलक्स एरिना",
          "bn": "হোম ডিলাক্স এরিনা",
          "ru": "Арена Home Deluxe"
        },
        "shortNameTranslation": {}
      },
      "stadium": {
        "name": "Home Deluxe Arena",
        "capacity": 15000
      }
    },
    "statistics": {
      "totalMatches": 251,
      "homeTeamGoalsScored": 450,
      "awayTeamGoalsScored": 378,
      "avgRedCardsPerGame": 0.22310756972112,
      "avgCornerKicksPerGame": 15.573705179283,
      "homeTeamWinsPercentage": 43.426294820717,
      "awayTeamWinsPercentage": 33.466135458167,
      "drawsPercentage": 23.107569721116
    },
    "sportStatistics": {
      "football": {
        "totalMatches": 251,
        "goalsScored": 828,
        "homeTeamWinsPercentage": 43.426294820717,
        "drawsPercentage": 23.107569721116
      }
    }
  }
}

Example Requests

# Get manager career history
curl -X GET "https://api.sportsapipro.com/v2/football/managers/794075/career-history" \
  -H "x-api-key: YOUR_API_KEY"

# Get venue details
curl -X GET "https://api.sportsapipro.com/v2/football/venue/624" \
  -H "x-api-key: YOUR_API_KEY"

// Get manager career history
const career = await fetch(
  'https://api.sportsapipro.com/v2/football/managers/794075/career-history',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
).then(r => r.json());

import requests

headers = {'x-api-key': 'YOUR_API_KEY'}

# Get manager career history
career = requests.get(
    'https://api.sportsapipro.com/v2/football/managers/794075/career-history',
    headers=headers
).json()

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

Manager, Referee & Venue Endpoints

Base URL

Manager Endpoints

Manager Details

Manager Image

Manager Career History

Manager Last Events

Manager Next Events

Referee Endpoints

Referee Details

Referee Image

Referee Statistics

Referee Last Events

Venue Endpoints

Venue Details

Example Requests

​Base URL

​Manager Endpoints

​Manager Details

​Manager Image

​Manager Career History

​Manager Last Events

​Manager Next Events

​Referee Endpoints

​Referee Details

​Referee Image

​Referee Statistics

​Referee Last Events

​Venue Endpoints

​Venue Details

​Example Requests

Base URL

Manager Endpoints

Manager Details

Manager Image

Manager Career History

Manager Last Events

Manager Next Events

Referee Endpoints

Referee Details

Referee Image

Referee Statistics

Referee Last Events

Venue Endpoints

Venue Details

Example Requests