---
title: "The step picker: every catalog step, grouped, with distinct people in the range."
method: GET
path: "/api/v1/admin/metrics/funnel/steps"
tags: ["Metrics Admin"]
---

# The step picker: every catalog step, grouped, with distinct people in the range.

`GET /api/v1/admin/metrics/funnel/steps`

## Request

- Base URL: `https://api.avatarfactory.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.avatarfactory.io/api/v1/admin/metrics/funnel/steps`
- Auth: one of:
  - API key in cookie `session`
  - HTTP bearer

## Query parameters

- `tz` string, nullable
- `include_internal` '0' | '1', nullable
- `from` string, date, nullable
- `to` string, date, nullable
- `filters` string, nullable

## Response `200`

OK

- FunnelStepsResponse
  - `filters` FilterEcho[], required
    - `dimension` string, required
    - `op` 'is' | 'not', required
    - `values` string[], required
  - `from` string, date, required
  - `groups` FunnelStepGroup[], required
    - `group` 'acquisition' | 'product' | 'billing', required
    - `steps` FunnelStepCount[], required
      - `count` integer, required
      - `label` string, required
      - `step_id` string, required
  - `meta` ResponseMeta, required: The zone the answer's dates are in (ruling 11). tz_applied is false where the data is UTC by nature (/freshness, /exports).
    - `tz` string, required
    - `tz_applied` boolean
  - `notes` string[], required
  - `to` string, date, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Unprocessable Entity
- `503`: Service Unavailable

---

[API](https://skmtc.dev/avatarfactory/apis/avatarfactory-api.md) · [All operations](https://skmtc.dev/avatarfactory/apis/avatarfactory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/avatarfactory/apis/avatarfactory-api/revisions/66fc7aa3f296?raw)