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

# List signals

`GET /api/v1/signals`

## Request

- Base URL: `https://api.signalraven.ai`
- URL: `https://api.signalraven.ai/api/v1/signals`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `offset` integer
- `type` string
- `minStrength` integer

## Response `200`

Signals (live or sample per client approval)

- V1SignalsResponse
  - `data` V1Signal[], required
    - `id` string, required
    - `type` string, nullable, required
    - `strength` number, nullable, required
    - `person` object, required
      - `company` string, nullable, required
      - `linkedinUrl` string, nullable, required: The person's public LinkedIn profile URL, https://www.linkedin.com/in/<vanity>, the form a CRM stores. Since 2026-10-16. Signals created earlier keep the URL they were created with, which for reactions and most job changes is the member-id form https://www.linkedin.com/in/ACoAA…; so does a newer signal whose profile has no public identifier. null when the signal has no person.
      - `location` string, nullable, required
    - `icp` string, nullable, required
    - `whyItMatters` string, nullable, required
    - `suggestedOpener` string, nullable, required
    - `talkingPoints` string[], nullable, required
    - `postPreview` string, nullable, required
    - `ownCompanyPost` 'none' | 'person' | 'company', nullable, required: Whether the post behind this signal was published by your own company page ('company'), by someone who currently works at your company ('person'), or by neither ('none'). null when the post could not be resolved or the signal has no post. Added 2026-10-02.
    - `topicInterest` boolean, required: True for a topic-interest signal: a monitored person's professional content about your space with no stated need, admitted because their monitor is set to relevance level 3 (since 2026-10-17). Such signals start at strength 5 instead of 8. false for every other signal.
    - `createdAt` string, nullable, required
  - `total` number, required
  - `limit` number, required
  - `offset` number, required
  - `_meta` V1Meta, required
    - `mode` 'live' | 'sample', required
    - `notice` string
    - `cta` object
      - `text` string, required
      - `url` string, required

## Other responses

- `401`: Missing/invalid token
- `403`: Insufficient scope or no workspace

---

[API](https://skmtc.dev/signalraven/apis/zygnal-api.md) · [All operations](https://skmtc.dev/signalraven/apis/zygnal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signalraven/apis/zygnal-api/revisions/36e1d9b9d604?raw)