---
title: "Get Network Summary"
method: GET
path: "/api/prospecting/network-summary"
tags: ["prospecting"]
---

# Get Network Summary

`GET /api/prospecting/network-summary`

Return the prospecting agent's contact pool composition.

The "remaining_potential_count" (the AI Zone's "Available Contacts") is
GOAL-SCOPED: exclusions only count for the goal a run will actually use.
- `goal_id`: scope exclusions to that goal at its current version (the pool
  reflects what that goal has already triaged).
- `fresh=true`: preview for a brand-NEW goal — it has excluded no one yet, so
  the full eligible pool is available (the "new goal resets the pool" case).
  Implemented via a sentinel goal_id that matches no existing deal.
- neither: legacy goal-blind composition (back-compat for other callers).

`bypass_cache=true` is orthogonal to the above: it skips the cached value
for whichever scope was resolved, recomputes, and repopulates the cache
with the fresh result (so other readers of that scope also benefit). Used
right after a client-side contact import — those writes go straight to
Supabase and never invalidate this process's cache, so without this the
dialog can show stale pre-import numbers for up to 5 minutes.

## Query parameters

- `goal_id` string, nullable
- `fresh` boolean
- `bypass_cache` boolean
- `user_id` string, nullable
- `org_id` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/every/apis/every-api.md) · [All operations](https://skmtc.net/every/apis/every-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/every/every-api/versions/9744001af85d/schema)