# A funnel across visits for visitors who agreed

> tidekeeper's API reference: https://tidekeeper.eu/docs/api/get-sites-site-funnels-id

`GET /api/v1/sites/{site}/funnels/{id}`

A funnel across visits for visitors who agreed, and the same steps inside one visit for everyone. Never added.

## Parameters

- `site` (in path, needed): A site's id or name
- `id` (in path, needed): The funnel
- `period` (in query): 30d when left out
- `by` (in query): source, country or device

## The answer

200, `FunnelReport`: A funnel across visits, for visitors who agreed (AN-01), and the same steps inside one visit for everyone (AN-05). The two answer different questions and are never added.

- `by` (string, needed): `source`, `country` or `device`: by what the visitor first came with.
- `coverage` (Coverage, needed)
- `easy` (list of integer, needed): The easy way: visits that reached each step inside one visit. Null for a day whose visits were counted before the funnel existed.
- `easy_says` (string, needed)
- `finished` (integer, needed)
- `finished_share` (number or null)
- `funnel` (FunnelView, needed)
- `in_one_visit` (integer, needed)
- `median_seconds` (integer or null): Median seconds from the first step to the last.
- `period` (PeriodView, needed)
- `site` (string, needed)
- `split` (list of FunnelSplit, needed)
- `steps` (list of FunnelStep, needed)

## Asking

```sh
curl https://tidekeeper.eu/api/v1/sites/example.org/funnels/{id} \
    -H "Authorization: Bearer $TIDEKEEPER_TOKEN"
```