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

> Lista as promoções de presell de uma ação

Retorna todos os presells da ação (ativos e inativos), ordenados por `display_order`. Presells são promoções exibidas na **página de seleção do pedido** — enquanto o comprador ainda está montando o pedido, antes do pagamento.

Como o presell aparece antes do pedido existir, **não há métricas de conversão** (diferente dos upsells).

## Path params

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

## Resposta

<ResponseField name="data.presells" type="array">
  <Expandable title="Campos do presell">
    <ResponseField name="id" type="string">Identificador único (UUID).</ResponseField>
    <ResponseField name="type" type="string">`simple`, `custom` ou `iframe` — **não existe `redirect`** em presells.</ResponseField>
    <ResponseField name="title" type="string">Título do presell.</ResponseField>
    <ResponseField name="description" type="string | null">Descrição.</ResponseField>
    <ResponseField name="simple" type="object">Presente apenas no tipo `simple`: `{ button_text, button_url }`.</ResponseField>
    <ResponseField name="custom" type="object">Presente apenas no tipo `custom`: `{ type, content, url }`.</ResponseField>
    <ResponseField name="iframe" type="object">Presente apenas no tipo `iframe`: `{ type, url }`.</ResponseField>
    <ResponseField name="is_active" type="boolean">Se o presell está ativo.</ResponseField>
    <ResponseField name="display_order" type="number">Ordem de exibição (menor = primeiro).</ResponseField>
    <ResponseField name="created_at" type="string">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 ou pertence a outra conta |

<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/presells"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "message": "Presells listados com sucesso",
    "data": {
      "presells": [
        {
          "id": "9e8d7c6b-5a4f-3e2d-1c0b-a9f8e7d6c5b4",
          "type": "iframe",
          "title": "Oferta parceira",
          "description": null,
          "display_order": 0,
          "iframe": { "type": "card", "url": "https://presell.cliente.digital/" },
          "is_active": true,
          "created_at": "2026-07-06T12:00:00.000Z",
          "updated_at": "2026-07-06T12:00:00.000Z"
        }
      ]
    }
  }
  ```
</ResponseExample>