---
title: "Push Reachability Summary"
method: GET
path: "/api/v1/agents/push-reachability"
tags: ["agents"]
---

# Push Reachability Summary

`GET /api/v1/agents/push-reachability`

Push reachability across the recipients this workspace is actively pushing.

## Headers

- `authorization` string, nullable — Bearer <token>

## Response `200`

Successful Response

- EnvelopePushReachabilitySummary
  - `data` PushReachabilitySummary, required — How much of the push audience can still receive a push. Three numbers rather than one percentage, because a bare rate hides the two things that make it honest. `cohort` is the ACTIVELY-pushed audience (see app/jobs/push_reachability_sweep.py for why it cannot be the whole base), and `checked` is how many of them we have actually read - so the UI can say "based on N of M" instead of implying it measured everyone. `reachable_pct` is None when nothing has been read, so "not reporting" can never render as a confident 0%.
    - `cohort` integer
    - `checked` integer
    - `reachable` integer
    - `quiet` integer
    - `lost` integer
    - `reachable_pct` integer, nullable
    - `active_window_days` integer
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time
    - `total` integer, nullable
    - `truncated` boolean, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/minro/apis/minro-cs-platform.md) · [All operations](https://skmtc.dev/minro/apis/minro-cs-platform/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/minro/minro-cs-platform/revisions/eb854265cf29/schema)