> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sortify.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar ações

> Lista as ações (sorteios) ativas e em andamento da sua conta

Retorna as ações com status `active` ou `published` (não bloqueadas), ordenadas da mais recente para a mais antiga. A conta é determinada pelas credenciais — ações de outras contas nunca aparecem.

## Query params

<ParamField query="page" type="number" default="1">
  Página da listagem (mínimo `1`).
</ParamField>

<ParamField query="limit" type="number" default="20">
  Itens por página (mínimo `1`, máximo `50`).
</ParamField>

<ParamField query="status" type="string">
  Filtra por um status específico: `active` ou `published`.
</ParamField>

## Resposta

<ResponseField name="success" type="boolean">
  Sempre `true` em respostas de sucesso.
</ResponseField>

<ResponseField name="message" type="string">
  Mensagem em português.
</ResponseField>

<ResponseField name="data.raffles" type="array">
  Lista de ações. Cada item contém:

  <Expandable title="Campos da ação">
    <ResponseField name="id" type="string">Identificador único (UUID).</ResponseField>
    <ResponseField name="title" type="string">Título da ação.</ResponseField>
    <ResponseField name="slug" type="string">Slug usado na URL pública da ação.</ResponseField>
    <ResponseField name="status" type="string">`active` ou `published`.</ResponseField>
    <ResponseField name="description" type="string | null">Descrição da ação.</ResponseField>
    <ResponseField name="total_tickets" type="number">Quantidade total de títulos.</ResponseField>
    <ResponseField name="ticket_price" type="number">Preço unitário do título em **centavos** (ex.: `199` = R\$ 1,99).</ResponseField>
    <ResponseField name="selection_mode" type="string">Modo de seleção de títulos: `manual`, `random` ou `sequential`.</ResponseField>
    <ResponseField name="draw_date" type="string | null">Data prevista do sorteio (ISO 8601, UTC).</ResponseField>
    <ResponseField name="og_image_url" type="string | null">Imagem de compartilhamento da ação.</ResponseField>
    <ResponseField name="sold_tickets" type="number">Títulos vendidos.</ResponseField>
    <ResponseField name="available_tickets" type="number">Títulos disponíveis (`total_tickets - sold_tickets`; não desconta reservas pendentes).</ResponseField>
    <ResponseField name="created_at" type="string">Data de criação (ISO 8601, UTC).</ResponseField>
    <ResponseField name="updated_at" type="string">Última atualização (ISO 8601, UTC).</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="data.pagination" type="object">
  Metadados de paginação: `page`, `limit`, `total`, `total_pages`, `has_next`, `has_previous`.
</ResponseField>

<RequestExample>
  ```bash curl theme={null}
  curl -u "pb_SEU_TOKEN_PUBLICO:sk_SEU_TOKEN_SECRETO" \
    "https://api.sortify.com.br/v1/raffles?page=1&limit=20"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "message": "Ações listadas com sucesso",
    "data": {
      "raffles": [
        {
          "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,
          "created_at": "2026-07-01T12:00:00.000Z",
          "updated_at": "2026-07-05T18:30:00.000Z"
        }
      ],
      "pagination": {
        "page": 1,
        "limit": 20,
        "total": 1,
        "total_pages": 1,
        "has_next": false,
        "has_previous": false
      }
    }
  }
  ```
</ResponseExample>