LOTTO OpenAPI (v1.0)

Pobierz specyfikację OpenAPI:Pobierz

Specyfikacja

Usługa LOTTO OpenAPI pozwala na pobranie powszechnie dostępnych danych przez usługę REST, są to m.in. wyniki, wygrane, statystyki, informacje o grach Totalizatora Sportowego, czy też różne statystyki.

Treści te są udostępniane bezpłatnie, a aby uzyskać dostęp do usługi LOTTO OpenAPI, wystarczy skontaktować się z nami przez adres email: [email protected], lub przez formularz kontaktowy: https://www.lotto.pl/kontakt. W treści prosimy o podanie: imienia, nazwiska, nazwy firmy (jeśli istnieje) oraz adresu email i numeru telefonu. Na tej podstawie utworzymy dostęp do LOTTO OpenAPI i wygenerujemy dla Ciebie klucz API key, który będzie służył do autoryzacji zapytań.

Autoryzacja

Usługa LOTTO OpenAPI udostępnia autoryzacje dostępu do metod za pomocą API key, który jest tokenem autoryzacyjnym.

Autoryzacja za pomocą klucza API (API Key) to metoda uwierzytelniania, w której użytkownik lub aplikacja klienta musi przesłać specjalny klucz w nagłówku żądania HTTP, aby uzyskać dostęp do zasobów serwera API. Klucz API jest unikalnym identyfikatorem, który serwer używa do weryfikacji tożsamości klienta i uprawnień do wykonania określonych operacji.

Przykład nagłówków:

accept: application/json
secret: GNq0pdsAAW2fPgXokLyZ4a8pJ1KEkKaj7kPICqQVbwg=

Przykład zapytania:

GET https://developers.lotto.pl/api/api/open/v1/departments?City=Kraków HTTP/1.1

ApiKey

API Key token autoryzacyjny. Przykład: "secret {key}"

Security Scheme Type: API Key

Header parameter name: secret

Ogólne informacje

Informacje na temat gier.

Informacje na temat gry

Ogólne (opisowe) informacje na temat wybranej gry.

Authorizations:

ApiKey

query Parameters

gameType

string

Typ gry

Dostępne wartości:

Lotto
EuroJackpot
MultiMulti
MiniLotto
Kaskada
Keno
EkstraPensja
EkstraPremia
Szybkie600
ZakladySpecjalne

Responses

Response samples

200
400
401
404
422

Content type

application/json

{"gameType": "string",
"nextDrawDate": "2019-08-24T14:15:22Z",
"closestPrizeValue": 0.1,
"draws": "string",
"couponPrice": "string",
"closestPrizePoolType": "string"
}

Wartość kumulacji

Wartość kumulacji dla gier kumulacyjnych – Lotto oraz Eurojackpot. Dla pozostałych zwraca najwyższą wartość możliwą do wygrania.

Authorizations:

ApiKey

query Parameters

gameType

string

Typ gry

Dostępne wartości:

Lotto
LottoPlus
EuroJackpot
MultiMulti
MiniLotto
Kaskada
Keno
EkstraPensja
EkstraPremia
Szybkie600
ZakladySpecjalne

Responses

Response samples

200
400
401
422

Content type

application/json

{"jackpotValue": 0.1,
"jackpotPlusValue": 0.1,
"closestDraw": "2019-08-24T14:15:22Z"
}

Następne losowanie

Authorizations:

ApiKey

query Parameters

gameType

string

Typ gry

Dostępne wartości:

Lotto
LottoPlus
EuroJackpot
MultiMulti
MiniLotto
Kaskada
Keno
EkstraPensja
EkstraPremia
Szybkie600
ZakladySpecjalne

Responses

Response samples

200
400
401
404
422

Content type

application/json

{"gameType": "string",
"closestPrizeValue": 0.1,
"nextDrawDate": "2019-08-24T14:15:22Z",
"playSitePath": "string"
}

Wyniki

Informacje na temat wyników.

Wyniki dla określonej daty

Ostatnie wyniki dla określonej daty. W zapytaniu należy podać zarówno datę jak i godzinę losowania.

Authorizations:

ApiKey

query Parameters

drawDate

string <date-time>

Data losowania

Responses

Response samples

200
401
404

Content type

application/json

[{"drawSystemId": 0,
"drawDate": "2019-08-24T14:15:22Z",
"gameType": "string",
"multiplierValue": 0,
"results": [{"drawDate": "2019-08-24T14:15:22Z",
"drawSystemId": 0,
"gameType": "string",
"resultsJson": [0
],
"specialResults": [0
]
}
],
"showSpecialResults": true,
"isNewEuroJackpotDraw": true
}
]

Wyniki dla określonej daty oraz typu gry

Ostatnie wyniki dla określonej daty oraz typu gry. W zapytaniu należy podać zarówno datę losowania oraz typ gry. Dodatkowo można doprecyzować godzinę oraz minutę losowania.

Authorizations:

ApiKey

query Parameters

hour	integer <int32> Godzina losowania
minute	integer <int32> Minuta losowania
gameType required	string Typ gry Dostępne wartości: Lotto LottoPlus EuroJackpot MultiMulti MiniLotto Kaskada Keno EkstraPensja EkstraPremia Szybkie600 ZakladySpecjalne
drawDate required	string <date-time> Data losowania
index required	integer <int32> Indeks. Wartość 'index' > 0
size required	integer <int32> Rozmiar listy. Wartość 'size' > 0
sort required	string Pole sortowania. Dostępne wartości: Wszystkie właściwości obiektu o określonym typie pola 'items'
order required	string Kolejność sortowania. Dostępne wartości: ASC - rosnąco DESC - malejąco

Responses

Response samples

200
404

Content type

text/plain

No sample

Ostatnie wyniki

Ostatnie wyniki losowań dla wszystkich gier liczbowych i loterii pieniężnych.

Authorizations:

ApiKey

Responses

Response samples

200
401
404

Content type

application/json

[{"drawSystemId": 0,
"drawDate": "2019-08-24T14:15:22Z",
"gameType": "string",
"multiplierValue": 0,
"results": [{"drawDate": "2019-08-24T14:15:22Z",
"drawSystemId": 0,
"gameType": "string",
"resultsJson": [0
],
"specialResults": [0
]
}
],
"showSpecialResults": true,
"isNewEuroJackpotDraw": true
}
]

Ostatnie wyniki dla wybranej gry

Ostatnie wyniki losowań dla wybranej gry liczbowej lub loterii pieniężnej.

Authorizations:

ApiKey

query Parameters

gameType

string

Typ gry

Dostępne wartości:

Lotto
LottoPlus
EuroJackpot
MultiMulti
MiniLotto
Kaskada
Keno
EkstraPensja
EkstraPremia
Szybkie600
ZakladySpecjalne

Responses

Response samples

200
401
404

Content type

application/json

[{"drawSystemId": 0,
"drawDate": "2019-08-24T14:15:22Z",
"gameType": "string",
"multiplierValue": 0,
"results": [{"drawDate": "2019-08-24T14:15:22Z",
"drawSystemId": 0,
"gameType": "string",
"resultsJson": [0
],
"specialResults": [0
]
}
],
"showSpecialResults": true,
"isNewEuroJackpotDraw": true
}
]

Wygrane

Informacje na temat wygranych.

Liczba wygranych

Liczba wygranych każdego stopnia dla wybranej gry liczbowej lub loterii pieniężnej z wyjątkiem Multi Multi, EuroJackpot, Szybkie600 oraz Keno. Liczba zwracana jest dla danego identyfikatora losowania.

Authorizations:

ApiKey

path Parameters

drawType required	string Typ gry Dostępne wartości: Lotto LottoPlus MiniLotto Kaskada EkstraPensja EkstraPremia ZakladySpecjalne
drawSystemId required	integer <int64> Numer losowania

Responses

Response samples

200
401
404

Content type

application/json

[{"drawDate": "2019-08-24T14:15:22Z",
"drawSystemId": 0,
"gameType": "string",
"prizesEmpty": true,
"prizes": {"property1": {"prize": 0,
"prizeValue": 0.1
},
"property2": {"prize": 0,
"prizeValue": 0.1
}
}
}
]

Liczba wygranych – Eurojackpot

Liczba wygranych dla każdego stopnia gry liczbowej EuroJackpot. Liczba zwracana jest dla danego identyfikatora losowania.

Authorizations:

ApiKey

path Parameters

drawSystemId

required

integer <int64>

Numer losowania

Responses

Response samples

200
401
404

Content type

application/json

{"drawDate": "2019-08-24T14:15:22Z",
"drawSystemId": 0,
"gameType": "string",
"prizesEmpty": true,
"prizes": {"property1": {"prize": 0,
"prizeValue": 0.1
},
"property2": {"prize": 0,
"prizeValue": 0.1
}
},
"countriesPrizes": [{"degree": 0,
"countWinners": 0,
"prizesValues": [{"country": "string",
"prizeValue": 0.1
}
]
}
]
}

Liczba wygranych - Keno

Liczba wygranych dla każdego stopnia gry liczbowej Keno. Liczba zwracana jest dla danego identyfikatora losowania.

Authorizations:

ApiKey

path Parameters

drawSystemId

required

integer <int64>

Numer losowania

Responses

Response samples

200
401
404

Content type

application/json

[{"drawDate": "2019-08-24T14:15:22Z",
"drawSystemId": 0,
"gameType": "string",
"prizesEmpty": true,
"prizes": {"property1": {"prize": 0,
"prizeValue": 0.1
},
"property2": {"prize": 0,
"prizeValue": 0.1
}
}
}
]

Liczba wygranych – Multi Multi

Liczba wygranych dla każdego stopnia gry liczbowej Multi Multi. Liczba zwracana jest dla danego identyfikatora losowania.

Authorizations:

ApiKey

path Parameters

drawSystemId

required

integer <int64>

Numer losowania

Responses

Response samples

200
401
404

Content type

application/json

[{"drawDate": "2019-08-24T14:15:22Z",
"drawSystemId": 0,
"gameType": "string",
"prizesEmpty": true,
"prizes": {"property1": 0,
"property2": 0
},
"prizesValues": {"property1": 0.1,
"property2": 0.1
}
}
]

Liczba wygranych - Szybkie 600

Liczba wygranych dla każdego stopnia gry liczbowej Szybkie 600. Liczba zwracana jest dla danego identyfikatora losowania.

Authorizations:

ApiKey

path Parameters

drawSystemId

required

integer <int64>

Numer losowania

Responses

Response samples

200
401
404

Content type

application/json

[{"drawDate": "2019-08-24T14:15:22Z",
"drawSystemId": 0,
"gameType": "string",
"prizesEmpty": true,
"prizes": {"property1": {"prize": 0,
"prizeValue": 0.1
},
"property2": {"prize": 0,
"prizeValue": 0.1
}
},
"bonus": {"available": true,
"degree": 0,
"amount": 0.1,
"amountUnit": 0.1
}
}
]

Największe wygrane

Informacje na temat największych wygranych.

Lista największych wygranych

Authorizations:

ApiKey

query Parameters

games	string Gry. Dostępne wartości: Lotto LottoPlus MiniLotto Kaskada Keno EkstraPensja EkstraPremia Szybkie600 ZakladySpecjalne Wartości w zapytaniu można podawać po przecinku. Przykład: games=Lotto,LottoPlus,MiniLotto
place	string Miejsce.
onlyOnlineWins	boolean Tylko wygrane online.
scratchId	integer <int64> Identyfikator zdrapki.
index required	integer <int32> Indeks. Wartość 'index' > 0
size required	integer <int32> Rozmiar listy. Wartość 'size' > 0
sort required	string Pole sortowania. Dostępne wartości: Wszystkie właściwości obiektu o określonym typie pola 'items'
order required	string Kolejność sortowania. Dostępne wartości: ASC - rosnąco DESC - malejąco

Responses

Response samples

200
401
404
422

Content type

application/json

{"code": 0,
"message": "string",
"showMorePossible": true,
"totalRows": 0,
"items": [{"gameType": "string",
"bonus": 0.1,
"winDateUtc": "2019-08-24T14:15:22Z",
"amountFixed": 0.1,
"years": 0,
"withPlus": true,
"onlineWin": true,
"pictureUrl": "string",
"place": "string",
"address": "string",
"playSitePath": "string",
"system": "string",
"rank": "string",
"rate": "string",
"scratchName": "string",
"gierkaName": "string",
"scratchUrl": "string",
"ekspresLosName": "string",
"ekspresLosUrl": "string",
"multiplier": 0
}
],
"meta": null
}

Statystyki

Informacje na temat statystyk.

Częstość występowania liczb

Statystyki najczęściej występujących liczb w danej grze dla określonego przedziału czasowego.

Authorizations:

ApiKey

query Parameters

gameType	string Typ gry Dostępne wartości: Lotto LottoPlus EuroJackpot MultiMulti MiniLotto Kaskada Keno EkstraPensja EkstraPremia Szybkie600 ZakladySpecjalne
dateFrom	string <date-time> Data od.
dateTo	string <date-time> Data do.

Responses

Response samples

200
401
404

Content type

application/json

{"totalDraws": 0,
"numberFrequrency": [{"number": 0,
"numberOfOccurrences": 0,
"percentOfOccurrences": 0
}
],
"numberSpecialFrequrency": [{"number": 0,
"numberOfOccurrences": 0,
"percentOfOccurrences": 0
}
]
}

Gierki

Informacje na temat gierek.

Lista Gierek

Lista Gierek wraz ze szczegółami.

Authorizations:

ApiKey

query Parameters

name	string Nazwa
status	string Status Dostępne wartości: Novelity - Nowość Active - Aktywne
category	string Kategoria Dostępne wartości: All - Wszystkie Novelity - Nowość HighestWins - Największe wygrane HighestChance - Największa szansa FavoriteGames - Ulubione gry
index required	integer <int32> Indeks. Wartość 'index' > 0
size required	integer <int32> Rozmiar listy. Wartość 'size' > 0
sort required	string Pole sortowania. Dostępne wartości: Wszystkie właściwości obiektu o określonym typie pola 'items'
order required	string Kolejność sortowania. Dostępne wartości: ASC - rosnąco DESC - malejąco

Responses

Response samples

200
401
404
422

Content type

application/json

{"code": 0,
"message": "string",
"showMorePossible": true,
"totalRows": 0,
"items": [{"logoUrl": "string",
"bannerUrl": "string",
"bannerBlurUrl": "string",
"bannerRectangularUrl": "string",
"bannerHomePageUrl": "string",
"name": "string",
"id": 0,
"highestWin": 0,
"buttonText": "string",
"buttonURL": "string",
"dateRelease": "2019-08-24T14:15:22Z",
"description": "string",
"additionalDescription": "string",
"backgroundColor": "string",
"summaryWinningAmount": 0,
"highestChanceStake": 0.1,
"status": "string"
}
],
"meta": null
}

Szczegóły Gierki

Szczegóły dla danej gierki – stawki, wygrane, kwoty do wygrania.

Authorizations:

ApiKey

path Parameters

id

required

integer <int64>

Identyfikator Gierki

Responses

Response samples

200
401
404

Content type

application/json

{"code": 0,
"message": "string",
"result": {"id": 0,
"description": "string",
"additionalDescription": "string",
"name": "string",
"status": "string",
"logoUrl": "string",
"bannerUrl": "string",
"bannerRectangularUrl": "string",
"bannerSecondDesktopUrl": "string",
"bannerTabletUrl": "string",
"bannerMobileUrl": "string",
"bannerBlurUrl": "string",
"highestWin": 0,
"drawPrice": 0,
"extensiveDescription": "string",
"summaryWinningAmount": 0,
"dateCompletion": "2019-08-24T14:15:22Z",
"gierkiWins": [{"place": "string",
"winDate": "2019-08-24T14:15:22Z",
"amount": 0.1
}
],
"prizes": [{"number": 0,
"stack": 0.1,
"numberOfSelectedDigits": 0
}
],
"degrees": [{"stackNumber": 0,
"degree": 0,
"winningAmount": 0.1,
"numberTicketsWon": 0,
"numberOfRemainingWinners": 0,
"winningAmountSummary": 0.1
}
],
"regulations": [{"number": 0,
"regulation": "string"
}
]
},
"meta": null
}

Ekspres Losy

Informacje na temat ekspres losów.

Lista Ekspres losów

Lista Ekspres Losów wraz ze szczegółami.

Authorizations:

ApiKey

query Parameters

name	string Nazwa.
status	string Status Dostępne wartości: Standard - Standardowe LastChance - Ostatnia szansa Novelity - Nowość Debut - Debiut Announcement - Ogłoszenie SalesEnd - Zakończenie sprzedaży Archival - Archiwalne
yearSalesEnd	integer <int32> Rok zakończenia sprzedaży.
index required	integer <int32> Indeks. Wartość 'index' > 0
size required	integer <int32> Rozmiar listy. Wartość 'size' > 0
sort required	string Pole sortowania. Dostępne wartości: Wszystkie właściwości obiektu o określonym typie pola 'items'
order required	string Kolejność sortowania. Dostępne wartości: ASC - rosnąco DESC - malejąco

Responses

Response samples

200
401
404
422

Content type

application/json

{"code": 0,
"message": "string",
"showMorePossible": true,
"totalRows": 0,
"items": [{"emissionNumber": 0,
"drawPrice": 0,
"pictureUrl": "string",
"name": "string",
"hit": true,
"id": 0,
"dateSales": "2019-08-24T14:15:22Z",
"dateSalesEnd": "2019-08-24T14:15:22Z",
"highestWin": 0,
"status": "string"
}
],
"meta": null
}

Szczegóły Ekspres Losu

Szczegóły dla danego ekspres losu – stawki, wygrane, kwoty do wygrania.

Authorizations:

ApiKey

path Parameters

id

required

integer <int64>

Responses

Response samples

200
401
404

Content type

application/json

{"code": 0,
"message": "string",
"result": {"description": "string",
"dateSales": "2019-08-24T14:15:22Z",
"descriptionAdditional": "string",
"name": "string",
"status": "string",
"emissionNumber": 0,
"mainImageUrl": "string",
"legalNote": "string",
"highestWin": 0,
"hit": true,
"circulation": 0,
"drawPrice": 0,
"currentWinningsPrizesPool": 0,
"dateClaimsEnd": "2019-08-24T14:15:22Z",
"regulations": [{"name": "string",
"url": "string"
}
],
"prizes": [{"number": 0,
"quantityLeft": 0,
"quantity": 0,
"prize": 0.1
}
],
"ekspresLosWins": [{"place": "string",
"winDate": "2019-08-24T14:15:22Z",
"ekspresLosFileUrl": "string",
"amount": 0.1
}
]
},
"meta": null
}

Zdrapki

Informacje na temat zdrapek.

Lista Zdrapek

Lista Zdrapek wraz ze szczegółami.

Authorizations:

ApiKey

query Parameters

name	string Nazwa
status	string Status Dostępne wartości: Standard - Standardowe LastChance - Ostatnia szansa Novelity - Nowość Debut - Debiut Announcement - Ogłoszenie SalesEnd - Zakończenie sprzedaży Archival - Archiwalne
yearSalesEnd	integer <int32> Rok zakończenia sprzedaży
index required	integer <int32> Indeks. Wartość 'index' > 0
size required	integer <int32> Rozmiar listy. Wartość 'size' > 0
sort required	string Pole sortowania. Dostępne wartości: Wszystkie właściwości obiektu o określonym typie pola 'items'
order required	string Kolejność sortowania. Dostępne wartości: ASC - rosnąco DESC - malejąco

Responses

Response samples

200
401
404
422

Content type

application/json

{"code": 0,
"message": "string",
"showMorePossible": true,
"totalRows": 0,
"items": [{"number": 0,
"drawPrice": 0,
"pictureUrl": "string",
"name": "string",
"id": 0,
"hit": true,
"dateSales": "2019-08-24T14:15:22Z",
"dateSalesEnd": "2019-08-24T14:15:22Z",
"highestWin": 0,
"popularity": 0,
"status": "string"
}
],
"meta": null
}

Szczegóły Zdrapki

Szczegóły dla danej Zdrapki – stawki, wygrane, kwoty do wygrania.

Authorizations:

ApiKey

path Parameters

id

required

integer <int64>

Identyfikator Zdrapki

Responses

Response samples

200
401
404

Content type

application/json

{"code": 0,
"message": "string",
"result": {"description": "string",
"dateSales": "2019-08-24T14:15:22Z",
"descriptionAdditional": "string",
"name": "string",
"popularity": 0,
"status": "string",
"number": 0,
"flashImageUrl": "string",
"scratchImageUrl": "string",
"legalNote": "string",
"highestWin": 0,
"circulation": 0,
"drawPrice": 0,
"currentWinningsPrizesPool": 0,
"hit": true,
"dateClaimsEnd": "2019-08-24T14:15:22Z",
"regulations": [{"name": "string",
"url": "string"
}
],
"prizes": [{"number": 0,
"quantityLeft": 0,
"quantity": 0,
"prize": 0.1
}
],
"scratchWins": [{"place": "string",
"winDate": "2019-08-24T14:15:22Z",
"scratchFileUrl": "string",
"amount": 0.1
}
]
},
"meta": null
}

Punkty LOTTO

Informacje na temat Odziałów Punktów LOTTO.

Lista wszystkich punktów LOTTO

Lista wszystkich punktów LOTTO, w których można zakupić kupon lub los.

Authorizations:

ApiKey

query Parameters

index required	integer <int32> Indeks. Wartość 'index' > 0
size required	integer <int32> Rozmiar listy. Wartość 'size' > 0
sort required	string Pole sortowania. Dostępne wartości: Wszystkie właściwości obiektu o określonym typie pola 'items'
order required	string Kolejność sortowania. Dostępne wartości: ASC - rosnąco DESC - malejąco

Responses

Response samples

200
401
404

Content type

application/json

{"code": 0,
"message": "string",
"showMorePossible": true,
"totalRows": 0,
"items": [{"gpsX": 0.1,
"gpsY": 0.1,
"number": "string",
"card": 0,
"verificationPoint": 0,
"ioGadgetsPickup": 0,
"giftCardPickup": 0,
"pointName": "string",
"today": "string"
}
],
"meta": null
}

Oddziały Totalizatora Sportowego

Informacje na temat Oddziałów Totalizatora Sportowego.

Lista wszystkich Oddziałów Totalizatora Sportowego

W Oddziałach Totalizatora Sportowego, możesz odebrać wysokie wygrane i załatwić wszystkie sprawy formalne.

Authorizations:

ApiKey

query Parameters

Name	string Przykłady: Name=Warszawa - I Oddział - Przykład 1 Name=Kraków - II Oddział - Przykład 2 Nazwa odziału.
City	string Przykłady: City=Warszawa - Przykład 1 City=Kraków - Przykład 2 Miasto odziału.

Responses

Response samples

200
401

Content type

application/json

[{"address": "string",
"city": "string",
"comments": "string",
"email": "string",
"gpsX": 0.1,
"gpsY": 0.1,
"name": "string",
"openingHours": [{"openHour": "string",
"closeHour": "string",
"day": 0
}
],
"phoneNumber": "string",
"zipCode": "string"
}
]