MYmyclickfunnels
Funnel

Fetch Funnel Stats

Changed on

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.

The metric names in the response are defined in Metric vocabulary in the Stats Skill, which also walks a recurring funnel auditor agent built on this endpoint.

get/funnels/{funnel_id}/stats

Request

Path parameters

funnel_idstring required

Query parameters

timerange_startstring date-time

Start of the stats timerange (ISO 8601 only; any other value is a 422. Send an offset's + as %2B, since an unencoded + arrives as a space). Defaults to 30 days before timerange_end. If the window between start and end exceeds 90 days, start is automatically clamped to 90 days before end. If start is after end, the window resets to the default 30 days ending at timerange_end. See Timerange parameters (both endpoints) in the Stats Skill for the clamping rules and how to cover longer windows.

timerange_endstring date-time

End of the stats timerange (ISO 8601 only; any other value is a 422. Send an offset's + as %2B, since an unencoded + arrives as a space). Defaults to the current time. Values in the future are automatically clamped to now.

expand[]string[]

Expand additional data in the response. Use expand[]=steps to include per-step statistics. When expand[]=steps is set, the response contains a steps array with detailed metrics for each funnel step. When omitted, the response contains a page_public_ids array instead. See the expanded steps response in the Stats Skill for both response shapes.

Response

OK

currencystring

ISO 4217 currency code for all monetary values (e.g. USD, EUR)

page_public_idsstring[]

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.

Example response

{
  "funnel": {
    "id": 1,
    "public_id": "gESyMv",
    "name": "My Sales Funnel"
  },
  "currency": "USD",
  "timerange": {
    "from": "2026-03-03T00:00:00Z",
    "to": "2026-04-02T23:59:59Z"
  },
  "summary": {
    "earnings_per_click": "0.00",
    "upfront_sales": "0.00",
    "upfront_sales_count": 0,
    "recurring_sales": "0.00",
    "average_cart_value": "0.00",
    "pageviews": 85,
    "optins": 38,
    "optins_unique": 27
  },
  "page_public_ids": [
    "NnAdPE",
    "kJzvQi"
  ]
}

Changes

  • 511d88b30aeaRevision changes
    • info

      for the path request parameter funnel_id, the type was generalized from integer to string

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status