Get List of Sport Events

This endpoint retrieves a list of sport events based on specified criteria. It supports filtering by event IDs and tournament ID.

Endpoint

GET /api/v1/sport-events

Headers

Authorization: Bearer Token (required)

Query Parameters

event_ids: A comma-separated list of sport event IDs to filter the results.
tournament_id: An integer representing the tournament ID to filter the events.

Responses

200 OK: Returns a list of sport events.

Content-Type: application/json

Schema:

{
  "success": true,
  "data": {
    "sport_events": [
      {
        "event_id": integer,
        "name": string,
        "display_name": string,
        "scheduled": string,
        "status": string,
        "sport_name": string,
        "tournament_id": integer,
        "tournament_name": string,
        "competitors": [
          {
            "id": integer,
            "name": string,
            "display_name": string,
            "abbreviation": string,
            "side": string
          }
        ]
      }
    ]
  }
}

400 Bad Request: Invalid request parameters.
500 Internal Server Error: An error occurred on the server.

Example Request

GET /api/v1/sport-events?event_ids=1,2,3&tournament_id=10 HTTP/1.1
Host: api-ss-sandbox.betprophet.co
Authorization: Bearer YOUR_TOKEN

Example Response

{
  "success": true,
  "data": {
    "sport_events": [
      {
        "event_id": 1,
        "name": "Event Name",
        "display_name": "Event Display Name",
        "scheduled": "2026-01-15T00:00:00Z",
        "status": "scheduled",
        "sport_name": "Football",
        "tournament_id": 10,
        "tournament_name": "Tournament Name",
        "competitors": [
          {
            "id": 101,
            "name": "Team A",
            "display_name": "Team A Display",
            "abbreviation": "TA",
            "side": "home"
          },
          {
            "id": 102,
            "name": "Team B",
            "display_name": "Team B Display",
            "abbreviation": "TB",
            "side": "away"
          }
        ]
      }
    ]
  }
}