Fixtures API

PreviousTips API NextChat API

Last updated 4 months ago

Was this helpful?

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

get

/fixtures/api/v1/fixtures

Header parameters

Authorizationstringrequired

JWT token for authorization

Example: Bearer {jwt_token}

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://sec-gw.lsports.eu/fixtures/api/v1/fixtures' \
  --header 'Authorization: Bearer {jwt_token}'

200

401

500

{
  "Fixtures": [
    {
      "Id": "123456",
      "Date": "2024-10-19T14:00:00Z",
      "Name": "Manchester United vs Liverpool",
      "DisplayName": "Man Utd vs LFC",
      "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"
      },
      "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"
              }
            }
          ]
        }
      ]
    }
  ]
}

Successfully retrieved 10 random fixtures.

Retrieves 10 random fixtures filtered by sport ID.

get

/fixtures/api/v1/fixtures/{SportId}

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

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://sec-gw.lsports.eu/fixtures/api/v1/fixtures/{SportId}' \
  --header 'Authorization: Bearer {jwt_token}'

200

401

500

{
  "Fixtures": [
    {
      "Id": "123456",
      "Date": "2024-10-19T14:00:00Z",
      "Name": "Manchester United vs Liverpool",
      "DisplayName": "Man Utd vs LFC",
      "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"
      },
      "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"
              }
            }
          ]
        }
      ]
    }
  ]
}

Successfully retrieved 10 random fixtures filtered by sport ID.

Returns metadata for an array of requested LSports fixture IDs.

post

/fixtures/api/v1/metadata

Header parameters

Authorizationstringrequired

JWT token for authorization

Example: Bearer {jwt_token}

Body

FixtureIdsinteger[]

Array of LSports fixture IDs to retrieve metadata for

Example: [123456,789101]

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://sec-gw.lsports.eu/fixtures/api/v1/metadata' \
  --header 'Authorization: Bearer {jwt_token}' \
  --header 'Content-Type: application/json' \
  --data '{"FixtureIds":[123456,789101]}'

200

400

401

500

[
  {
    "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",
    "HomeLineup": {
      "ANY_ADDITIONAL_PROPERTY": [
        {
          "Name": "Player 1",
          "Number": "10",
          "Status": "Attending"
        }
      ]
    },
    "AwayLineup": {
      "ANY_ADDITIONAL_PROPERTY": [
        {
          "Name": "Player 1",
          "Number": "10",
          "Status": "Attending"
        }
      ]
    }
  }
]

Successfully retrieved metadata for the requested fixtures.