# Metadata

This documentation describes the available API endpoints for retrieving metadata and translations.

## POST /Fixtures/Get

> Retrieves a list of fixtures based on provided sport, location, and league IDs.

```json
{"openapi":"3.0.1","info":{"title":"Customers","version":"v1.0"},"servers":[{"url":"https://stm-api.lsports.eu","variables":{"host":{"default":"https://stm-api.lsports.eu"}}}],"paths":{"/Fixtures/Get":{"post":{"tags":["Fixtures"],"summary":"Retrieves a list of fixtures based on provided sport, location, and league IDs.","requestBody":{"content":{"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/GetSubscribedFixturesRequestDto"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetSubscribedFixturesRequestDto"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetSubscribedFixturesRequestDto"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/GetSubscribedFixturesRequestDto"}}}},"responses":{"200":{"description":"Success","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/GetSubscribedFixturesResponseDtoStandardResponse"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetSubscribedFixturesResponseDtoStandardResponse"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetSubscribedFixturesResponseDtoStandardResponse"}}}}}}}},"components":{"schemas":{"GetSubscribedFixturesRequestDto":{"required":["packageId","password","userName"],"type":"object","properties":{"packageId":{"type":"integer","format":"int32"},"userName":{"minLength":1,"type":"string"},"password":{"minLength":1,"type":"string"},"sportIds":{"type":"array","items":{"type":"integer","format":"int32"},"nullable":true},"locationIds":{"type":"array","items":{"type":"integer","format":"int32"},"nullable":true},"leagueIds":{"type":"array","items":{"type":"integer","format":"int32"},"nullable":true}},"additionalProperties":false},"GetSubscribedFixturesResponseDtoStandardResponse":{"type":"object","properties":{"header":{"$ref":"#/components/schemas/ResponseHeader"},"body":{"$ref":"#/components/schemas/GetSubscribedFixturesResponseDto"}},"additionalProperties":false},"ResponseHeader":{"type":"object","properties":{"httpStatusCode":{"type":"integer","format":"int32"},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ResponseError"},"nullable":true}},"additionalProperties":false},"ResponseError":{"type":"object","properties":{"message":{"type":"string","nullable":true}},"additionalProperties":false},"GetSubscribedFixturesResponseDto":{"type":"object","properties":{"fixtures":{"type":"array","items":{"type":"integer","format":"int32"},"nullable":true}},"additionalProperties":false}}}}
```

## POST /Leagues/Get

> Retrieves a list of leagues based on sport and location IDs.

```json
{"openapi":"3.0.1","info":{"title":"Customers","version":"v1.0"},"servers":[{"url":"https://stm-api.lsports.eu","variables":{"host":{"default":"https://stm-api.lsports.eu"}}}],"paths":{"/Leagues/Get":{"post":{"tags":["Leagues"],"summary":"Retrieves a list of leagues based on sport and location IDs.","requestBody":{"content":{"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/GetLeaguesRequestDto"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetLeaguesRequestDto"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetLeaguesRequestDto"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/GetLeaguesRequestDto"}}}},"responses":{"200":{"description":"Success","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/GetLeaguesResponseDtoStandardResponse"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetLeaguesResponseDtoStandardResponse"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetLeaguesResponseDtoStandardResponse"}}}}}}}},"components":{"schemas":{"GetLeaguesRequestDto":{"required":["packageId","password","userName"],"type":"object","properties":{"packageId":{"type":"integer","format":"int32"},"userName":{"minLength":1,"type":"string"},"password":{"minLength":1,"type":"string"},"sportIds":{"type":"array","items":{"type":"integer","format":"int32"},"nullable":true},"locationIds":{"type":"array","items":{"type":"integer","format":"int32"},"nullable":true},"subscriptionStatus":{"$ref":"#/components/schemas/SubscriptionFilterEnum"},"languageId":{"type":"integer","format":"int32","nullable":true}},"additionalProperties":false},"SubscriptionFilterEnum":{"enum":[0,1,2],"type":"integer","format":"int32"},"GetLeaguesResponseDtoStandardResponse":{"type":"object","properties":{"header":{"$ref":"#/components/schemas/ResponseHeader"},"body":{"$ref":"#/components/schemas/GetLeaguesResponseDto"}},"additionalProperties":false},"ResponseHeader":{"type":"object","properties":{"httpStatusCode":{"type":"integer","format":"int32"},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ResponseError"},"nullable":true}},"additionalProperties":false},"ResponseError":{"type":"object","properties":{"message":{"type":"string","nullable":true}},"additionalProperties":false},"GetLeaguesResponseDto":{"type":"object","properties":{"leagues":{"type":"array","items":{"$ref":"#/components/schemas/LeagueResponse"},"nullable":true}},"additionalProperties":false},"LeagueResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int32"},"name":{"type":"string","nullable":true},"season":{"type":"string","nullable":true},"sportId":{"type":"integer","format":"int32"},"locationId":{"type":"integer","format":"int32"}},"additionalProperties":false}}}}
```

## POST /Locations/Get

> Retrieves a list of locations.

```json
{"openapi":"3.0.1","info":{"title":"Customers","version":"v1.0"},"servers":[{"url":"https://stm-api.lsports.eu","variables":{"host":{"default":"https://stm-api.lsports.eu"}}}],"paths":{"/Locations/Get":{"post":{"tags":["Locations"],"summary":"Retrieves a list of locations.","requestBody":{"content":{"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/GetLocationsRequestDto"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetLocationsRequestDto"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetLocationsRequestDto"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/GetLocationsRequestDto"}}}},"responses":{"200":{"description":"Success","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/GetLocationsResponseDtoStandardResponse"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetLocationsResponseDtoStandardResponse"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetLocationsResponseDtoStandardResponse"}}}}}}}},"components":{"schemas":{"GetLocationsRequestDto":{"required":["packageId","password","userName"],"type":"object","properties":{"packageId":{"type":"integer","format":"int32"},"userName":{"minLength":1,"type":"string"},"password":{"minLength":1,"type":"string"},"languageId":{"type":"integer","format":"int32","nullable":true}},"additionalProperties":false},"GetLocationsResponseDtoStandardResponse":{"type":"object","properties":{"header":{"$ref":"#/components/schemas/ResponseHeader"},"body":{"$ref":"#/components/schemas/GetLocationsResponseDto"}},"additionalProperties":false},"ResponseHeader":{"type":"object","properties":{"httpStatusCode":{"type":"integer","format":"int32"},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ResponseError"},"nullable":true}},"additionalProperties":false},"ResponseError":{"type":"object","properties":{"message":{"type":"string","nullable":true}},"additionalProperties":false},"GetLocationsResponseDto":{"type":"object","properties":{"locations":{"type":"array","items":{"$ref":"#/components/schemas/Location"},"nullable":true}},"additionalProperties":false},"Location":{"type":"object","properties":{"id":{"type":"integer","format":"int32"},"name":{"type":"string","nullable":true}},"additionalProperties":false}}}}
```

## POST /States/Get

> Retrieves states data with filtering options

```json
{"openapi":"3.0.4","info":{"title":"Customers","version":"v1.0"},"servers":[{"url":"https://stm-api.lsports.eu","variables":{"host":{"default":"https://stm-api.lsports.eu"}}}],"paths":{"/States/Get":{"post":{"tags":["States"],"summary":"Retrieves states data with filtering options","requestBody":{"content":{"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/GetStatesRequestDto"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetStatesRequestDto"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetStatesRequestDto"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/GetStatesRequestDto"}}}},"responses":{"200":{"description":"Success","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/GetStatesResponseDtoStandardResponse"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetStatesResponseDtoStandardResponse"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetStatesResponseDtoStandardResponse"}}}},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}}}}},"components":{"schemas":{"GetStatesRequestDto":{"required":["packageId","password","userName"],"type":"object","properties":{"packageId":{"type":"integer","format":"int32"},"userName":{"minLength":1,"type":"string"},"password":{"minLength":1,"type":"string"},"filter":{"$ref":"#/components/schemas/StateFilterDto"}},"additionalProperties":false},"StateFilterDto":{"type":"object","properties":{"stateIds":{"type":"array","items":{"type":"integer","format":"int32"},"description":"Array of state IDs to filter by","nullable":true},"countryIds":{"type":"array","items":{"type":"integer","format":"int32"},"description":"Array of country IDs to filter by","nullable":true}},"additionalProperties":false},"GetStatesResponseDtoStandardResponse":{"type":"object","properties":{"header":{"$ref":"#/components/schemas/ResponseHeader"},"body":{"$ref":"#/components/schemas/GetStatesResponseDto"}},"additionalProperties":false},"ResponseHeader":{"type":"object","properties":{"httpStatusCode":{"type":"integer","format":"int32"},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ResponseError"},"nullable":true}},"additionalProperties":false},"ResponseError":{"type":"object","properties":{"message":{"type":"string","nullable":true}},"additionalProperties":false},"GetStatesResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/StateDto"},"description":"Array of state objects","nullable":true}},"additionalProperties":false},"StateDto":{"type":"object","properties":{"stateId":{"type":"integer","description":"State ID","format":"int32"},"name":{"type":"string","description":"State name","nullable":true},"country":{"$ref":"#/components/schemas/LocationDto"}},"additionalProperties":false},"LocationDto":{"type":"object","properties":{"id":{"type":"integer","description":"Location ID","format":"int32"},"name":{"type":"string","description":"Location name","nullable":true}},"additionalProperties":false}}}}
```

## POST /Cities/Get

> Retrieves cities data with filtering options

```json
{"openapi":"3.0.4","info":{"title":"Customers","version":"v1.0"},"servers":[{"url":"https://stm-api.lsports.eu","variables":{"host":{"default":"https://stm-api.lsports.eu"}}}],"paths":{"/Cities/Get":{"post":{"tags":["Cities"],"summary":"Retrieves cities data with filtering options","requestBody":{"content":{"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/GetCitiesRequestDto"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetCitiesRequestDto"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetCitiesRequestDto"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/GetCitiesRequestDto"}}}},"responses":{"200":{"description":"Success","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/GetCitiesResponseDtoStandardResponse"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetCitiesResponseDtoStandardResponse"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetCitiesResponseDtoStandardResponse"}}}},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}}}}},"components":{"schemas":{"GetCitiesRequestDto":{"required":["packageId","password","userName"],"type":"object","properties":{"packageId":{"type":"integer","format":"int32"},"userName":{"minLength":1,"type":"string"},"password":{"minLength":1,"type":"string"},"filter":{"$ref":"#/components/schemas/CityFilterDto"}},"additionalProperties":false},"CityFilterDto":{"type":"object","properties":{"cityIds":{"type":"array","items":{"type":"integer","format":"int32"},"description":"Array of city IDs to filter by","nullable":true},"countryIds":{"type":"array","items":{"type":"integer","format":"int32"},"description":"Array of country IDs to filter by","nullable":true},"stateIds":{"type":"array","items":{"type":"integer","format":"int32"},"description":"Array of state IDs to filter by","nullable":true}},"additionalProperties":false},"GetCitiesResponseDtoStandardResponse":{"type":"object","properties":{"header":{"$ref":"#/components/schemas/ResponseHeader"},"body":{"$ref":"#/components/schemas/GetCitiesResponseDto"}},"additionalProperties":false},"ResponseHeader":{"type":"object","properties":{"httpStatusCode":{"type":"integer","format":"int32"},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ResponseError"},"nullable":true}},"additionalProperties":false},"ResponseError":{"type":"object","properties":{"message":{"type":"string","nullable":true}},"additionalProperties":false},"GetCitiesResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/CityDto"},"description":"Array of city objects","nullable":true}},"additionalProperties":false},"CityDto":{"type":"object","properties":{"cityId":{"type":"integer","description":"City ID","format":"int32"},"name":{"type":"string","description":"City name","nullable":true},"country":{"$ref":"#/components/schemas/LocationDto"},"state":{"$ref":"#/components/schemas/LocationDto"}},"additionalProperties":false},"LocationDto":{"type":"object","properties":{"id":{"type":"integer","description":"Location ID","format":"int32"},"name":{"type":"string","description":"Location name","nullable":true}},"additionalProperties":false}}}}
```

## POST /Venues/Get

> Retrieves venues data with filtering options

```json
{"openapi":"3.0.4","info":{"title":"Customers","version":"v1.0"},"servers":[{"url":"https://stm-api.lsports.eu","variables":{"host":{"default":"https://stm-api.lsports.eu"}}}],"paths":{"/Venues/Get":{"post":{"tags":["Venues"],"summary":"Retrieves venues data with filtering options","requestBody":{"content":{"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/GetVenuesRequestDto"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetVenuesRequestDto"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetVenuesRequestDto"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/GetVenuesRequestDto"}}}},"responses":{"200":{"description":"Success","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/GetVenuesResponseDtoStandardResponse"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetVenuesResponseDtoStandardResponse"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetVenuesResponseDtoStandardResponse"}}}},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}}}}},"components":{"schemas":{"GetVenuesRequestDto":{"required":["packageId","password","userName"],"type":"object","properties":{"packageId":{"type":"integer","format":"int32"},"userName":{"minLength":1,"type":"string"},"password":{"minLength":1,"type":"string"},"filter":{"$ref":"#/components/schemas/VenueFilterDto"}},"additionalProperties":false},"VenueFilterDto":{"type":"object","properties":{"venueIds":{"type":"array","items":{"type":"integer","format":"int32"},"description":"Array of venue IDs to filter by","nullable":true},"countryIds":{"type":"array","items":{"type":"integer","format":"int32"},"description":"Array of country IDs to filter by","nullable":true},"stateIds":{"type":"array","items":{"type":"integer","format":"int32"},"description":"Array of state IDs to filter by","nullable":true},"cityIds":{"type":"array","items":{"type":"integer","format":"int32"},"description":"Array of city IDs to filter by","nullable":true}},"additionalProperties":false},"GetVenuesResponseDtoStandardResponse":{"type":"object","properties":{"header":{"$ref":"#/components/schemas/ResponseHeader"},"body":{"$ref":"#/components/schemas/GetVenuesResponseDto"}},"additionalProperties":false},"ResponseHeader":{"type":"object","properties":{"httpStatusCode":{"type":"integer","format":"int32"},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ResponseError"},"nullable":true}},"additionalProperties":false},"ResponseError":{"type":"object","properties":{"message":{"type":"string","nullable":true}},"additionalProperties":false},"GetVenuesResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/VenueDto"},"description":"Array of venue objects","nullable":true}},"additionalProperties":false},"VenueDto":{"type":"object","properties":{"venueId":{"type":"integer","description":"Venue ID","format":"int32"},"name":{"type":"string","description":"Venue name","nullable":true},"country":{"$ref":"#/components/schemas/LocationDto"},"state":{"$ref":"#/components/schemas/LocationDto"},"city":{"$ref":"#/components/schemas/LocationDto"}},"additionalProperties":false},"LocationDto":{"type":"object","properties":{"id":{"type":"integer","description":"Location ID","format":"int32"},"name":{"type":"string","description":"Location name","nullable":true}},"additionalProperties":false}}}}
```

## POST /Participants/Get

> Retrieves participants data with filtering and pagination

```json
{"openapi":"3.0.4","info":{"title":"Customers","version":"v1.0"},"servers":[{"url":"https://stm-api.lsports.eu","variables":{"host":{"default":"https://stm-api.lsports.eu"}}}],"paths":{"/Participants/Get":{"post":{"tags":["Participants"],"summary":"Retrieves participants data with filtering and pagination","requestBody":{"content":{"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/GetParticipantsRequestDto"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetParticipantsRequestDto"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetParticipantsRequestDto"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/GetParticipantsRequestDto"}}}},"responses":{"200":{"description":"OK","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/GetParticipantsResponseDtoStandardResponse"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetParticipantsResponseDtoStandardResponse"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetParticipantsResponseDtoStandardResponse"}}}}}}}},"components":{"schemas":{"GetParticipantsRequestDto":{"required":["packageId","password","userName"],"type":"object","properties":{"packageId":{"type":"integer","format":"int32"},"userName":{"minLength":1,"type":"string"},"password":{"minLength":1,"type":"string"},"filter":{"$ref":"#/components/schemas/ParticipantFilterDto"},"page":{"maximum":2147483647,"minimum":1,"type":"integer","format":"int32"},"pageSize":{"maximum":500,"minimum":1,"type":"integer","format":"int32"}},"additionalProperties":false},"ParticipantFilterDto":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"integer","format":"int32"},"description":"Array of participant IDs to filter by","nullable":true},"sportIds":{"type":"array","items":{"type":"integer","format":"int32"},"description":"Array of sport IDs to filter by","nullable":true},"locationIds":{"type":"array","items":{"type":"integer","format":"int32"},"description":"Array of location IDs to filter by","nullable":true},"name":{"type":"string","description":"Name to search for (partial match)","nullable":true},"gender":{"$ref":"#/components/schemas/Gender"},"ageCategory":{"$ref":"#/components/schemas/AgeCategory"},"type":{"$ref":"#/components/schemas/ParticipantType"}},"additionalProperties":false},"Gender":{"enum":[1,2,3],"type":"integer","description":"* `1` - Men\n* `2` - Women\n* `3` - Mix","format":"int32"},"AgeCategory":{"enum":[0,1,2],"type":"integer","description":"* `0` - Regular\n* `1` - Youth\n* `2` - Reserves","format":"int32"},"ParticipantType":{"enum":[1,2,3,4,5,6,7],"type":"integer","description":"* `1` - Club\n* `2` - National\n* `3` - Individual\n* `4` - Virtual\n* `5` - Esports\n* `6` - VirtuReal\n* `7` - Doubles","format":"int32"},"GetParticipantsResponseDtoStandardResponse":{"type":"object","properties":{"header":{"$ref":"#/components/schemas/ResponseHeader"},"body":{"$ref":"#/components/schemas/GetParticipantsResponseDto"}},"additionalProperties":false},"ResponseHeader":{"type":"object","properties":{"httpStatusCode":{"type":"integer","format":"int32"},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ResponseError"},"nullable":true}},"additionalProperties":false},"ResponseError":{"type":"object","properties":{"message":{"type":"string","nullable":true}},"additionalProperties":false},"GetParticipantsResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ParticipantDto"},"nullable":true},"totalItems":{"type":"integer","format":"int32"}},"additionalProperties":false},"ParticipantDto":{"type":"object","properties":{"id":{"type":"integer","format":"int32"},"sportId":{"type":"integer","format":"int32"},"locationId":{"type":"integer","format":"int32"},"name":{"type":"string","nullable":true},"gender":{"$ref":"#/components/schemas/Gender"},"ageCategory":{"$ref":"#/components/schemas/AgeCategory"},"type":{"$ref":"#/components/schemas/ParticipantType"}},"additionalProperties":false}}}}
```

For details on how to use pagination in this endpoint, see the [Pagination Guide](https://docs.lsports.eu/u/trade/integration/apis/api-pagination).

## POST /Markets/Get

> Retrieves a list of markets based on various filters like sport, location, league, and market type.

```json
{"openapi":"3.0.1","info":{"title":"Customers","version":"v1.0"},"servers":[{"url":"https://stm-api.lsports.eu","variables":{"host":{"default":"https://stm-api.lsports.eu"}}}],"paths":{"/Markets/Get":{"post":{"tags":["Markets"],"summary":"Retrieves a list of markets based on various filters like sport, location, league, and market type.","requestBody":{"content":{"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/GetMarketsRequestDto"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetMarketsRequestDto"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetMarketsRequestDto"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/GetMarketsRequestDto"}}}},"responses":{"200":{"description":"Success","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/GetMarketsResponseDtoStandardResponse"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetMarketsResponseDtoStandardResponse"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetMarketsResponseDtoStandardResponse"}}}}}}}},"components":{"schemas":{"GetMarketsRequestDto":{"required":["packageId","password","userName"],"type":"object","properties":{"packageId":{"type":"integer","format":"int32"},"userName":{"minLength":1,"type":"string"},"password":{"minLength":1,"type":"string"},"sportsId":{"type":"array","items":{"type":"integer","format":"int32"},"nullable":true},"locationsId":{"type":"array","items":{"type":"integer","format":"int32"},"nullable":true},"leaguesId":{"type":"array","items":{"type":"integer","format":"int32"},"nullable":true},"marketsId":{"type":"array","items":{"type":"integer","format":"int32"},"nullable":true},"isSettleable":{"type":"boolean","nullable":true},"marketType":{"$ref":"#/components/schemas/MarketFilterEnum"},"languageId":{"type":"integer","format":"int32","nullable":true}},"additionalProperties":false},"MarketFilterEnum":{"enum":[0,1,2],"type":"integer","format":"int32"},"GetMarketsResponseDtoStandardResponse":{"type":"object","properties":{"header":{"$ref":"#/components/schemas/ResponseHeader"},"body":{"$ref":"#/components/schemas/GetMarketsResponseDto"}},"additionalProperties":false},"ResponseHeader":{"type":"object","properties":{"httpStatusCode":{"type":"integer","format":"int32"},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ResponseError"},"nullable":true}},"additionalProperties":false},"ResponseError":{"type":"object","properties":{"message":{"type":"string","nullable":true}},"additionalProperties":false},"GetMarketsResponseDto":{"type":"object","properties":{"markets":{"type":"array","items":{"$ref":"#/components/schemas/MarketResponse"},"nullable":true}},"additionalProperties":false},"MarketResponse":{"type":"object","properties":{"id":{"type":"integer","format":"int32"},"name":{"type":"string","nullable":true},"isSettleable":{"type":"boolean"}},"additionalProperties":false}}}}
```

## POST /Sports/Get

> Retrieves a list of sports.

```json
{"openapi":"3.0.1","info":{"title":"Customers","version":"v1.0"},"servers":[{"url":"https://stm-api.lsports.eu","variables":{"host":{"default":"https://stm-api.lsports.eu"}}}],"paths":{"/Sports/Get":{"post":{"tags":["Sports"],"summary":"Retrieves a list of sports.","requestBody":{"content":{"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/GetSportsRequestDto"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetSportsRequestDto"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetSportsRequestDto"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/GetSportsRequestDto"}}}},"responses":{"200":{"description":"Success","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/GetSportsResponseDtoStandardResponse"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetSportsResponseDtoStandardResponse"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetSportsResponseDtoStandardResponse"}}}}}}}},"components":{"schemas":{"GetSportsRequestDto":{"required":["packageId","password","userName"],"type":"object","properties":{"packageId":{"type":"integer","format":"int32"},"userName":{"minLength":1,"type":"string"},"password":{"minLength":1,"type":"string"},"languageId":{"type":"integer","format":"int32","nullable":true}},"additionalProperties":false},"GetSportsResponseDtoStandardResponse":{"type":"object","properties":{"header":{"$ref":"#/components/schemas/ResponseHeader"},"body":{"$ref":"#/components/schemas/GetSportsResponseDto"}},"additionalProperties":false},"ResponseHeader":{"type":"object","properties":{"httpStatusCode":{"type":"integer","format":"int32"},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ResponseError"},"nullable":true}},"additionalProperties":false},"ResponseError":{"type":"object","properties":{"message":{"type":"string","nullable":true}},"additionalProperties":false},"GetSportsResponseDto":{"type":"object","properties":{"sports":{"type":"array","items":{"$ref":"#/components/schemas/Sport"},"nullable":true}},"additionalProperties":false},"Sport":{"type":"object","properties":{"id":{"type":"integer","format":"int32"},"name":{"type":"string","nullable":true}},"additionalProperties":false}}}}
```

## POST /Incidents/Get

> Retrieves incidents data from internal service

```json
{"openapi":"3.0.4","info":{"title":"Customers","version":"v1.0"},"servers":[{"url":"https://stm-api.lsports.eu","variables":{"host":{"default":"https://stm-api.lsports.eu"}}}],"paths":{"/Incidents/Get":{"post":{"tags":["Incidents"],"summary":"Retrieves incidents data from internal service","requestBody":{"content":{"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/GetIncidentsRequestDto"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetIncidentsRequestDto"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetIncidentsRequestDto"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/GetIncidentsRequestDto"}}}},"responses":{"200":{"description":"OK","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/GetIncidentsResponseDtoStandardResponse"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetIncidentsResponseDtoStandardResponse"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetIncidentsResponseDtoStandardResponse"}}}}}}}},"components":{"schemas":{"GetIncidentsRequestDto":{"required":["packageId","password","userName"],"type":"object","properties":{"packageId":{"type":"integer","format":"int32"},"userName":{"minLength":1,"type":"string"},"password":{"minLength":1,"type":"string"},"filter":{"$ref":"#/components/schemas/IncidentFilterDto"}},"additionalProperties":false},"IncidentFilterDto":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"integer","format":"int32"},"nullable":true},"sports":{"type":"array","items":{"type":"integer","format":"int32"},"nullable":true},"from":{"type":"string","format":"date-time","nullable":true},"searchText":{"type":"array","items":{"type":"string"},"nullable":true}},"additionalProperties":false},"GetIncidentsResponseDtoStandardResponse":{"type":"object","properties":{"header":{"$ref":"#/components/schemas/ResponseHeader"},"body":{"$ref":"#/components/schemas/GetIncidentsResponseDto"}},"additionalProperties":false},"ResponseHeader":{"type":"object","properties":{"httpStatusCode":{"type":"integer","format":"int32"},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ResponseError"},"nullable":true}},"additionalProperties":false},"ResponseError":{"type":"object","properties":{"message":{"type":"string","nullable":true}},"additionalProperties":false},"GetIncidentsResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/IncidentDto"},"nullable":true},"totalItems":{"type":"integer","format":"int32"}},"additionalProperties":false},"IncidentDto":{"type":"object","properties":{"sportId":{"type":"integer","format":"int32"},"sportName":{"type":"string","nullable":true},"incidentId":{"type":"integer","format":"int32"},"incidentName":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"lastUpdate":{"type":"string","format":"date-time"},"creationDate":{"type":"string","format":"date-time"}},"additionalProperties":false}}}}
```

## POST /Seasons/Get

> Retrieves seasons optionally filtered by Season ID.

```json
{"openapi":"3.0.4","info":{"title":"Customers","version":"v1.0"},"servers":[{"url":"https://stm-api.lsports.eu","variables":{"host":{"default":"https://stm-api.lsports.eu"}}}],"paths":{"/Seasons/Get":{"post":{"tags":["Seasons"],"summary":"Retrieves seasons optionally filtered by Season ID.","requestBody":{"content":{"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/GetSeasonRequestDto"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetSeasonRequestDto"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetSeasonRequestDto"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/GetSeasonRequestDto"}}}},"responses":{"200":{"description":"Success","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/GetSeasonResponseDtoStandardResponse"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetSeasonResponseDtoStandardResponse"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetSeasonResponseDtoStandardResponse"}}}},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}}}}},"components":{"schemas":{"GetSeasonRequestDto":{"required":["packageId","password","userName"],"type":"object","properties":{"packageId":{"type":"integer","format":"int32"},"userName":{"minLength":1,"type":"string"},"password":{"minLength":1,"type":"string"},"seasonId":{"type":"integer","format":"int32","nullable":true}},"additionalProperties":false},"GetSeasonResponseDtoStandardResponse":{"type":"object","properties":{"header":{"$ref":"#/components/schemas/ResponseHeader"},"body":{"$ref":"#/components/schemas/GetSeasonResponseDto"}},"additionalProperties":false},"ResponseHeader":{"type":"object","properties":{"httpStatusCode":{"type":"integer","format":"int32"},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ResponseError"},"nullable":true}},"additionalProperties":false},"ResponseError":{"type":"object","properties":{"message":{"type":"string","nullable":true}},"additionalProperties":false},"GetSeasonResponseDto":{"type":"object","properties":{"seasons":{"type":"array","items":{"$ref":"#/components/schemas/SeasonItemDto"},"nullable":true}},"additionalProperties":false},"SeasonItemDto":{"type":"object","properties":{"seasonId":{"type":"integer","format":"int32"},"seasonName":{"type":"string","nullable":true}},"additionalProperties":false}}}}
```

## POST /Tours/Get

> Retrieves tours optionally filtered by Tour ID and/or Sport ID.

```json
{"openapi":"3.0.4","info":{"title":"Customers","version":"v1.0"},"servers":[{"url":"https://stm-api.lsports.eu","variables":{"host":{"default":"https://stm-api.lsports.eu"}}}],"paths":{"/Tours/Get":{"post":{"tags":["Tours"],"summary":"Retrieves tours optionally filtered by Tour ID and/or Sport ID.","requestBody":{"content":{"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/GetTourRequestDto"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetTourRequestDto"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetTourRequestDto"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/GetTourRequestDto"}}}},"responses":{"200":{"description":"Success","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/GetTourResponseDtoStandardResponse"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetTourResponseDtoStandardResponse"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetTourResponseDtoStandardResponse"}}}},"401":{"description":"Unauthorized"},"500":{"description":"Internal Server Error"}}}}},"components":{"schemas":{"GetTourRequestDto":{"required":["packageId","password","userName"],"type":"object","properties":{"packageId":{"type":"integer","format":"int32"},"userName":{"minLength":1,"type":"string"},"password":{"minLength":1,"type":"string"},"tourId":{"type":"integer","format":"int32","nullable":true},"sportId":{"type":"integer","format":"int32","nullable":true}},"additionalProperties":false},"GetTourResponseDtoStandardResponse":{"type":"object","properties":{"header":{"$ref":"#/components/schemas/ResponseHeader"},"body":{"$ref":"#/components/schemas/GetTourResponseDto"}},"additionalProperties":false},"ResponseHeader":{"type":"object","properties":{"httpStatusCode":{"type":"integer","format":"int32"},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ResponseError"},"nullable":true}},"additionalProperties":false},"ResponseError":{"type":"object","properties":{"message":{"type":"string","nullable":true}},"additionalProperties":false},"GetTourResponseDto":{"type":"object","properties":{"tours":{"type":"array","items":{"$ref":"#/components/schemas/TourItemDto"},"nullable":true}},"additionalProperties":false},"TourItemDto":{"type":"object","properties":{"tourId":{"type":"integer","format":"int32"},"tourName":{"type":"string","nullable":true},"sportId":{"type":"integer","format":"int32"},"sportName":{"type":"string","nullable":true}},"additionalProperties":false}}}}
```

* **Last Update Timestamp**: The `LastUpdate` field for each incident represents the last time the incident was sent from the TRADE system. It does **not** reflect the time when the incident itself was last modified or updated.
* **Creation Date Handling**: For incidents created **before May 28, 2025**, the `CreationDate` field is set to a default placeholder value of **01/01/00**.\
  Incidents created **on or after May 28, 2025** will reflect their **actual creation date** in the `CreationDate` field.

## POST /Translation/Get

> Retrieves translations for various entities (sports, locations, leagues, markets, participants) for specified languages.

```json
{"openapi":"3.0.1","info":{"title":"Customers","version":"v1.0"},"servers":[{"url":"https://stm-api.lsports.eu","variables":{"host":{"default":"https://stm-api.lsports.eu"}}}],"paths":{"/Translation/Get":{"post":{"tags":["Translation"],"summary":"Retrieves translations for various entities (sports, locations, leagues, markets, participants) for specified languages.","requestBody":{"content":{"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/GetTranslationRequestDto"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetTranslationRequestDto"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetTranslationRequestDto"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/GetTranslationRequestDto"}}}},"responses":{"200":{"description":"Success","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/GetTranslationResponseDtoStandardResponse"}},"application/json":{"schema":{"$ref":"#/components/schemas/GetTranslationResponseDtoStandardResponse"}},"text/json":{"schema":{"$ref":"#/components/schemas/GetTranslationResponseDtoStandardResponse"}}}}}}}},"components":{"schemas":{"GetTranslationRequestDto":{"required":["languages","packageId","password","userName"],"type":"object","properties":{"packageId":{"type":"integer","format":"int32"},"userName":{"minLength":1,"type":"string"},"password":{"minLength":1,"type":"string"},"languages":{"type":"array","items":{"type":"integer","format":"int32"}},"sportIds":{"type":"array","items":{"type":"integer","format":"int32"},"nullable":true},"locationIds":{"type":"array","items":{"type":"integer","format":"int32"},"nullable":true},"leagueIds":{"type":"array","items":{"type":"integer","format":"int32"},"nullable":true},"marketIds":{"type":"array","items":{"type":"integer","format":"int32"},"nullable":true},"participantIds":{"type":"array","items":{"type":"integer","format":"int32"},"nullable":true}},"additionalProperties":false},"GetTranslationResponseDtoStandardResponse":{"type":"object","properties":{"header":{"$ref":"#/components/schemas/ResponseHeader"},"body":{"$ref":"#/components/schemas/GetTranslationResponseDto"}},"additionalProperties":false},"ResponseHeader":{"type":"object","properties":{"httpStatusCode":{"type":"integer","format":"int32"},"errors":{"type":"array","items":{"$ref":"#/components/schemas/ResponseError"},"nullable":true}},"additionalProperties":false},"ResponseError":{"type":"object","properties":{"message":{"type":"string","nullable":true}},"additionalProperties":false},"GetTranslationResponseDto":{"type":"object","properties":{"sports":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/TranslationContainer"},"nullable":true},"nullable":true},"locations":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/TranslationContainer"},"nullable":true},"nullable":true},"leagues":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/TranslationContainer"},"nullable":true},"nullable":true},"markets":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/TranslationContainer"},"nullable":true},"nullable":true},"participants":{"type":"object","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/TranslationContainer"},"nullable":true},"nullable":true}},"additionalProperties":false},"TranslationContainer":{"type":"object","properties":{"languageId":{"type":"integer","format":"int32"},"value":{"type":"string","nullable":true}},"additionalProperties":false}}}}
```

* You must supply at least one of the non-mandatory fields to request the IDs you want to translate.
* If the request has no optional field to translate, the response will return an ErrorCode 400, and the message will include the error.
* If the request is without a Languages field, the response will return an error with an informative message.
