Carregando
Documentação técnica

API de Atrasados

Consulte os números, grupos, dezenas, centenas ou milhares mais atrasados por loteria, extração e posição de prêmio, com retorno em JSON e autenticação por Bearer Token.

LI
Versão da documentação 1.0 Maio/2026
Métodos: GET / POST
Autenticação: Bearer Token
Filtros: Loteria, tipo, posição e extração
Retorno: JSON
01

Visão geral

A API de Atrasados permite consultar os resultados mais atrasados de uma loteria com base no histórico de resultados salvo em nossos servidores. A consulta pode considerar todas as posições do 1º ao 5º prêmio ou apenas uma posição específica.

Atraso por dias Retorna quantos dias cada item está sem sair.
Modalidades Grupo, dezena, centena e milhar.
Filtros avançados Filtre por loteria, extração e posição.
02

Ferramentas disponíveis no painel

Status da API

Exibe se o módulo está ativo, pausado ou bloqueado.

Token Bearer

Permite visualizar e alterar o token usado nas consultas.

Limite de requisições

Mostra o limite contratado e a quantidade de consultas realizadas.

Pausar loterias

Permite inativar loterias específicas para bloquear consultas.

Pausar modalidades

Permite bloquear grupo, dezena, centena ou milhar.

Histórico de consultas

Registra payloads, IPs, data e quantidade de consultas.

03

Início rápido

  1. Copie seu Bearer Token no painel da API de Atrasados.
  2. Escolha a loteria usando a sigla cadastrada, por exemplo rj.
  3. Escolha o tipo de busca: grupo, dezena, centena ou milhar.
  4. Opcionalmente informe posição e extração. Se não informar, o padrão será posicao=1-5 e todas as extrações da loteria.
Consulta rápida via GET
curl -X GET 'https://api.lotoserv.com/atrasados/consulta/v1/?loteria=rj&tipo_busca=grupo&posicao=1-5&extracao=21' \
  -H 'Authorization: Bearer 30C5B73E26E8CE63BBF49237'
04

Autenticação

Todas as consultas devem enviar o token no header Authorization usando o formato Bearer.

Header obrigatório
Authorization: Bearer 30C5B73E26E8CE63BBF49237
Caso o token não seja enviado, esteja em formato incorreto ou seja inválido, a API retornará erro 401.
05

Endpoint

O endpoint aceita requisições GET ou POST. No POST, os dados podem ser enviados como application/json ou formulário comum.

GET / POST https://api.lotoserv.com/atrasados/consulta/v1/
Verificação simples de status
https://api.lotoserv.com/atrasados/consulta/v1/?tipo_conexao=verificar_status
06

Parâmetros da consulta

Parâmetro Obrigatório Valores aceitos Descrição
loteria Sim Sigla da loteria. Ex: rj, sp, fd Define em qual loteria os atrasados serão calculados.
tipo_busca Sim grupo, dezena, centena, milhar Define a modalidade de atraso que será retornada.
posicao Não 1, 2, 3, 4, 5, 1-5 Define qual posição de prêmio será considerada. Padrão: 1-5.
extracao Não 00 até 23 Filtra por uma extração específica. Se não informado, considera todas as extrações da loteria.
Quando extracao não é informado, a API calcula os atrasos considerando todas as extrações disponíveis para a loteria selecionada.
07

Tipos de busca

Tipo Aliases aceitos Retorno Limite padrão
Grupo g, grupo, grupos grupo, animal, emoji, quadra 25 registros
Dezena dz, d, dezena, dezenas dezena 100 registros
Centena c, centena, centenas centena 1.000 registros
Milhar m, milhar, milhares milhar 1.000 registros
08

Resposta JSON

O retorno é dividido em três blocos principais: usuario, consulta, informacoes e dados.atrasados.

Campo Descrição
usuarioDados do terminal, site/app e usuário.
consultaNúmero da consulta, data/hora e IP solicitante.
informacoesDados da loteria, extração, tipo de busca e posição considerada.
dados.atrasadosLista ordenada dos atrasados, do mais atrasado para o menos atrasado.
diasQuantidade de dias desde a última saída do item.
saidaData da última saída no formato dd/mm/YYYY.
nunca_saiuIndica se o item nunca foi encontrado no histórico consultado.
Exemplo de resposta
{
    "usuario": {
        "terminal": "123456",
        "site_app": "Meu Site",
        "usuário_id": "987654"
    },
    "consulta": {
        "numero": 1,
        "data": "11/06/2026 15:45:32",
        "ip": "000.000.000.000"
    },
    "informacoes": {
        "tipo_api": "Atrasados por Loteria",
        "loteria": "PT Rio de Janeiro",
        "sigla": "rj",
        "extracao": "21",
        "extracao_nome": "PTN Rio",
        "tipo_busca": "g",
        "tipo_nome": "Grupo",
        "posicao": "1-5",
        "posicoes_premio_consideradas": "1º ao 5º prêmio",
        "total_registros": 25,
        "limite_retorno": 25,
        "data_referencia": "2026-06-11"
    },
    "dados": {
        "atrasados": [
            {
                "grupo": "01",
                "animal": "Avestruz",
                "emoji": "🦩",
                "quadra": "01-02-03-04",
                "posicao": 1,
                "dias": 45,
                "saida": "12/04/2026",
                "saida_original": "2026-04-12",
                "nunca_saiu": false
            }
        ]
    }
}
09

Erros comuns

401 Token nao fornecido / Token invalido O Bearer Token está ausente, inválido ou o módulo está pausado.
403 Parâmetro inválido Loteria, extração, posição ou tipo de busca inválido.
400 JSON inválido O corpo enviado no POST JSON não pôde ser interpretado.
405 Método inválido A API aceita apenas GET ou POST.
10

Exemplos de uso

curl -X GET 'https://api.lotoserv.com/atrasados/consulta/v1/?loteria=rj&tipo_busca=grupo&posicao=1-5&extracao=21' \
  -H 'Authorization: Bearer 30C5B73E26E8CE63BBF49237'
curl -X POST 'https://api.lotoserv.com/atrasados/consulta/v1/' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer 30C5B73E26E8CE63BBF49237' \
  -d '{
    "loteria": "rj",
    "tipo_busca": "grupo",
    "posicao": "1-5",
    "extracao": "21"
  }'
<?php
$endpoint = 'https://api.lotoserv.com/atrasados/consulta/v1/';
$token = '30C5B73E26E8CE63BBF49237';

$params = [
	'loteria' => 'rj',
	'tipo_busca' => 'grupo',
	'posicao' => '1-5',
	'extracao' => '21'
];

$url = $endpoint . '?' . http_build_query($params);

$ch = curl_init($url);
curl_setopt_array($ch, [
	CURLOPT_RETURNTRANSFER => true,
	CURLOPT_HTTPGET => true,
	CURLOPT_HTTPHEADER => [
		'Authorization: Bearer ' . $token,
		'Accept: application/json'
	],
	CURLOPT_TIMEOUT => 30
]);

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

curl_close($ch);

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

$dados = json_decode($response, true);

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

print_r($dados['dados']['atrasados']);
const axios = require('axios');

const endpoint = 'https://api.lotoserv.com/atrasados/consulta/v1/';
const token = '30C5B73E26E8CE63BBF49237';

async function consultarAtrasados() {
	try {
		const response = await axios.get(endpoint, {
			headers: {
				Authorization: `Bearer ${token}`,
				Accept: 'application/json'
			},
			params: {
				loteria: 'rj',
				tipo_busca: 'grupo',
				posicao: '1-5',
				extracao: '21'
			}
		});

		console.log(response.data.dados.atrasados);
	} catch (error) {
		console.error(error.response?.data || error.message);
	}
}

consultarAtrasados();
import requests

endpoint = 'https://api.lotoserv.com/atrasados/consulta/v1/'
token = '30C5B73E26E8CE63BBF49237'

params = {
    'loteria': 'rj',
    'tipo_busca': 'grupo',
    'posicao': '1-5',
    'extracao': '21'
}

headers = {
    'Authorization': f'Bearer {token}',
    'Accept': 'application/json'
}

response = requests.get(endpoint, params=params, headers=headers, timeout=30)

print(response.status_code)
print(response.json())
11

Observações importantes

  • O campo loteria deve ser a sigla da loteria contratada no painel.
  • O usuário pode pausar loterias ou modalidades no painel. Consultas pausadas retornam erro.
  • O limite de requisições é controlado pelo plano contratado.
  • Para evitar respostas muito grandes, milhar e centena retornam até 1.000 registros.
  • O retorno é ordenado do mais atrasado para o menos atrasado.