Get a conversion funnel by ID via the Clics REST API

Fetch one funnel by ID.

GET/v1/funnels/{funnel_id}

Authorization

AuthorizationBearer token (API key) · headerrequired

Path parameters

funnel_idstringrequired

Funnel ID.

min length 1

Responses

200Funnel details.

idstringrequired

project_idstringrequired

env_idstringrequired

Allowed:productiondevelopment

namestringrequired

conversion_windowobjectrequired

Show properties

valueintegerrequired

Length of the conversion window.

min 1

unitstringrequired

Unit for the conversion window length.

Allowed:secondsminuteshoursdaysweeksmonths

stepsobject[]required

Show properties

Array of object

namestringrequired

Display name for this funnel step.

min length 1

filtersobject[]required

At least one filter that defines when this step is reached.

min items 1

Show properties

Array of object

filter_typestringrequired

Dimension to match: country, device, browser, os, page, event, hostname, referrer, or utm_*.

Allowed:countrydevicebrowserospageeventhostnamereferrerutm_sourceutm_mediumutm_campaignutm_termutm_content

operatorstringrequired

Match operator: is, is_not, contains, or not_contains.

Allowed:isis_notcontainsnot_contains

valuesstring[]required

Values to match against the chosen dimension.

created_atnumberrequired

400Invalid request.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

401Missing or invalid API key.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

403Forbidden.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

404Resource not found.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

500Unexpected error.

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

Request

curl -X GET "https://api.clics.dev/v1/funnels/funnel_1" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.clics.dev/v1/funnels/funnel_1", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://api.clics.dev/v1/funnels/funnel_1",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "id": "string",
  "project_id": "string",
  "env_id": "production",
  "name": "string",
  "conversion_window": {
    "value": 7,
    "unit": "days"
  },
  "steps": [
    {
      "name": "Cart",
      "filters": [
        {
          "filter_type": "page",
          "operator": "is",
          "values": [
            "/cart"
          ]
        }
      ]
    }
  ],
  "created_at": 0
}