API JOGOS SANTA CASA

Métodos disponíveis NOVO

Consulte os jogos disponíveis e os resultados dos respetivos concursos através de quatro métodos REST.

Autenticação obrigatória

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.

eurodreamsEuroDreams
euromilhoesEuromilhões
chuva-milionariosChuva de Milionários
m1lhaoM1lhão
totolotoTotoloto
totobolaTotobola
totobola-extraTotobola Extra
lotaria-classicaLotaria Clássica
lotaria-popularLotaria Popular
01

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

GET/jsc/v1/jogos

Exemplo 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

CodigoIdentificador do jogo utilizado nos caminhos dos restantes métodos.
NomeNome legível do jogo.
UltimoConcursoObjeto com 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.
02

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.

GET/jsc/v1/{jogo}/ultimo

Parâmetros do caminho

jogostring · obrigatório

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

JogoObjeto com o Codigo e o Nome do jogo.
ConcursoNúmero do concurso.
AnoAno a que pertence o concurso.
ResultadoObjeto estruturado de acordo com o tipo de jogo.
ResultadoOriginalRepresentação textual completa do resultado.
DataPublicacaoData e hora de publicação em ISO 8601; pode ser null.
FonteEndereço da página associada ao resultado; pode ser null.
03

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.

GET/jsc/v1/{jogo}/resultados?ano={ano}&limite={limite}

Parâmetros

jogopath · string · obrigatório

Código do jogo a consultar.

anoquery · inteiro · opcional

Filtra os resultados por um ano entre 2000 e 2100. Sem este parâmetro, podem ser devolvidos concursos de anos diferentes.

limitequery · inteiro · opcional

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.

04

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.

GET/jsc/v1/{jogo}/{ano}/{concurso}

Parâmetros do caminho

jogostring · obrigatório

Código do jogo a consultar.

anointeiro · obrigatório

Ano do concurso, entre 2000 e 2100, no formato de quatro algarismos.

concursointeiro · obrigatório

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/"
}
JSON

Formato do resultado por jogo

O conteúdo de Resultado é estruturado de acordo com o tipo de jogo.

EuromilhõesNumeros contém cinco números e Estrelas contém duas estrelas.
EuroDreamsNumeros contém seis números e NumeroSonho identifica o número sonho.
TotolotoNumeros contém cinco números e NumeroSorte identifica o número da sorte.
M1lhãoCodigo contém o código vencedor.
TotobolaPrognosticos contém a sequência de prognósticos e Super14 o resultado adicional, quando existe.
LotariasPremios contém objetos com a Ordem e o Numero premiado.
Chuva de MilionáriosCodigos 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.

400invalid_jsc_parameters — ano ou limite está fora do intervalo aceite ou não é um número inteiro.
404jsc_game_not_found — o código indicado em jogo não existe ou não está disponível.
404jsc_result_not_found — não existe um resultado para o jogo ou concurso solicitado.