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

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

Retorna todos os insells da ação (ativos e inativos), ordenados por `display_order`. Insells são promoções exibidas na **tela do PIX** — pedido já fechado, aguardando o pagamento.

Como o insell aparece com o pagamento ainda pendente, **não há métricas de conversão** (como nos presells).

## Path params

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

## Resposta

<ResponseField name="data.insells" type="array">
  <Expandable title="Campos do insell">
    <ResponseField name="id" type="string">Identificador único (UUID).</ResponseField>
    <ResponseField name="type" type="string">`simple`, `custom` ou `iframe` — **não existe `redirect`** em insells.</ResponseField>
    <ResponseField name="title" type="string">Título do insell.</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 insell 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/insells"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "message": "Insells listados com sucesso",
    "data": {
      "insells": [
        {
          "id": "4b3a2c1d-0e9f-8a7b-6c5d-e4f3a2b1c0d9",
          "type": "custom",
          "title": "Enquanto o PIX não cai",
          "description": null,
          "display_order": 0,
          "custom": {
            "type": "card",
            "content": "<h1>Oferta exclusiva!</h1><a href=\"{{INSELL_URL}}\" rel=\"noopener noreferrer nofollow\" target=\"_blank\">Aproveitar</a>",
            "url": { "placeholder": "{{INSELL_URL}}", "value": "https://insell.cliente.digital/" }
          },
          "is_active": true,
          "created_at": "2026-07-06T12:00:00.000Z",
          "updated_at": "2026-07-06T12:00:00.000Z"
        }
      ]
    }
  }
  ```
</ResponseExample>