Métodos disponíveis NOVO
Consulte os jogos disponíveis e os resultados dos respetivos concursos através de quatro métodos REST.
Envie Authorization: Bearer CHAVE_API em todos os métodos desta página. Consulte a introdução para mais detalhes.
Códigos dos jogos
O parâmetro jogo aceita um dos seguintes códigos, sempre em minúsculas e sem espaços.
eurodreamsEuroDreamseuromilhoesEuromilhõeschuva-milionariosChuva de Milionáriosm1lhaoM1lhãototolotoTotolotototobolaTotobolatotobola-extraTotobola Extralotaria-classicaLotaria Clássicalotaria-popularLotaria PopularListar jogos NOVO
Devolve todos os jogos disponíveis. Cada elemento inclui o código a utilizar nos restantes métodos, a identificação do concurso mais recente e o respetivo resultado.
/jsc/v1/jogosExemplo de pedido
http GET https://api.ptapi.net/jsc/v1/jogos
Exemplo de resposta
[
{
"Codigo": "euromilhoes",
"Nome": "Euromilhões",
"UltimoConcurso": {
"Ano": 2026,
"Concurso": 81,
"Resultado": {
"Numeros": [5, 20, 24, 31, 45],
"Estrelas": [5, 10]
}
}
}
]Campos devolvidos
Ano, Concurso e Resultado. O resultado é estruturado de acordo com o tipo de jogo. O objeto é null quando ainda não existe um resultado disponível.Obter o último resultado NOVO
Devolve o concurso mais recente do jogo indicado. É a forma mais direta de apresentar o resultado atual sem conhecer previamente o ano ou o número do concurso.
/jsc/v1/{jogo}/ultimoParâmetros do caminho
Código do jogo. Por exemplo, euromilhoes, totoloto ou m1lhao.
Exemplo de pedido
http GET https://api.ptapi.net/jsc/v1/euromilhoes/ultimo
Exemplo de resposta
{
"Jogo": {
"Codigo": "euromilhoes",
"Nome": "Euromilhões"
},
"Concurso": 81,
"Ano": 2026,
"Resultado": {
"Numeros": [7, 12, 19, 34, 45],
"Estrelas": [3, 8]
},
"ResultadoOriginal": "7 12 19 34 45 + 3 8",
"DataPublicacao": "2026-10-09T20:35:00.000Z",
"Fonte": "https://www.jogossantacasa.pt/"
}Campos devolvidos
Codigo e o Nome do jogo.null.null.Listar resultados NOVO
Devolve os resultados do jogo por ordem decrescente de ano e concurso. Pode limitar a quantidade e restringir a pesquisa a um ano.
/jsc/v1/{jogo}/resultados?ano={ano}&limite={limite}Parâmetros
Código do jogo a consultar.
Filtra os resultados por um ano entre 2000 e 2100. Sem este parâmetro, podem ser devolvidos concursos de anos diferentes.
Número máximo de resultados, entre 1 e 100. O valor predefinido é 20.
Exemplo de pedido
http GET "https://api.ptapi.net/jsc/v1/totoloto/resultados?ano=2026&limite=2"
Exemplo de resposta
{
"Jogo": "totoloto",
"Ano": 2026,
"Limite": 2,
"Resultados": [
{
"Jogo": { "Codigo": "totoloto", "Nome": "Totoloto" },
"Concurso": 81,
"Ano": 2026,
"Resultado": {
"Numeros": [4, 13, 22, 31, 47],
"NumeroSorte": 5
},
"ResultadoOriginal": "4 13 22 31 47 + 5",
"DataPublicacao": "2026-10-10T20:30:00.000Z",
"Fonte": "https://www.jogossantacasa.pt/"
}
]
}O campo Resultados é um array e pode ser devolvido vazio quando o jogo existe, mas não há concursos que correspondam ao ano indicado.
Obter um concurso específico NOVO
Procura um único resultado através da combinação exata do código do jogo, ano e número de concurso.
/jsc/v1/{jogo}/{ano}/{concurso}Parâmetros do caminho
Código do jogo a consultar.
Ano do concurso, entre 2000 e 2100, no formato de quatro algarismos.
Número do concurso, entre 1 e 9999.
Exemplo de pedido
http GET https://api.ptapi.net/jsc/v1/lotaria-classica/2026/41
Exemplo de resposta
{
"Jogo": { "Codigo": "lotaria-classica", "Nome": "Lotaria Clássica" },
"Concurso": 41,
"Ano": 2026,
"Resultado": {
"Premios": [
{ "Ordem": 1, "Numero": "54321" },
{ "Ordem": 2, "Numero": "12345" },
{ "Ordem": 3, "Numero": "98765" }
]
},
"ResultadoOriginal": "1.º Premio: 54321 2.º Premio: 12345 3.º Premio: 98765",
"DataPublicacao": "2026-10-10T18:00:00.000Z",
"Fonte": "https://www.jogossantacasa.pt/"
}Formato do resultado por jogo
O conteúdo de Resultado é estruturado de acordo com o tipo de jogo.
Numeros contém cinco números e Estrelas contém duas estrelas.Numeros contém seis números e NumeroSonho identifica o número sonho.Numeros contém cinco números e NumeroSorte identifica o número da sorte.Codigo contém o código vencedor.Prognosticos contém a sequência de prognósticos e Super14 o resultado adicional, quando existe.Premios contém objetos com a Ordem e o Numero premiado.Codigos contém a lista de códigos vencedores.Erros do serviço
Além dos erros gerais da plataforma, estes códigos podem ser devolvidos pelos métodos desta página.
invalid_jsc_parameters — ano ou limite está fora do intervalo aceite ou não é um número inteiro.jsc_game_not_found — o código indicado em jogo não existe ou não está disponível.jsc_result_not_found — não existe um resultado para o jogo ou concurso solicitado.