---
title: "Get Signal Stats For User"
method: GET
path: "/api/v3/signal-settings/users/{user_id}/stats"
tags: ["Signal Settings"]
---

# Get Signal Stats For User

`GET /api/v3/signal-settings/users/{user_id}/stats`

Get all signal stats grouped by signal setting for user

## Path parameters

- `user_id` string, nullable, required

## Query parameters

- `created_after` string, date-time, nullable
- `created_before` string, date-time, nullable
- `offset` integer
- `limit` integer, nullable
- `saved` boolean, nullable
- `sort_by` 'created_at_desc' | 'created_at_asc'
- `institution_sort` 'most_signals' | 'most_recent' | 'oldest' | 'most_contacts' | 'account_type' — Sort order for institutions in paginated response. Note: This sorting is applied per-page after signal-level pagination. The same institution may appear on multiple pages if its signals span pages.
- `query` string, nullable

## Request body

- BodyGetSignalStatsForUserApiV3SignalSettingsUsersUserIdStatsGet
  - `statuses` SignalStatusEnum[], nullable
  - `signal_ids` string[], nullable
  - `signal_setting_ids` string[], nullable
  - `list_ids` string[], nullable
  - `data_sources` SignalSourceType[], nullable
  - `institution_types` InstitutionEnum[], nullable
  - `keywords` string[], nullable
  - `states` string[], nullable
  - `exclude_territory_ids` string[], nullable
  - `exclude_institution_ids` string[], nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

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