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"
}
}
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"
}
}
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
ID da ação (UUID).
Resposta
Show Campos da ação
Show Campos da ação
Identificador único (UUID).
Título da ação.
Slug usado na URL pública da ação.
active ou published.Descrição da ação.
Quantidade total de títulos.
Preço unitário do título em centavos (ex.:
199 = R$ 1,99).Modo de seleção de títulos:
manual, random ou sequential.Data prevista do sorteio (ISO 8601, UTC).
Imagem de compartilhamento da ação.
Títulos vendidos.
Títulos disponíveis (
total_tickets - sold_tickets).Imagens da ação:
{ id, image_url, display_order }, ordenadas por display_order.Data de criação (ISO 8601, UTC).
Ú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"
}
}
⌘I