---
title: "Retrieve the population statistics of a funnel and its funnel stages"
method: GET
path: "/audiences/{audienceId}/funnels/{funnelId}/statistics"
tags: ["Funnels"]
---

# Retrieve the population statistics of a funnel and its funnel stages

`GET /audiences/{audienceId}/funnels/{funnelId}/statistics`

Retrieve the population history of a funnel. The history is returned per day and those days are calculated in the timezone of the audience.

## Path parameters

- `audienceId` integer, required
- `funnelId` integer, required

## Query parameters

- `from` string, date
- `to` string, date
- `limit` integer

## Response `200`

array of tuple of statistics

- FunnelStatistic
  - `population` integer, nullable — the latest population of the funnel
  - `stages` object[]
    - `id` integer — funnel stage id
    - `history` array[]
      - union[] — a tuple whose values are Unix epoch, the population, whether a workflow has run at that time or not
        - union
          - integer
          - boolean

## Other responses

- `400` — Given parameters are not valid
- `401` — Unauthorized; You don't provide valid credentials. Maybe you didn't specify valid TD's Master API Key as 'TD1 {Your TD Master API Key}'.
- `403` — Requested resource or action is not allowed because you don't have sufficient permissions
- `404` — The specified resource was not found
- `4XX` — There is a high possibility of error of the authentication system. Please check the contents and authority of the key. Please contact the TD support team if you do not resolve it.
- `5XX` — System error. Because there is a possibility of a temporary error due to network trouble and so on, we recommend several times retry on request side. Please contact the TD support team if you do not resolve it.

---

[API](https://skmtc.net/treasure/apis/cdp-api.md) · [All operations](https://skmtc.net/treasure/apis/cdp-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/treasure/cdp-api/revisions/24caa8eb809b/schema)