BETA · LEITURA

Rifas

Consulte suas rifas e os números vendidos. Todas as chamadas exigem o header Authorization: Bearer brf_live_….

GET/v1/rifas

Listar rifas

Lista paginada das suas rifas. Filtros: ?status=ACTIVE&page=1&per_page=20 (máx. 100).

{
  "data": [
    {
      "id": "974d5128-a752-423e-8ee3-9a4269b0291f",
      "hash": "7d50c06",
      "titulo": "Rifa do Carro 2026",
      "preco_centavos": 500,
      "quantidade": 1000,
      "vendidos": 312,
      "status": "ACTIVE",
      "data_sorteio": "2026-06-07T23:05:17.000Z",
      "ganhador": null
    }
  ],
  "page": 1, "per_page": 20, "total": 1, "total_pages": 1
}

GET/v1/rifas/:id

Detalhe da rifa

Retorna a rifa com contadores de venda e dados do ganhador (se já sorteada).

GET/v1/rifas/:id/tickets

Listar números vendidos

Tickets pagos da rifa, paginados (?page=1&per_page=100). CPF do comprador vem mascarado.

{
  "data": [
    {
      "numero": 42,
      "comprador": "Maria Silva",
      "cpf": "***.***.789-00",
      "status": "PAID",
      "valor_centavos": 500,
      "comprado_em": "2026-06-02T14:20:00.000Z"
    }
  ],
  "page": 1, "per_page": 100, "total": 312, "total_pages": 4
}

Em breve

EM BREVEPOST /v1/rifas· Criar rifa

EM BREVEPOST /v1/rifas/:id/activate· Ativar rifa

EM BREVEPOST /v1/rifas/:id/draw· Realizar sorteio