Funnels

# Get funnel

Stage-to-stage conversion

GET /v1/funnels

Requires metrics:read

How many entities entered each stage of a funnel, and the drop-off between them. Pass `stages` in the order they happen; GET /v1/pipelines lists the stage vocabulary this workspace uses.

Counted over the WHOLE population, including people the tracker never saw: imported contacts, deals closed over the phone, customers who predate the script. That is why these rates are lower than a session-based funnel, and why they are the honest ones.

These are not a cohort. Somebody counted at a late stage may have entered the first one before the window, so a step rate above 100% is possible.

To credit a stage to the marketing that produced it, use GET /v1/metrics with `stages` and an attribution model instead.

curl -s -X GET "https://app.sourceloop.ai/api/v1/funnels?website=acme.com&period=last%2030%20days&stages=lead%2Cmql%2Ccustomer" \
  -H "Authorization: Bearer $SOURCELOOP_API_KEY"

const res = await fetch(
  "https://app.sourceloop.ai/api/v1/funnels?website=acme.com&period=last%2030%20days&stages=lead%2Cmql%2Ccustomer",
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${process.env.SOURCELOOP_API_KEY}`,
    },
  },
);

const data = await res.json();

import os, requests

res = requests.get(
    "https://app.sourceloop.ai/api/v1/funnels?website=acme.com&period=last%2030%20days&stages=lead%2Cmql%2Ccustomer",
    headers={"Authorization": f"Bearer {os.environ['SOURCELOOP_API_KEY']}"},
)
data = res.json()