Fixtures API

Retrieves 10 random fixtures, prioritizing football and basketball fixtures from major leagues.

get

Header parameters

AuthorizationstringRequired

JWT token for authorization

Example: Bearer {jwt_token}

Responses

200

Successfully retrieved 10 random fixtures.

application/json

401

Unauthorized. Authentication failed or token is invalid.

application/json

500

Internal server error. Please try again later.

application/json

get

HTTPcURLJavaScriptPython

GET /fixtures/api/v1/fixtures HTTP/1.1
Host: sec-gw.lsports.eu
Authorization: Bearer {jwt_token}
Accept: */*

{
  "Fixtures": [
    {
      "Id": "123456",
      "Date": "2024-10-19T14:00:00Z",
      "Participants": [
        {
          "Id": "101",
          "Name": "Manchester United",
          "DisplayName": "Man Utd"
        }
      ],
      "Markets": [
        {
          "Id": "201",
          "Name": "Match Result",
          "DisplayName": "Full Time Result",
          "Bets": [
            {
              "Id": "301",
              "Name": "Home Win",
              "Odds": 1.75,
              "Selected": false,
              "Line": "0.5",
              "DisplayName": "Home Team Wins",
              "Player": {
                "Id": "401",
                "Name": "John Doe",
                "DisplayName": "J. Doe"
              }
            }
          ]
        }
      ],
      "League": {
        "Id": "501",
        "Name": "Premier League",
        "DisplayName": "EPL"
      },
      "Sport": {
        "Id": "601",
        "Name": "Football",
        "DisplayName": "Soccer"
      },
      "Location": {
        "Id": "701",
        "Name": "Old Trafford",
        "DisplayName": "Man Utd Stadium"
      },
      "Name": "Manchester United vs Liverpool",
      "DisplayName": "Man Utd vs LFC"
    }
  ]
}

Retrieves 10 random fixtures filtered by sport ID.

get

Path parameters

SportIdstringRequired

Unique identifier for the sport to filter fixtures

Example: 601

Header parameters

AuthorizationstringRequired

JWT token for authorization

Example: Bearer {jwt_token}

Responses

200

Successfully retrieved 10 random fixtures filtered by sport ID.

application/json

401

Unauthorized. Authentication failed or token is invalid.

application/json

500

Internal server error. Please try again later.

application/json

get

HTTPcURLJavaScriptPython

GET /fixtures/api/v1/fixtures/{SportId} HTTP/1.1
Host: sec-gw.lsports.eu
Authorization: Bearer {jwt_token}
Accept: */*

{
  "Fixtures": [
    {
      "Id": "123456",
      "Date": "2024-10-19T14:00:00Z",
      "Participants": [
        {
          "Id": "101",
          "Name": "Manchester United",
          "DisplayName": "Man Utd"
        }
      ],
      "Markets": [
        {
          "Id": "201",
          "Name": "Match Result",
          "DisplayName": "Full Time Result",
          "Bets": [
            {
              "Id": "301",
              "Name": "Home Win",
              "Odds": 1.75,
              "Selected": false,
              "Line": "0.5",
              "DisplayName": "Home Team Wins",
              "Player": {
                "Id": "401",
                "Name": "John Doe",
                "DisplayName": "J. Doe"
              }
            }
          ]
        }
      ],
      "League": {
        "Id": "501",
        "Name": "Premier League",
        "DisplayName": "EPL"
      },
      "Sport": {
        "Id": "601",
        "Name": "Football",
        "DisplayName": "Soccer"
      },
      "Location": {
        "Id": "701",
        "Name": "Old Trafford",
        "DisplayName": "Man Utd Stadium"
      },
      "Name": "Manchester United vs Liverpool",
      "DisplayName": "Man Utd vs LFC"
    }
  ]
}

Returns metadata for an array of requested LSports fixture IDs.

post

Header parameters

AuthorizationstringRequired

JWT token for authorization

Example: Bearer {jwt_token}

Body

FixtureIdsinteger[] · min: 1Optional

Array of LSports fixture IDs to retrieve metadata for

Example: [123456,789101]

Responses

200

Successfully retrieved metadata for the requested fixtures.

application/json

400

Bad request. Please verify the input parameters.

application/json

401

Unauthorized. Authentication failed or token is invalid.

application/json

500

Internal server error. Please try again later.

application/json

post

HTTPcURLJavaScriptPython

POST /fixtures/api/v1/metadata HTTP/1.1
Host: sec-gw.lsports.eu
Authorization: Bearer {jwt_token}
Content-Type: application/json
Accept: */*
Content-Length: 30

{
  "FixtureIds": [
    123456,
    789101
  ]
}

[
  {
    "Id": 123456,
    "HomeLineup": {
      "ANY_ADDITIONAL_PROPERTY": [
        {
          "Name": "Player 1",
          "Number": "10",
          "Status": "Attending"
        }
      ]
    },
    "AwayLineup": {
      "ANY_ADDITIONAL_PROPERTY": [
        {
          "Name": "Player 1",
          "Number": "10",
          "Status": "Attending"
        }
      ]
    },
    "HomeParticipant": {
      "Name": "Manchester United",
      "Location": "Manchester"
    },
    "AwayParticipant": {
      "Name": "Manchester United",
      "Location": "Manchester"
    },
    "League": {
      "Name": "Premier League",
      "Location": "England"
    },
    "Location": "Old Trafford",
    "Sport": "Football",
    "StartDate": "2024-10-19T14:00:00Z",
    "HomeFormation": "4-4-2",
    "AwayFormation": "4-3-3",
    "BestOf": "3",
    "SurfaceType": "Grass",
    "Category": "Premier League",
    "NeutralVenue": "true",
    "HomeForm": "W-W-D-L",
    "AwayForm": "L-L-D-W",
    "HomeJerseyColor": "#00000",
    "AwayJerseyColor": "#00000"
  }
]