Skip to content

Funnels ​

List funnels ​

Returns every funnel of the project except funnels being deleted.

Scope: funnels:read

Request ​

http
GET /funnels?projectId=<project-id>

Parameters ​

QueryRequiredPurpose
projectIdWith an API keyThe project to list.

Example ​

sh
curl "https://sdk-api.funnelsgrove.com/integration/v1/funnels?projectId=<project-id>" \
  -H "Authorization: Bearer <api-key>"

Response ​

json
{
  "items": [{
    "id": "<funnel-id>",
    "slug": "quiz",
    "name": "Quiz",
    "createdAt": "2026-10-01T10:00:00+00:00",
    "updatedAt": "2026-10-03T10:00:00+00:00",
    "productionUrls": ["https://quiz.example.com", "https://quiz.example.com/short"]
  }]
}
  • updatedAt changes when the funnel is renamed or published, or its production URLs change. Draft edits in the builder do not change it.
  • productionUrls lists the funnel's routes on verified custom domains. It is empty while the funnel has no verified domain.

Errors ​

Only the common errors.

Build. Launch. Grow.