---
title: "Read bounded PostHog survey statistics"
method: GET
path: "/v1/projects/{project_id}/surveys/{survey_id}/stats"
tags: ["Surveys"]
---

# Read bounded PostHog survey statistics

`GET /v1/projects/{project_id}/surveys/{survey_id}/stats`

## Request

- Base URL: `https://api.agentry.sh`
- URL: `https://api.agentry.sh/v1/projects/{project_id}/surveys/{survey_id}/stats`
- Auth: HTTP bearer

Reads bounded aggregate statistics for one survey. Prefer this aggregate surface for recurring review; configured provider state still does not prove where application source rendered a survey.

## Path parameters

- `project_id` string, required
- `survey_id` string, required

## Query parameters

- `date_from` string, date-time
- `date_to` string, date-time
- `include_per_question_stats` boolean

## Response `200`

OK

- PosthogSurveyStatsResponse
  - `stats` PosthogSurveyStats, required
    - `survey_id` string, required
    - `start_date` string, nullable, required
    - `end_date` string, nullable, required
    - `event_counts` union, required: Provider aggregate value bounded to four nesting levels, 50 entries per collection, 100-character keys, and 500-character strings.
      - boolean
      - number
      - string
      - PosthogBoundedValue[]
      - object
    - `rates` union, required: Provider aggregate value bounded to four nesting levels, 50 entries per collection, 100-character keys, and 500-character strings.
      - boolean
      - number
      - string
      - PosthogBoundedValue[]
      - object
    - `per_question_stats` PosthogBoundedValue[], required
      - union: Provider aggregate value bounded to four nesting levels, 50 entries per collection, 100-character keys, and 500-character strings.
        - boolean
        - number
        - string
        - PosthogBoundedValue[]
        - object
  - `freshness` PosthogResourceFreshness, required
    - `source` 'customer_posthog_cloud_api', required
    - `consistency` 'provider_read', required
    - `queried_at` string, date-time, required
    - `status` 'complete_for_query_time', required
  - `data_boundary` PosthogResourceDataBoundary, required
    - `upstream_source` 'customer_posthog_cloud', required
    - `raw_event_stream_retained` false, required
    - `resource_snapshot_retained` false, required
    - `session_recording_content_returned` false, required
    - `provider_mutations_authorized` false, required
  - `next_action` string, required

## Other responses

- `default`: Error

---

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