# API Reference

### GetSports <a href="#getsports" id="getsports"></a>

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       | <p>Response content language<br><strong>Default value</strong>: English</p>       | **✓**              |
| Indented   | <p>Response content will be indented<br><strong>Default value</strong>: False</p> | **✓**              |

**Response Scheme**

```xml
<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 <a href="#getlocations" id="getlocations"></a>

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          | <p>Response content language<br><strong>Default value</strong>: English</p>       | **✓**              |
| Indented      | <p>Response content will be indented<br><strong>Default value</strong>: False</p> | **✓**              |

**Response Scheme**

```xml
 <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 <a href="#getleagues" id="getleagues"></a>

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        | <p>Comma separated list of sports<br><strong>Default value</strong>: Leagues from all sports</p>       | **✓**              |
| Locations     | <p>Comma separated list of locations<br><strong>Default value</strong>: Leagues from all locations</p> | **✓**              |
| Lang          | <p>Response content language<br><strong>Default value</strong>: English</p>                            | **✓**              |
| Indented      | <p>Response content will be indented<br><strong>Default value</strong>: False</p>                      | **✓**              |

**Response Scheme**

```xml
 <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 <a href="#getbookmakers" id="getbookmakers"></a>

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](https://app.stoplight.io/wk/9H6gSLYuaKRcYRDpP/8BSdjzonD32LCi6gp/B5TEAsYcAKNd485DH/design/text/snS6Hx7fEm2b6bG4C) | <p>Response content language<br><strong>Default value</strong>: English</p>       | **✓**              |
| Indented                                                                                                                | <p>Response content will be indented<br><strong>Default value</strong>: False</p> | **✓**              |

**Response Scheme**

```xml
<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 <a href="#getmarkets" id="getmarkets"></a>

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          | <p>Response content language<br><strong>Default value</strong>: English</p>       | **✓**              |
| Indented      | <p>Response content will be indented<br><strong>Default value</strong>: False</p> | **✓**              |

**Response Scheme**

```xml
<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** <a href="#api-notes-and-troubleshooting" id="api-notes-and-troubleshooting"></a>

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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.lsports.eu/u/legacy-products/odds-service/general/api-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.