Carregando
Documentação técnica

API de Consulta de Resultados

Consulte resultados de loterias sob demanda através de requisições autenticadas. Informe data, loteria e, opcionalmente, extração para receber os resultados em JSON.

LI
Versão da documentação 1.0 Junho/2026
Método: GET ou POST
Autenticação: Bearer Token
Retorno: JSON
Controle: Limite mensal
01

Visão geral

A API de Consulta de Resultados permite que o usuário busque resultados diretamente no endpoint da Loteria Integrada. Diferente da API de Resultados Automáticos, esta API não envia dados para o usuário: o usuário realiza a requisição e recebe o retorno conforme os parâmetros informados.

Consulta sob demandaBusque resultados por data, loteria e extração.
Token BearerToda requisição precisa estar autenticada.
Retorno estruturadoResposta em JSON pronta para integrar ao site ou app.
02

Ferramentas disponíveis no painel

Token de acesso

Visualize ou altere o token usado nas requisições autenticadas.

Consumo mensal

Acompanhe o total de consultas utilizadas no período.

Histórico de consultas

Veja data, IP, origem, parâmetros e payload retornado.

Pausar loterias

Permite pausar consultas para loterias específicas.

Controle administrativo

O módulo pode ser pausado por renovação, limite ou regra administrativa.

Origem das requisições

Registra IP, referer, origin, user-agent e endpoint utilizado.

03

Início rápido

  1. Copie seu token no painel da API de Consulta de Resultados.
  2. Envie uma requisição para o endpoint usando GET ou POST.
  3. Informe os parâmetros obrigatórios: data e loteria.
  4. Opcionalmente informe a extração usando extracao. Se não informar, a API retorna todas as extrações disponíveis da data/loteria.
Payload básico
{
    "data": "2026-06-11",
    "loteria": "rj",
    "extracao": "21"
}
04

Autenticação

Todas as consultas exigem token no cabeçalho Authorization, usando o formato Bearer. Requisições sem token, com token inválido ou fora do formato esperado serão recusadas.

Header obrigatório
Authorization: Bearer 7520E9D23B3D7E48AFCE4D0B
Use exatamente o formato Bearer SEU_TOKEN. Não use X-Auth-Token nesta API.
05

Endpoint

O endpoint aceita requisições GET, POST JSON ou POST form-data/x-www-form-urlencoded.

URL da API
https://api.lotoserv.com/resultados/consulta/v1/
POST JSONContent-Type: application/jsonRecomendado para integrações em sistemas e aplicativos.
GET?data=2026-06-05&loteria=rjÚtil para testes rápidos ou consultas simples.
06

Parâmetros da consulta

CampoObrigatórioFormatoDescrição
dataSimY-m-d ou d/m/YData do resultado desejado. Ex.: 2026-06-05 ou 05/06/2026.
loteriaSim2 ou 3 letrasSigla da loteria. Ex.: rj, lk, fd.
extracaoNão00 a 23Número da extração. Se omitido, retorna todas as extrações da data/loteria.
A API valida se a loteria está liberada no contrato do usuário e se a loteria não está pausada no painel.
07

Resposta da API

Quando a consulta é realizada com sucesso, a API retorna os dados do usuário, informações da consulta e uma lista de resultados encontrados.

CampoDescrição
usuarioIdentificação do terminal, site/app e usuário.
consultaNúmero da consulta, data/hora e IP da requisição.
informacoesData, loteria, sigla, extração e total de resultados.
dados.resultadosLista com os resultados encontrados.
resultadoObjeto com os prêmios separados por posição.
ResultadoResultado completo em string separada por vírgulas.
Soma, Multiplicacao, Super5, Salteado, ConcursoCampos extras retornados quando disponíveis.
Exemplo de resposta
{
    "usuario": {
        "terminal": "123456",
        "site_app": "Meu Site ou Aplicativo",
        "usuário_id": "ABC123"
    },
    "consulta": {
        "numero": 18,
        "data": "11/06/2026 15:46:45",
        "ip": "000.000.000.000"
    },
    "informacoes": {
        "tipo_api": "Consulta de Resultados",
        "data": "2026-06-11",
        "data_formatada": "11/06/2026",
        "loteria": "PT Rio de Janeiro",
        "sigla": "rj",
        "extracao": "21",
        "extracao_nome": "Rio 21 horas",
        "total_resultados": 1
    },
    "dados": {
        "resultados": [
            {
                "data": "2026-06-11",
                "data_formatada": "11/06/2026",
                "loteria": "rj",
                "extracao": "21",
                "titulo": "Rio 21 horas",
                "resultado": {
                    "1": "9423",
                    "2": "1254",
                    "3": "9751",
                    "4": "4571",
                    "5": "0325"
                },
                "Resultado": "9423,1254,9751,4571,0325",
                "Soma": "29324",
                "Multiplicacao": "923",
                "Salteado": "92"
            }
        ]
    }
}
08

Loterias disponíveis, siglas e extrações

Use a coluna Sigla no parâmetro loteria. Algumas loterias compartilham a mesma sigla e são diferenciadas pela extração.

LoteriaSiglaExtraçõesPrêmiosObservações
PT Rio de Janeirorj09, 11, 14, 16, 18, 211º ao 7ºPossui salteado quando disponível.
Maluquinha Rio de Janeiromrj09, 11, 14, 16, 18, 211º ao 7º-
Loteria Nacionalln02, 08, 10, 12, 15, 17, 20, 231º ao 7º-
Loteria Federalfd191º ao 7ºResultado federal.
Look Goiáslk07, 09, 11, 14, 16, 18, 21, 231º ao 7ºPossui Super5 quando disponível.
Boa Sorte Goiásbs09, 11, 14, 16, 18, 211º ao 7ºPossui Super5 quando disponível.
PT São Paulosp08, 10, 12, 13, 17, 19, 201º ao 7º-
Bandeirantes São Paulosp151º ao 7ºMesma sigla de São Paulo, extração 15.
Lotep Paraíbapb10, 12, 15, 181º ao 10ºPreenche do 6º ao 10º prêmio.
PT Paraíbapb09, 201º ao 10ºPreenche do 6º ao 10º prêmio.
Bicho RSrs14, 181º ao 7ºRio Grande do Sul.
Salvação Minasmg131º ao 7ºMinas Gerais.
União Juiz de Foramg111º ao 7ºMinas Gerais.
Minas Dia / Minas Noitemg15, 191º ao 7ºMinas Gerais.
PT Bahiaba10, 12, 15, 19, 211º ao 10ºPreenche do 6º ao 10º prêmio.
Maluca Bahiamba10, 12, 15, 19, 211º ao 10ºPreenche do 6º ao 10º prêmio.
LBR Brasílialbr08, 10, 12, 15, 17, 19, 20, 22, 231º ao 7ºPossui salteado quando disponível.
Loteria Popularlp09, 11, 12, 14, 15, 17, 181º ao 7ºRecife / PE.
Caminho da Sortecs09, 11, 12, 14, 15, 17, 18, 20, 211º ao 7ºPernambuco.
Loteria Sertãols09, 11, 13, 14, 16, 17, 181º ao 7ºPernambuco.
Monte Carlosmc10, 11, 12, 14, 15, 17, 18, 201º ao 7ºPernambuco.
Aliança Onlineao09, 11, 12, 14, 15, 17, 18, 201º ao 7ºPernambuco.
Extração do Valeev11, 13, 14, 16, 17, 18, 201º ao 7ºPernambuco.
Avalav09, 11, 12, 14, 15, 17, 181º ao 7ºPernambuco.
Abaeseab13, 14, 16, 191º ao 7ºSergipe.
09

Códigos de erro

HTTPSituaçãoMensagem comum
400JSON inválidoJSON inválido no corpo da requisição.
401Token ausente ou inválidoToken nao fornecido / Token invalido.
401Formato do token incorretoFormato de token invalido, use Bearer.
401Módulo pausado ou limite atingidoMódulo pausado / limite de requisições mensais atingido.
403Parâmetros inválidosData inválida, loteria inválida ou extração inválida.
403Loteria sem permissãoA loteria informada não está liberada para este usuário.
404Sem resultadoNenhum resultado encontrado para os dados informados.
405Método inválidoUse GET ou POST.
10

Exemplos de uso

Escolha a linguagem desejada para testar a API. Substitua o token de exemplo pelo token exibido no painel do usuário.

curl -X POST 'https://api.lotoserv.com/resultados/consulta/v1/' \
  -H 'Authorization: Bearer INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL' \
  -H 'Content-Type: application/json' \
  -d '{
    "data": "2026-06-05",
    "loteria": "rj",
    "extracao": "21"
  }'
curl -X GET 'https://api.lotoserv.com/resultados/consulta/v1/?data=2026-06-05&loteria=rj&extracao=21' \
  -H 'Authorization: Bearer INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL'
<?php
$endpoint = 'https://api.lotoserv.com/resultados/consulta/v1/';
$token = 'INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL';

$dados = [
    'data' => '2026-06-05',
    'loteria' => 'rj',
    'extracao' => '21'
];

$ch = curl_init($endpoint);

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer '.$token,
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode($dados, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),
    CURLOPT_TIMEOUT => 20
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$error = curl_error($ch);

curl_close($ch);

if ($error) {
    die('Erro cURL: '.$error);
}

$resultado = json_decode($response, true);

if ($httpCode !== 200) {
    echo 'Erro na consulta: ' . $response;
    exit;
}

print_r($resultado);
const axios = require('axios');

const endpoint = 'https://api.lotoserv.com/resultados/consulta/v1/';
const token = 'INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL';

async function consultarResultado() {
  try {
    const response = await axios.post(
      endpoint,
      {
        data: '2026-06-05',
        loteria: 'rj',
        extracao: '21'
      },
      {
        headers: {
          Authorization: `Bearer ${token}`,
          'Content-Type': 'application/json'
        }
      }
    );

    console.log(response.data);
  } catch (error) {
    if (error.response) {
      console.log('Erro HTTP:', error.response.status);
      console.log(error.response.data);
    } else {
      console.log('Erro:', error.message);
    }
  }
}

consultarResultado();
import requests

endpoint = 'https://api.lotoserv.com/resultados/consulta/v1/'
token = 'INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL'

payload = {
    'data': '2026-06-05',
    'loteria': 'rj',
    'extracao': '21'
}

headers = {
    'Authorization': f'Bearer {token}',
    'Content-Type': 'application/json'
}

response = requests.post(endpoint, json=payload, headers=headers, timeout=20)

print('HTTP:', response.status_code)
print(response.json())
using System.Net.Http.Headers;
using System.Net.Http.Json;

var endpoint = "https://api.lotoserv.com/resultados/consulta/v1/";
var token = "INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL";

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);

var payload = new
{
    data = "2026-06-05",
    loteria = "rj",
    extracao = "21"
};

var response = await client.PostAsJsonAsync(endpoint, payload);
var content = await response.Content.ReadAsStringAsync();

Console.WriteLine($"HTTP: {(int)response.StatusCode}");
Console.WriteLine(content);
package main

import (
    "bytes"
    "fmt"
    "io"
    "net/http"
)

func main() {
    endpoint := "https://api.lotoserv.com/resultados/consulta/v1/"
    token := "INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL"

    payload := []byte(`{
        "data": "2026-06-05",
        "loteria": "rj",
        "extracao": "21"
    }`)

    req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer "+token)
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)

    fmt.Println("HTTP:", resp.StatusCode)
    fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ConsultaResultados {
    public static void main(String[] args) throws Exception {
        String endpoint = "https://api.lotoserv.com/resultados/consulta/v1/";
        String token = "INFORME_AQUI_O_TOKEN_DO_SEU_PAINEL";

        String json = """
        {
          "data": "2026-06-05",
          "loteria": "rj",
          "extracao": "21"
        }
        """;

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(endpoint))
                .header("Authorization", "Bearer " + token)
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(json))
                .build();

        HttpClient client = HttpClient.newHttpClient();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println("HTTP: " + response.statusCode());
        System.out.println(response.body());
    }
}