---
title: "Get decline analytics for a user"
method: GET
path: "/api/analytics/decline"
tags: ["Analytics"]
---

# Get decline analytics for a user

`GET /api/analytics/decline`

Returns aggregated decline analytics for end users within a date range, including total end users, total declined, and per-check pass/fail/missing counts. Only the latest policy evaluation per end user is considered.

## Query parameters

- `start_date` string, date-time, required
- `end_date` string, date-time, required

## Response `200`

Decline analytics retrieved successfully

- object
  - `check_analytics` object[]
    - `check_name` string
    - `total_failed` integer
    - `total_missing_data` integer
    - `total_passed` integer
  - `total_declined` integer — Number of end users with at least one failed check
  - `total_end_users` integer — Total number of end users with policy evaluations

## Other responses

- `400` — User does not have analytics configured
- `401` — Authentication required
- `422` — Missing required parameters

---

[API](https://skmtc.dev/herondata/apis/heron-data-api.md) · [All operations](https://skmtc.dev/herondata/apis/heron-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/herondata/heron-data-api/revisions/f2e441edece2/schema)