---
title: "List signals"
method: GET
path: "/api/signals"
tags: ["Signals"]
---

# List signals

`GET /api/signals`

Returns a paginated list of signals from monitors accessible by the authenticated user (owned and team-shared).
Supports filtering by signal_type, monitor_id, and date range.

## Query parameters

- `signal_type` string — Filter by signal type. Accepted values: `keyword_mention`, `new_hire`, `job_change`, `post_engagement`.
- `monitor_id` integer — Filter by a specific monitor ID (must be accessible by the authenticated user).
- `date_from` string — Filter signals detected on or after this date (format: YYYY-MM-DD).
- `date_to` string — Filter signals detected on or before this date (format: YYYY-MM-DD).
- `relevance_scores` string — Comma-separated AI relevance scores to include (0-5). Optionally combine with `monitor_id` to scope to a single monitor.
- `page` integer — The page number (default: 1).
- `per_page` integer — Results per page (max: 100, default: 50).

## Response `200`

Ok

- object
  - `data` object[]
    - `id` integer
    - `type` string
    - `category` string
    - `payload` object
      - `matched_keyword` string
      - `snippet` string
    - `detected_at` string
    - `expires_at` string
    - `contact` object
      - `id` integer
      - `name` string
      - `job_title` string
      - `linkedin_url` string
    - `company` object
      - `id` integer
      - `name` string
      - `domain` string
      - `industry` string
      - `employee_count_range` string
      - `country` string
    - `monitors` object[]
      - `id` integer
      - `name` string
      - `keywords` string[]
      - `enrichment_level` string
      - `relevance_score` integer
      - `relevance_reasoning` string
  - `meta` object
    - `current_page` integer
    - `per_page` integer
    - `total` integer
    - `last_page` integer
    - `from` integer
    - `to` integer

## Other responses

- `401` — Unauthenticated
- `404` — Feature disabled
- `422` — Validation failed

---

[API](https://skmtc.net/findymail/apis/findymail-api-documentation.md) · [All operations](https://skmtc.net/findymail/apis/findymail-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/findymail/findymail-api-documentation/revisions/ae7fddf16bf9/schema)