Fixtures API

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

GEThttps://sec-gw.lsports.eu/fixtures/api/v1/fixtures

Header parameters

Response

200401500

Successfully retrieved 10 random fixtures.

Body

application/json

Fixturesarray of object

Request

JavaScriptCurlPython

const response = await fetch('https://sec-gw.lsports.eu/fixtures/api/v1/fixtures', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer {jwt_token}"
    },
});
const data = await response.json();

Response

200401500

{
  "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.

GEThttps://sec-gw.lsports.eu/fixtures/api/v1/fixtures/{SportId}

Path parameters

SportId*string

Unique identifier for the sport to filter fixtures

Example: "601"

Header parameters

Response

200401500

Successfully retrieved 10 random fixtures filtered by sport ID.

Body

application/json

Fixturesarray of object

Request

JavaScriptCurlPython

const response = await fetch('https://sec-gw.lsports.eu/fixtures/api/v1/fixtures/{SportId}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer {jwt_token}"
    },
});
const data = await response.json();

Response

200401500

{
  "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.

POSThttps://sec-gw.lsports.eu/fixtures/api/v1/metadata

Header parameters

Body

application/json

FixtureIdsarray of integer

Array of LSports fixture IDs to retrieve metadata for

Response

200400401500

Successfully retrieved metadata for the requested fixtures.

Body

application/json

Idinteger

Fixture ID

Example: 123456

HomeLineupobject

AwayLineupobject

HomeParticipantTeam (object)

AwayParticipantTeam (object)

LeagueLeague (object)

Locationstring

Location name

Example: "Old Trafford"

Sportstring

Sport type

Example: "Football"

StartDatestring (date-time)

Fixture start date and time

Example: "2024-10-19T14:00:00Z"

HomeFormationnullable string

Home team formation, if available

Example: "4-4-2"

AwayFormationnullable string

Away team formation, if available

Example: "4-3-3"

BestOfnullable string

Number of sets or matches, if applicable

Example: "3"

SurfaceTypenullable string

Surface type (e.g., grass), if applicable

Example: "Grass"

Categorynullable string

Category of the fixture, if applicable

Example: "Premier League"

NeutralVenuenullable string

Whether the fixture is played at a neutral venue

Example: "true"

HomeFormnullable string

Recent form of the home team

Example: "W-W-D-L"

AwayFormnullable string

Recent form of the away team

Example: "L-L-D-W"

HomeJerseyColornullable string

Home team jersey color, if available

Example: "#00000"

AwayJerseyColornullable string

Away team jersey color, if available

Example: "#00000"

Request

JavaScriptCurlPython

const response = await fetch('https://sec-gw.lsports.eu/fixtures/api/v1/metadata', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer {jwt_token}",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400401500

[
  {
    "Id": 123456,
    "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"
  }
]