---
title: "Fetch Funnel Stats"
method: GET
path: "/funnels/{funnel_id}/stats"
tags: ["Funnel"]
---

# Fetch Funnel Stats

`GET /funnels/{funnel_id}/stats`

Retrieve detailed statistics for a funnel, including a summary of key metrics
and optional per-step breakdowns of views, opt-ins, sales, and earnings.

Defaults to a 30-day timerange ending now. Override with `timerange_start` and
`timerange_end`. Timerange values are automatically clamped: future end dates
are clamped to now, windows exceeding 90 days are clamped to 90 days, and if
start is after end the window resets to 30 days ending at `timerange_end`.

By default the response includes a `page_public_ids` array. Use
`expand[]=steps` to receive a `steps` array with per-step metrics instead.

## Path parameters

- `funnel_id` integer, required

## Query parameters

- `timerange_start` string, date-time
- `timerange_end` string, date-time
- `expand[]` string[]

## Response `200`

OK

- FunnelStatsAttributes — Detailed funnel statistics with aggregate summary and optional per-step breakdown.
  - `funnel` FunnelSummary — Lightweight funnel identifier used inside stats responses.
    - `id` integer — The funnel ID
    - `public_id` string — The public identifier of the funnel
    - `name` string — The name of the funnel
  - `currency` string — ISO 4217 currency code for all monetary values (e.g. USD, EUR)
  - `timerange` object — The actual time range used for the stats (after any clamping)
    - `from` string, date-time — Start of the timerange (ISO 8601)
    - `to` string, date-time — End of the timerange (ISO 8601)
  - `summary` object — Aggregate funnel summary metrics
    - `earnings_per_click` string — Earnings per click as a decimal string (see currency field)
    - `upfront_sales` string — Total upfront sales as a decimal string (see currency field)
    - `upfront_sales_count` integer — Number of upfront sales
    - `recurring_sales` string — Total recurring sales as a decimal string (see currency field)
    - `average_cart_value` string — Average cart value as a decimal string (see currency field)
    - `pageviews` integer — Total pageviews across all funnel steps
  - `page_public_ids` string[] — Public IDs of the pages associated with each funnel step, in step order. Present when `expand[]=steps` is NOT requested. Steps without an associated page are omitted.
  - `steps` FunnelStepStats[] — Per-step statistics. Present only when `expand[]=steps` is requested. When this field is present, `page_public_ids` is absent.
    - `page_id` integer, nullable — The id of the page this step renders (when the step is a show-page step). `null` for non-page steps.
    - `name` string — The step name
    - `current_path` string — The workflow-level routing segment for this step (from the `Workflows::Step#current_path` attribute). Note: this is the workflow step path, not the page's own `current_path` which is the page-level canonical path.
    - `views_all` integer — Total pageviews for this step
    - `views_unique` integer — Unique pageviews for this step
    - `optins` integer — Number of opt-ins on this step
    - `optin_rate` number, float — Opt-in rate (optins / unique views)
    - `sales_count` integer — Number of sales on this step
    - `sales_rate` number, float — Sales conversion rate (sales / unique views)
    - `sales_value` string — Total sales value as a decimal string (see top-level currency field)
    - `recurring_sales_count` integer — Number of recurring sales
    - `recurring_sales_value` string — Total recurring sales value as a decimal string (see top-level currency field)
    - `earnings_per_view` string — Earnings per view as a decimal string (see top-level currency field)
    - `earnings_per_unique_view` string — Earnings per unique view as a decimal string (see top-level currency field)

## Other responses

- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/myclickfunnels/apis/clickfunnels-api.md) · [All operations](https://skmtc.net/myclickfunnels/apis/clickfunnels-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myclickfunnels/clickfunnels-api/revisions/ae6313eaa176/schema)