List funnels

Enterprise

This endpoint is part of Countly Enterprise. To get access, contact sales or compare versions. Existing customers can reach the support portal with questions.

Endpoint

/o?method=get_funnels

Overview

Returns funnel definitions for the app, with optional group filtering and DataTable pagination/search parameters.

Authentication

Pass api_key or auth_token as a query parameter, or send countly-token as a header. See Authentication.

Permissions

Requires funnels Read permission.

Request Parameters

Parameter	Type	Required	Description
method	String	Yes	Must be get_funnels.
app_id	String	Yes	Target app ID.
group	String	No	Optional group filter. Use fav for current member favorites.
iDisplayStart	Number	No	Pagination offset (DataTable).
iDisplayLength	Number	No	Page size (DataTable).
iSortCol_0	Number	No	Sort column index (DataTable).
sSortDir_0	String	No	Sort direction (asc or desc).
sSearch	String	No	Search value for funnel name.
outputFormat	String	No	rows (default) or full.
api_key	String	Conditional	Required if auth_token is not provided.
auth_token	String	Conditional	Required if api_key is not provided.

Examples

/o?
  method=get_funnels&
  app_id=64f5c0d8f4f7ac0012ab3456

/o?
  method=get_funnels&
  app_id=64f5c0d8f4f7ac0012ab3456&
  group=fav&
  iDisplayStart=0&
  iDisplayLength=10&
  sSearch=purchase

Response

Success Response

Default (outputFormat=rows) response:

[
  {
    "_id": "67bd31c92e7f0b0012ab4567",
    "name": "Purchase Funnel",
    "description": "Product view to purchase",
    "type": "session-independent",
    "steps": ["Product View", "Add to Cart", "Purchase"],
    "created": 1739558400000
  }
]

outputFormat=full response:

{
  "sEcho": "0",
  "iTotalRecords": 1,
  "iTotalDisplayRecords": 1,
  "aaData": [
    {
      "_id": "67bd31c92e7f0b0012ab4567",
      "name": "Purchase Funnel",
      "description": "Product view to purchase",
      "type": "session-independent",
      "steps": ["Product View", "Add to Cart", "Purchase"],
      "groups": {
        "fav_64f5c0d8f4f7ac0012ab9999": 1
      },
      "created": 1739558400000
    }
  ],
  "favTotal": [
    {
      "value": 1
    }
  ]
}

Response Fields

Field	Type	Description
[]	Array	Default rows output (outputFormat=rows).
sEcho	String	DataTable echo value (outputFormat=full).
iTotalRecords	Number	Total rows before filtering (outputFormat=full).
iTotalDisplayRecords	Number	Total rows after filtering (outputFormat=full).
aaData	Array	Paged rows (outputFormat=full).
favTotal	Array	Favorite count facet for current member.

Error Responses

• 200

false

Behavior

• Uses DataTable pipeline for sorting, searching, and pagination.
• Supports group filtering; for favorites it uses groups.fav_<member_id>.
• Removes other users' favorite keys before returning rows (hideGroupValues).

Related Endpoints

• Funnels - Read
• Funnels - Create
• Funnels - Update
• Funnels - Delete
• Funnels - Analyze

Implementation details

Database Collections

Collection	Used for	Data touched by this endpoint
countly.funnels	Endpoint data source	Stores endpoint-related records this endpoint reads or modifies.