---
title: "List the surveys of the tracker chain"
method: GET
path: "/trackers/{id}/surveys"
tags: ["Results"]
---

# List the surveys of the tracker chain

`GET /trackers/{id}/surveys`

## Request

- Base URL: `https://api.epovest.com/v1`
- URL: `https://api.epovest.com/v1/trackers/{id}/surveys`
- Auth: HTTP bearer

The surveys of the tracker chain, newest first. `panel_version` is the tracker version that
ran each one (the series spans versions), and `billed_analysts` lists the AI analysts
reserved on that survey, what the credit hold covered.

## Response `200`

The surveys of the chain.

- object
  - `surveys` Survey[], required
    - `id` string, uuid, required
    - `period_start` string, date, required
    - `status` 'pending' | 'running' | 'completed' | 'failed', required
    - `panel_version` integer, required: The tracker version that ran it, the series spanning versions.
    - `on_demand` boolean, required: True when the survey was asked for on the tracker rather than run by the cadence.
    - `requested_at` string, date-time, nullable, required
    - `started_at` string, date-time, nullable, required
    - `completed_at` string, date-time, nullable, required
    - `billed_analysts` AnalystType[], required: The AI analysts reserved on that survey, snapshotted at creation, what the credit hold covered. Empty when none.

## Other responses

- `401`: `unauthenticated`: missing, unknown or revoked key.
- `403`: `insufficient_scope`: the credential may not do this, either because the key lacks the scope, or, on a one-click connection, because the person lacks the role the action needs (manager, or owner to start, pause and top up). On that path, read it as "this person may not do this" and tell them which role the action needs.
- `404`: `not_found`: unknown for this account.
- `429`: `rate_limited`: 120 requests per minute per credential, sliding window. Retry after `Retry-After` seconds.

---

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