---
title: "Get Funnel"
method: GET
path: "/events/funnel"
tags: ["events"]
---

# Get Funnel

`GET /events/funnel`

## Request

- Base URL: `https://api.sumvid.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sumvid.app/events/funnel`
- Auth: HTTP bearer

Operator-only aggregate funnel readout by name over a time window.
Admin-gated the same way as /queue: ADMIN_USER_IDS via require_admin —
no separate token/env mechanism needed.

Note the default is "30d" here, not None/all-time like the /stats/*
endpoints — this preserves the feature's original 30-day default lookback.

## Query parameters

- `window` string

## Response `200`

Successful Response

- FunnelResponse
  - `window` string, required
  - `counts` object, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sumvid/apis/summarize-vid.md) · [All operations](https://skmtc.dev/sumvid/apis/summarize-vid/llms.txt) · [OpenAPI document](https://skmtc.dev/sumvid/apis/summarize-vid/revisions/c03d66e07deb?raw)