API Reference

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

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 limitations:

  • 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 the event's final status.

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

Handling Special Characters in GET Requests

When making GET requests via the browser, encoding special characters is important. Failure to do so will result in the request failing. Ensure all special characters are properly encoded before sending the request.

Last updated