API Reference

Modified on Mon, 28 Nov 2022 at 02:39 PM

TABLE OF CONTENTS

GetSports
GetLocations
GetLeagues
GetBookmakers
GetMarkets
API Notes and troubleshooting

GetSports

To receive a list of supported sports

https://prematch.lsports.eu/OddService/GetSports

Parameter breakdown

Action	Description	Optional Field
Username	Username as it apparrs in the package	X
Password	Password as it appears the package	X
Guid	GUID as it appears the package	X
Lang	Response content language Default value: English	✓
Indented	Response content will be indented Default value: False	✓

Response Scheme

<xs:element name="Feed">
   <xs:complexType>
     <xs:sequence>
         <xs:element name="MessageHeader">
           <xs:complexType>
               <xs:sequence>
                 <xs:element name="Type" type="xs:int"></xs:element>
                 <xs:element name="ServerTimestamp" type="xs:int"></xs:element>
               </xs:sequence>
           </xs:complexType>
         </xs:element>
         <xs:element name="Body">
           <xs:complexType>
               <xs:sequence>
                 <xs:element name="Sport" maxOccurs="unbounded">
                     <xs:complexType>
                       <xs:attribute name="Id" type="xs:int"></xs:attribute>
                       <xs:attribute name="Name" type="xs:string"></xs:attribute>
                     </xs:complexType>
                 </xs:element>
               </xs:sequence>
           </xs:complexType>
         </xs:element>
    </xs:sequence>
   </xs:complexType>
</xs:element>

GetLocations

To receive a list of supported locations

https://prematch.lsports.eu/OddService/GetLocations

Parameter breakdown

Parameter	Description	Optional Field
Username	Username as it apparrs in the package	X
Password	Password as it appears the package	X
Guid	GUID as it appears the package	X
Lang	Response content language Default value: English	✓
Indented	Response content will be indented Default value: False	✓

Response Scheme

 <xs:element name="Feed">
  <xs:complexType>
    <xs:sequence>
      <xs:element name="MessageHeader">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="Type" type="xs:int"/>
            <xs:element name="ServerTimestamp" type="xs:int"/>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
      <xs:element name="Body">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="Location" maxOccurs="unbounded">
              <xs:complexType>
                <xs:attribute name="Id" type="xs:int"/>
                <xs:attribute name="Name" type="xs:string"/>
              </xs:complexType>
            </xs:element>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
    </xs:sequence>
  </xs:complexType>
</xs:element>

GetLeagues

To receive a list of supported leagues

https://prematch.lsports.eu/OddService/GetLeagues

Parameter breakdown

Parameter	Description	Optional Field
Username	Username as it appaers in the package	X
Password	Password as it appears the package	X
Guid	GUID as it appears the package	X
Sports	Comma separated list of sports Default value: Leagues from all sports	✓
Locations	Comma separated list of locations Default value: Leagues from all locations	✓
Lang	Response content language Default value: English	✓
Indented	Response content will be indented Default value: False	✓

Response Scheme

 <xs:element name="Feed">
  <xs:complexType>
    <xs:sequence>
      <xs:element name="MessageHeader">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="Type" type="xs:int"/>
            <xs:element name="ServerTimestamp" type="xs:int"/>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
      <xs:element name="Body">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="League" maxOccurs="unbounded">
              <xs:complexType>
                <xs:attribute name="Id" type="xs:int"/>
                <xs:attribute name="Name" type="xs:string"/>
              </xs:complexType>
            </xs:element>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
    </xs:sequence>
  </xs:complexType>
</xs:element>

GetBookmakers

To receive a list of supported bookmakers

https://prematch.lsports.eu/OddService/GetBookmakers

Parameter breakdown

Parameter	Description	Optional Field
Username	Username as it apparrs in the package	X
Password	Password as it appears the package	X
Guid	GUID as it appears the package	X
Lang	Response content language Default value: English	✓
Indented	Response content will be indented Default value: False	✓

Response Scheme

<xs:element name="Feed">
  <xs:complexType>
    <xs:sequence>
      <xs:element name="MessageHeader">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="Type" type="xs:int"/>
            <xs:element name="ServerTimestamp" type="xs:int"/>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
      <xs:element name="Body">
        <xs:complexType>
          <xs:sequence>
            <xs:element name="Bookmaker" maxOccurs="unbounded">
              <xs:complexType>
                <xs:attribute name="Id" type="xs:int"/>
                <xs:attribute name="Name" type="xs:string"/>
              </xs:complexType>
            </xs:element>
          </xs:sequence>
        </xs:complexType>
      </xs:element>
    </xs:sequence>
  </xs:complexType>
</xs:element>

GetMarkets

To receive a list of supported markets

https://prematch.lsports.eu/OddService/GetMarkets

Parameter breakdown

Parameter	Description	Optional Field
Username	Username as it apparrs in the package	X
Password	Password as it appears the package	X
Guid	GUID as it appears the package	X
Lang	Response content language Default value: English	✓
Indented	Response content will be indented Default value: False	✓

Response Scheme

<xs:element name="Feed">
   <xs:complexType>
     <xs:sequence>
         <xs:element name="MessageHeader">
           <xs:complexType>
               <xs:sequence>
                 <xs:element name="Type" type="xs:int"></xs:element>
                 <xs:element name="ServerTimestamp" type="xs:int"></xs:element>
               </xs:sequence>
           </xs:complexType>
         </xs:element>
         <xs:element name="Body">
           <xs:complexType>
               <xs:sequence>
                 <xs:element name="Market" maxOccurs="unbounded">
                     <xs:complexType>
                       <xs:attribute name="Id" type="xs:int"></xs:attribute>
                       <xs:attribute name="Name" type="xs:string"></xs:attribute>
                     </xs:complexType>
                 </xs:element>
               </xs:sequence>
           </xs:complexType>
         </xs:element>
     </xs:sequence>
   </xs:complexType>
</xs:element>

API Notes and troubleshooting

Follow the below limitations and restrictions while working with LSports API

Be advised of the following limitation:

2500 requests within 5 minutes per IP

We highly recommend using only filtered requests, otherwise, 'full' requests can take longer to retrieve, and in some cases, you won't be able to retrieve requests at all due to the vast amount of data.

Here are examples of "full" and "filtered" requests

Full - http://prematch.lsports.eu/OddService/GetFixtures?username=YourEmail&Password=YourPassword&guid=3faaa32d-662b-4135-b1e2-38454263dcad

Filtered - http://prematch.lsports.eu/OddService/GetFixtures?username=YourEmail&Password=YourPassword&guid=3fa1a30d-662b-4135-b1e2-38454263dcad&sports=6046&location=242

API data preservation:

How long do we keep data available for Prematch? - 36 Hours as of event's final status.
How long do we keep data available for Inplay snapshot? - 8 Hours as of event's final status.