---
title: "Get Signal"
method: GET
path: "/v1/signals/{signal_id}"
tags: ["signals"]
---

# Get Signal

`GET /v1/signals/{signal_id}`

## Request

- Base URL: `https://api.topo.io`
- URL: `https://api.topo.io/v1/signals/{signal_id}`
- Auth: HTTP bearer

Read one signal in full, including its detection and import filters.

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

## Path parameters

- `signal_id` string, uuid, required

## Response `200`

Successful Response

- SignalDetailPublicOutput
  - `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' | 'NEW_JOB' | 'CUSTOM_EVENT' | 'LINKEDIN_PARTNER_FOLLOWERS' | 'LINKEDIN_CUSTOMER_FOLLOWERS' | 'LINKEDIN_PARTNER_POST_ENGAGEMENT' | 'LINKEDIN_CUSTOMER_POST_ENGAGEMENT' | 'LINKEDIN_COMPANY_PAGE_POST_ENGAGEMENT' | 'LINKEDIN_OWN_PROFILE_POST_ENGAGEMENT' | 'LINKEDIN_OWN_EMPLOYEES_POST_ENGAGEMENT' | 'LINKEDIN_COMPETITOR_EMPLOYEES_POST_ENGAGEMENT' | 'LINKEDIN_PARTNER_EMPLOYEES_POST_ENGAGEMENT' | 'LINKEDIN_CUSTOMER_EMPLOYEES_POST_ENGAGEMENT' | 'LINKEDIN_OWN_BRAND_MENTION' | 'LINKEDIN_COMPETITOR_MENTION' | 'LINKEDIN_PARTNER_MENTION' | 'LINKEDIN_CUSTOMER_MENTION' | 'LINKEDIN_EVENT_MENTION' | 'COMPETITOR_TECH_ADOPTION' | 'INTEGRATION_TECH_ADOPTION' | 'LINKEDIN_EVENT_PAGE_FOLLOWERS' | 'CHAMPION_CHANGED_JOB' | 'CRM_LIST_ENTRY', 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.
  - `url` string, required: Deep link to the signal in Topo.
  - `list_url` string, nullable, required: Deep link to the destination list in Topo.
  - `search_filters` FilterTexts, required
  - `import_search_filters` FilterTexts, required
  - `sequence_template_id` string, uuid, nullable, required: Sequence template the imported leads are enrolled into.
  - `import_target` 'PEOPLE' | 'COMPANIES', required
  - `event_subject` 'PEOPLE' | 'COMPANIES', required

## Changes

- **2026-09-30** `451748979321`: 2 warning
  - added the new `linkedin_watched_engagement` enum value to the `import_search_filters/propertyNames/` response property for the response status `200`
  - added the new `linkedin_watched_engagement` enum value to the `search_filters/propertyNames/` response property for the response status `200`
- **2026-09-18** `5906bed561be`: 2 warning
  - added the new `tech_min_confidence` enum value to the `import_search_filters/propertyNames/` response property for the response status `200`
  - added the new `tech_min_confidence` enum value to the `search_filters/propertyNames/` response property for the response status `200`
- **2026-09-11** `242d6cb1e182`: 4 info
  - removed the `has_business_email` enum value from the `import_search_filters/propertyNames/` response property for the response status `200`
  - removed the `has_business_email` enum value from the `search_filters/propertyNames/` response property for the response status `200`
  - removed the `has_email` enum value from the `import_search_filters/propertyNames/` response property for the response status `200`
  - removed the `has_email` enum value from the `search_filters/propertyNames/` response property for the response status `200`
- **2026-09-09** `d037d17aecd4`: 2 info
  - added the required property `list_url` to the response with the `200` status
  - added the required property `url` to the response with the `200` status
- …earlier changes not shown

[Operation history](https://skmtc.dev/topo/apis/topo-public-api/changes/v1/signals/:signal_id/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.dev/topo/apis/topo-public-api/revisions/62914910b2a8?raw)