Read the AI referral funnel

Read the ecommerce stages recorded for AI-referred activity. Method: GET Path: /projects/{project_id}/ga4/ecommerce/funnel Use the HTTP base for your authorized environment and an Authorization: Bearer header. See authentication and HTTP setup.

Parameters

This table covers the standard read profile. It excludes internal application routes and advanced analysis controls.

Name	Location	Type	Required	Default	Meaning
`project_id`	path	string	Yes	—	Project ID from list_projects. Select the project in the intended workspace and environment.
`start_date`	query	string	No	`"30daysAgo"`	Start of the requested range, as YYYY-MM-DD or a relative value such as 30daysAgo. These reads select a stored snapshot; use resolved_window for the dates actually served.
`end_date`	query	string	No	`"today"`	End of the requested range, as YYYY-MM-DD or today. Check resolved_window rather than treating the requested dates as the served period.
`session_source`	query	string	No	`null`	Restrict rows to one AI referral source, such as a source returned by get_ai_traffic_sources. Omit to leave source unrestricted.
`device_category`	query	string	No	`null`	Select desktop, mobile, or tablet for the ecommerce funnel. Omit to leave device category unrestricted.

Request example

Set IQRUSH_API_BASE and IQRUSH_ACCESS_TOKEN through secure configuration. Replace project/run IDs and sample selections with values returned by your account. JSON objects and arrays are encoded as query strings.

curl --fail-with-body --silent --show-error --get \
  --header "Authorization: Bearer ${IQRUSH_ACCESS_TOKEN}" \
  --header "Accept: application/json" \
  --data-urlencode start_date=2026-09-01 \
  --data-urlencode end_date=2026-09-30 \
  "${IQRUSH_API_BASE%/}/projects/${IQRUSH_PROJECT_ID}/ga4/ecommerce/funnel"

Read the response

Returns funnel data for view_item, add_to_cart, begin_checkout, and purchase, with available step rates and resolved snapshot context. Results depend on the property’s ecommerce event setup. An event count is not automatically a count of unique people.

Fields to use

These selected fields explain the example and the result to preserve. Field presence depends on the response; this is not a complete response schema.

Field	Meaning and use
`linked`	Whether a property link exists for this project.
`funnel_steps`	Stored ecommerce funnel steps when available. Empty here means no linked data, not zero purchases.

Selected response fields from IQRush Dev. Lists are shortened and project/run IDs are placeholders; this is not the full response.

{
  "project_id": "PROJECT_ID",
  "linked": false,
  "funnel_steps": []
}

This observed example has no linked Google property. It demonstrates the unavailable-integration response; it is not a zero-traffic report. MCP equivalent: get_ecommerce_funnel. Use the parameters and defaults on this page for HTTP.

If the result is unavailable

Check HTTP status and the response’s error field before using data. A successful empty response does not establish a zero value. Preserve not_available, not_available_reason, unavailable_reason, and linked where returned. Errors and recovery shows observed examples.

Get started

Connect securely

Read measurements

Build dependable integrations

Build reports

Report recipes

Reference

Session and discovery

Visibility measurements

Sources and evidence

Changes and trends

Google data

Pages and report planning

HTTP operations

Read the AI referral funnel — HTTP

Parameters

Request example

Read the response

Fields to use

If the result is unavailable

​Parameters

​Request example

​Read the response

​Fields to use

​If the result is unavailable

Parameters

Request example

Read the response

Fields to use

If the result is unavailable