---
title: "Funnel"
method: GET
path: "/filterwizard/{instancekey}"
tags: ["Guided selling"]
---

# Funnel

`GET /filterwizard/{instancekey}`

Service that makes it possible to filter the products questioningly and only the products that meet the filter values will be shown. The result contains the questions with their answers and products which are the result of the selected answers. Additionally a navigation url is provided to go to a navigation page with selected filters for the funnel with selected answers.

## Path parameters

- `instancekey` string, required

## Query parameters

- `code` string, required
- `catid` number
- `answers` object
- `skip_qs` number[]
- `take` number
- `skip` number
- `tn_use_filters` boolean

## Headers

- `TWN-Source` string

## Response `200`

Response with questions, their answers and resulting products of selected answers. Additionally a navigation url is provided to go to a navigation page with selected filters for the funnel with selected answers.

- FilterWizard
  - `code` string — Code of the filter wizard
  - `name` string — Name of the filter wizard
  - `count` integer — Count of items
  - `navigationurl` string — Navigation URL
  - `filtertemplateid` integer — ID of the filter template
  - `questions` FilterWizardQuestion[] — List of questions
    - `questionid` integer — ID of the question
    - `question` string — Text of the question
    - `explanation` string — Explanation of the question
    - `ismultiselect` boolean — Indicates if multiple answers can be selected
    - `imageurl` string — URL of the image
    - `current` boolean — Indicates if this is the current question
    - `skippable` boolean — Indicates if this question can be skipped
    - `skiplabel` string — Label for the skip button
    - `attribute` FilterWizardAttribute
      - `attributeid` integer — ID of the attribute
      - `name` string — Name of the attribute
      - `urlkey` string — URL key of the attribute
    - `answers` FilterWizardAnswer[] — List of answers
      - `answerid` integer — ID of the answer
      - `answer` string — Text of the answer
      - `caption` string — Caption of the answer
      - `summary` string — Summary of the answer
      - `imageurl` string — URL of the image
      - `count` integer — Count of the answer
      - `isselected` boolean — Indicates if this answer is selected
      - `nextquestionid` integer, nullable — ID of the next question
      - `attributevalues` FilterWizardAttributeValue[] — List of attribute values
        - `value` string — Value of the attribute
  - `items` FilterWizardItem[] — List of items
    - `itemno` string — Item number
    - `title` string — Title of the item
    - `brand` string — Brand of the item
    - `price` number, double — Price of the item
    - `url` string — URL of the item
    - `image` string — Image URL of the item
    - `labels` string[] — Labels of the item
    - `attributes` FilterWizardAttribute[] — Attributes of the item
      - `attributeid` integer — ID of the attribute
      - `name` string — Name of the attribute
      - `urlkey` string — URL key of the attribute

## Other responses

- `401` — Invalid instancekey supplied

---

[API](https://skmtc.dev/tweakwise/apis/frontend-api.md) · [All operations](https://skmtc.dev/tweakwise/apis/frontend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tweakwise/frontend-api/revisions/9bd1e2b3633f/schema)
