curl -u "pb_SEU_TOKEN_PUBLICO:sk_SEU_TOKEN_SECRETO" \
"https://api.sortify.com.br/v1/raffles/a3f1c9e2-5b7d-4e8a-9c01-2d3e4f5a6b7c"
{
"success": true,
"message": "Ação encontrada com sucesso",
"data": {
"id": "a3f1c9e2-5b7d-4e8a-9c01-2d3e4f5a6b7c",
"title": "Sorteio iPhone 16 Pro",
"slug": "sorteio-iphone-16-pro",
"status": "published",
"description": "Concorra a um iPhone 16 Pro de 256GB.",
"total_tickets": 100000,
"ticket_price": 199,
"selection_mode": "random",
"draw_date": "2026-08-15T20:00:00.000Z",
"og_image_url": "https://cdn.sortify.com.br/campaigns/iphone.jpg",
"sold_tickets": 43210,
"available_tickets": 56790,
"images": [
{
"id": "0b1c2d3e-4f5a-6b7c-8d9e-0f1a2b3c4d5e",
"image_url": "https://cdn.sortify.com.br/campaigns/iphone-1.jpg",
"display_order": 0
}
],
"created_at": "2026-07-01T12:00:00.000Z",
"updated_at": "2026-07-05T18:30:00.000Z"
}
}
{
"success": false,
"error": {
"message": "Ação não encontrada",
"code": "RAFFLE_NOT_FOUND"
}
}
Ações
Obter ação
Retorna os detalhes de uma ação pelo seu ID
GET
/
v1
/
raffles
/
{id}
curl -u "pb_SEU_TOKEN_PUBLICO:sk_SEU_TOKEN_SECRETO" \
"https://api.sortify.com.br/v1/raffles/a3f1c9e2-5b7d-4e8a-9c01-2d3e4f5a6b7c"
{
"success": true,
"message": "Ação encontrada com sucesso",
"data": {
"id": "a3f1c9e2-5b7d-4e8a-9c01-2d3e4f5a6b7c",
"title": "Sorteio iPhone 16 Pro",
"slug": "sorteio-iphone-16-pro",
"status": "published",
"description": "Concorra a um iPhone 16 Pro de 256GB.",
"total_tickets": 100000,
"ticket_price": 199,
"selection_mode": "random",
"draw_date": "2026-08-15T20:00:00.000Z",
"og_image_url": "https://cdn.sortify.com.br/campaigns/iphone.jpg",
"sold_tickets": 43210,
"available_tickets": 56790,
"images": [
{
"id": "0b1c2d3e-4f5a-6b7c-8d9e-0f1a2b3c4d5e",
"image_url": "https://cdn.sortify.com.br/campaigns/iphone-1.jpg",
"display_order": 0
}
],
"created_at": "2026-07-01T12:00:00.000Z",
"updated_at": "2026-07-05T18:30:00.000Z"
}
}
{
"success": false,
"error": {
"message": "Ação não encontrada",
"code": "RAFFLE_NOT_FOUND"
}
}
Retorna os detalhes de uma ação da sua conta, incluindo as imagens cadastradas. Apenas ações com status
active ou published (não bloqueadas) são retornadas.
Path params
string
required
ID da ação (UUID).
Resposta
object
Show Campos da ação
Show Campos da ação
string
Identificador único (UUID).
string
Título da ação.
string
Slug usado na URL pública da ação.
string
active ou published.string | null
Descrição da ação.
number
Quantidade total de títulos.
number
Preço unitário do título em centavos (ex.:
199 = R$ 1,99).string
Modo de seleção de títulos:
manual, random ou sequential.string | null
Data prevista do sorteio (ISO 8601, UTC).
string | null
Imagem de compartilhamento da ação.
number
Títulos vendidos.
number
Títulos disponíveis (
total_tickets - sold_tickets).array
Imagens da ação:
{ id, image_url, display_order }, ordenadas por display_order.string
Data de criação (ISO 8601, UTC).
string
Última atualização (ISO 8601, UTC).
Erros
| HTTP | Código | Quando ocorre |
|---|---|---|
404 | RAFFLE_NOT_FOUND | A ação não existe, pertence a outra conta ou não está ativa/publicada |
A resposta
404 é idêntica em todos esses casos — a API não revela se uma ação existe fora do escopo das suas credenciais.curl -u "pb_SEU_TOKEN_PUBLICO:sk_SEU_TOKEN_SECRETO" \
"https://api.sortify.com.br/v1/raffles/a3f1c9e2-5b7d-4e8a-9c01-2d3e4f5a6b7c"
{
"success": true,
"message": "Ação encontrada com sucesso",
"data": {
"id": "a3f1c9e2-5b7d-4e8a-9c01-2d3e4f5a6b7c",
"title": "Sorteio iPhone 16 Pro",
"slug": "sorteio-iphone-16-pro",
"status": "published",
"description": "Concorra a um iPhone 16 Pro de 256GB.",
"total_tickets": 100000,
"ticket_price": 199,
"selection_mode": "random",
"draw_date": "2026-08-15T20:00:00.000Z",
"og_image_url": "https://cdn.sortify.com.br/campaigns/iphone.jpg",
"sold_tickets": 43210,
"available_tickets": 56790,
"images": [
{
"id": "0b1c2d3e-4f5a-6b7c-8d9e-0f1a2b3c4d5e",
"image_url": "https://cdn.sortify.com.br/campaigns/iphone-1.jpg",
"display_order": 0
}
],
"created_at": "2026-07-01T12:00:00.000Z",
"updated_at": "2026-07-05T18:30:00.000Z"
}
}
{
"success": false,
"error": {
"message": "Ação não encontrada",
"code": "RAFFLE_NOT_FOUND"
}
}