FIfindymail
Signals

List signals

Changed on

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.

get/api/signals

Request

  • Base URL
    https://app.findymail.com
  • URL
    https://app.findymail.com/api/signals
  • Auth
    HTTP bearer

Query parameters

signal_typestring

Filter by signal type. Accepted values: keyword_mention, new_hire, job_change, post_engagement.

Example:keyword_mention
monitor_idinteger

Filter by a specific monitor ID (must be accessible by the authenticated user).

Example:1
date_fromstring

Filter signals detected on or after this date (format: YYYY-MM-DD).

Example:2026-01-01
date_tostring

Filter signals detected on or before this date (format: YYYY-MM-DD).

Example:2026-03-01
relevance_scoresstring

Comma-separated AI relevance scores to include (0-5). Optionally combine with monitor_id to scope to a single monitor.

Example:3,4,5
pageinteger

The page number (default: 1).

Example:1
per_pageinteger

Results per page (max: 100, default: 50).

Example:50

Response

Ok

Example response

{
  "data": [
    {
      "id": 1,
      "type": "keyword_mention",
      "category": "contact",
      "payload": {
        "matched_keyword": "hiring",
        "snippet": "We are hiring a new VP of Sales..."
      },
      "detected_at": "2026-03-01T12:00:00+00:00",
      "expires_at": "2026-06-01T12:00:00+00:00",
      "contact": {
        "id": 1,
        "name": "John Doe",
        "job_title": "CEO",
        "linkedin_url": "https://www.linkedin.com/in/johndoe"
      },
      "company": {
        "id": 1,
        "name": "Acme Corp",
        "domain": "acme.com",
        "industry": "Technology, Information and Internet",
        "employee_count_range": "51-200",
        "country": "US"
      },
      "monitors": [
        {
          "id": 1,
          "name": "Hiring monitor",
          "keywords": [
            "hiring"
          ],
          "enrichment_level": "email",
          "relevance_score": 4,
          "relevance_reasoning": "Post discusses active hiring for sales roles"
        }
      ]
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 50,
    "total": 1,
    "last_page": 1,
    "from": 1,
    "to": 1
  }
}

Changes