# 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.