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

# List Signals

`GET /v1/signals`

List the workspace's signals, most recently created first.

Requires the `signals:read` scope on the API key.

## Query parameters

- `page` integer
- `size` integer
- `include_archived` boolean — Also return retired signals, which never run again.

## Response `200`

Successful Response

- PublicPaginationEnvelopeSignalPublicOutput
  - `items` SignalPublicOutput[], required — Records on this page.
    - `id` string, uuid, required — Unique identifier of the signal.
    - `name` string, nullable, required — Name of the signal and of its destination list.
    - `signal_type` 'LINKEDIN_OWN_POST_ENGAGEMENT' | 'LINKEDIN_COMPETITOR_POST_ENGAGEMENT' | 'LINKEDIN_PERSON_POST_ENGAGEMENT' | 'LINKEDIN_KEYWORD_MENTION' | 'LINKEDIN_OWN_COMPANY_FOLLOWERS' | 'LINKEDIN_COMPETITOR_FOLLOWERS' | 'LINKEDIN_COMPANY_PAGE_FOLLOWERS' | 'HIRING_SIGNALS' | 'JOB_DESCRIPTION_KEYWORD' | 'FUNDING_EVENTS' | 'TECH_ADOPTION' | 'NEWS_EVENTS' | 'CUSTOM_EVENT', required
    - `status` 'ACTIVE' | 'PAUSED' | 'ARCHIVED', required
    - `cadence` 'DAILY' | 'WEEKLY', required
    - `max_per_run` integer, nullable, required — Daily ceiling on imported entries, when one was set.
    - `max_companies_per_run` integer, nullable, required — Daily ceiling on detected companies consumed, when one was set.
    - `max_contacts_per_company` integer, nullable, required — People imported per detected company, when one was set.
    - `max_per_day` integer, required — Ceiling on the entries the signal imports in one day, resolved from the caps above.
    - `enrich_email` boolean, required — Whether imported leads get their email enriched.
    - `enrich_phones` boolean, required — Whether imported leads get their phone enriched.
    - `imported_count` integer, required — Entries the signal has imported since it was created.
    - `contact_list_id` string, uuid, nullable, required — Destination list, when the signal imports people.
    - `account_list_id` string, uuid, nullable, required — Destination list, when the signal imports companies.
    - `created_at` string, date-time, required — When the signal was created.
    - `archived_at` string, date-time, nullable, required — When the signal was retired, if it was.
  - `total_count` integer, required — Total number of records matching the query.
  - `total_pages` integer, required — Total number of pages.
  - `has_more` boolean, required — Whether more pages remain after the current one.

## Changes

- **2026-09-01** `0646a72cff02` — 1 warning
  - added the new `LINKEDIN_PERSON_POST_ENGAGEMENT` enum value to the `items/items/signal_type` response property for the response status `200`
- **2026-08-28** `5327ff62a22f` — 3 warning
  - added the new `LINKEDIN_COMPANY_PAGE_FOLLOWERS` enum value to the `items/items/signal_type` response property for the response status `200`
  - added the new `LINKEDIN_COMPETITOR_FOLLOWERS` enum value to the `items/items/signal_type` response property for the response status `200`
  - added the new `LINKEDIN_OWN_COMPANY_FOLLOWERS` enum value to the `items/items/signal_type` response property for the response status `200`
- **2026-08-27** `75e08cd17b3d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/topo/apis/topo-public-api/changes/v1/signals/get.md)

---

[API](https://skmtc.dev/topo/apis/topo-public-api.md) · [All operations](https://skmtc.dev/topo/apis/topo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/topo/topo-public-api/revisions/0646a72cff02/schema)