> ## 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.

# Obter ação

> Retorna os detalhes de uma ação pelo seu ID

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

<ParamField path="id" type="string" required>
  ID da ação (UUID).
</ParamField>

## Resposta

<ResponseField name="data" type="object">
  <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`).</ResponseField>

    <ResponseField name="images" type="array">
      Imagens da ação: `{ id, image_url, display_order }`, ordenadas por `display_order`.
    </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>

## 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 |

<Note>
  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.
</Note>

<RequestExample>
  ```bash curl theme={null}
  curl -u "pb_SEU_TOKEN_PUBLICO:sk_SEU_TOKEN_SECRETO" \
    "https://api.sortify.com.br/v1/raffles/a3f1c9e2-5b7d-4e8a-9c01-2d3e4f5a6b7c"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "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"
    }
  }
  ```

  ```json 404 theme={null}
  {
    "success": false,
    "error": {
      "message": "Ação não encontrada",
      "code": "RAFFLE_NOT_FOUND"
    }
  }
  ```
</ResponseExample>