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

# List Popups

> List saved on-site signup popups

List the workspace's saved popups with their status, view and conversion
counts, and engagement rates. Popups are the on-site overlay capture surface;
see [List Saved Forms](/api-reference/widgets/list-saved-forms) for inline
embedded forms.

Content blocks are omitted by default, because each popup adds roughly 1.8k
characters. Read one popup's full content with
[Get Popup](/api-reference/widgets/get-popup), or pass `includeContent=true`
when you genuinely need every popup's blocks at once.

## Request

<ParamField query="includeContent" type="string">
  Set to `true` to include every popup's full content blocks.
</ParamField>

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/popups" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "companyId": "comp_123",
    "popups": [
      {
        "id": "pop_123",
        "name": "Welcome offer",
        "status": "published",
        "viewCount": 1840,
        "startCount": 310,
        "conversionCount": 96,
        "stats": {
          "views": 1840,
          "starts": 310,
          "conversions": 96,
          "startRate": 0.1685,
          "conversionRate": 0.0522,
          "completionRate": 0.3097
        },
        "publishedAt": "2026-08-01T09:00:00.000Z",
        "updatedAt": "2026-08-04T11:20:00.000Z",
        "url": "https://sequenzy.com/dashboard/company/comp_123/popups/pop_123"
      }
    ],
    "note": "Content blocks are omitted. Pass includeContent=true, or read one popup with GET /popups/{popupId}.",
    "url": "https://sequenzy.com/dashboard/company/comp_123/popups"
  }
  ```

  ```json 401 theme={null}
  {
    "error": "Missing API key. Provide via x-api-key header or Authorization: Bearer <key>"
  }
  ```

  ```json 403 theme={null}
  { "error": "API key is missing required scope: widgets:read" }
  ```
</ResponseExample>