---
title: "List signals"
method: GET
path: "/v1/tracker/signals/{listId}"
tags: ["Tracker"]
---

# List signals

`GET /v1/tracker/signals/{listId}`

Retrieve signals for a tracker list. Each signal represents a detected change that matched one of your tracking rules (e.g., a person changed jobs, a company raised funding). Use the `filter` query parameter to control which signals are returned: 'real' (default) for production signals only, 'dummy' for test signals generated via the fire-dummy endpoint, or 'all' for both. Pass `filter=dummy` to validate your integration by consuming test signals through the same polling flow you use in production.

<span>⚡ <strong>Rate limit:</strong> 120 requests per 1 minute</span>

<span>💰 <strong>Cost:</strong> FREE! No credits are charged for this API.&nbsp;<span title="Pricing shown is default pricing. Actual pricing may vary.">ⓘ</span></span>

## Path parameters

- `listId` string, required

## Query parameters

- `apiKey` string, required
- `since` string, nullable
- `cursor` string, nullable
- `pageSize` integer
- `filter` 'all' | 'real' | 'dummy'

## Response `200`

Default Response

- object
  - `output` object, required
    - `signals` TrackerSignalOutput[], required
      - `id` string, required — Signal ID.
      - `entityId` string, required — Tracked entity ID.
      - `entityType` 'company' | 'person', required — Entity type.
      - `linkedinIdentifier` string, required — LinkedIn org ID or user ID.
      - `linkedinSlug` string, nullable, required — The identifying part of a person or company's LinkedIn URL, such as `williamhgates` for `https://www.linkedin.com/in/williamhgates/` or `google` for `https://www.linkedin.com/company/google`.
      - `linkedinUrl` string, nullable, required — Full LinkedIn URL for the tracked entity, like `https://www.linkedin.com/company/google` for companies or `https://www.linkedin.com/in/williamhgates` for people.
      - `type` string, required — Signal type (e.g. headcount_crossed_threshold).
      - `summary` string, nullable, required — Human-readable description of what changed.
      - `changeData` union[], required — Array of objects describing what changed. Shape depends on signal type.
        - union
          - FundingStageChange
            - `kind` 'scalar', required
            - `previous` union, required — Previous funding stage
              - …
            - `current` union, required — Current funding stage
              - …
            - `currentRoundDetails` FundingRoundChange
              - …
          - LocationDeltaChange
            - `kind` 'location', required
            - `previous` CompanyLocationChange, required
              - …
            - `current` CompanyLocationChange, required
              - …
            - `countryChanged` boolean, required
            - `stateChanged` boolean, required
            - `cityChanged` boolean, required
            - `distanceMiles` number, nullable, required — Distance moved in miles, when both locations are geocoded
          - CompanyLocationChange
            - `city` string, nullable, required — City name
            - `state` string, nullable, required — State or province
            - `country` string, nullable, required — Country name
            - `countryCode` string, nullable, required — ISO country code
            - `coordinates` object, nullable, required — Geocoded coordinates, when known
              - …
            - `streetAddress` string, nullable — Street address of the office
            - `postalCode` string, nullable — Postal or ZIP code
            - `changeType` 'added' | 'null', nullable — Marks a location as newly added. New office alerts report only net-new locations, so this is always 'added'; the field is unset in other location signals.
          - FundingRoundChange
            - `type` string, required — Funding round type
            - `amountUsd` number, nullable, required — Amount raised in USD
            - `date` string, nullable, required — ISO date of the round
            - `investors` string[], required — Investor names
            - `crunchbaseUrl` string, nullable — URL to the funding round page on Crunchbase, when available
          - JobPostingChange
            - `jobId` string, required — LinkedIn job ID
            - `title` string, required — Job title
            - `jobUrl` string, nullable, required — URL to the job posting
            - `location` string, nullable, required — Job location
            - `locationType` 'remote' | 'on_site' | 'hybrid' | 'null', nullable, required — Location type
            - `seniorityLevel` string, nullable, required — Seniority level
            - `jobFunction` string, nullable, required — Department or function
            - `jobFunctions` string[] — All job functions this posting belongs to
            - `postedAt` string, nullable, required — ISO date when posted
            - `status` 'active' | 'closed', required — Job posting status
          - NewsArticleChange
            - `url` string, required — Article URL
            - `title` string, required — Article title
            - `publishedAt` string, nullable, required — ISO date published
            - `publisherName` string, nullable, required — Publisher name
            - `summary` string, nullable, required — Article summary
            - `sentiment` 'positive' | 'negative' | 'neutral' | 'null', nullable, required — Sentiment of the article. Null if not classified.
          - LinkedInPostChange
            - `postId` string, required — LinkedIn post ID
            - `postUrl` string, nullable, required — URL to the post
            - `caption` string, nullable, required — Post content
            - `postedAt` string, nullable, required — ISO date when posted
            - `numReactions` number, nullable, required — Number of reactions
            - `numComments` number, nullable, required — Number of comments
            - `numShares` number, nullable, required — Number of shares
            - `posterName` string, nullable — Display name of the person who posted
            - `posterSlug` string, nullable — LinkedIn slug of the poster (e.g. 'williamhgates')
            - `posterUrl` string, nullable — Full LinkedIn profile URL of the poster
            - `posterProfilePicture` string, nullable — Profile picture URL of the poster
          - PromotionChange
            - `linkedinCompanyId` string, nullable, required — LinkedIn company ID
            - `companyName` string, nullable, required — Company name
            - `companyLinkedinUrl` string, nullable, required — Company LinkedIn URL
            - `linkedinCompanySlug` string, nullable — LinkedIn company vanity slug
            - `companyDomains` string[], nullable — Known company domains
            - `title` string, nullable, required — Job title
            - `isCurrent` boolean, required — Whether this is a current position
            - `startDate` string, nullable, required — ISO start date
            - `endDate` string, nullable, required — ISO end date
            - `location` string, nullable, required — Position location
            - `employmentType` string, nullable, required — Employment type
            - `seniority` string, nullable, required — Seniority level
          - DemotionChange
            - `linkedinCompanyId` string, nullable, required — LinkedIn company ID
            - `companyName` string, nullable, required — Company name
            - `companyLinkedinUrl` string, nullable, required — Company LinkedIn URL
            - `linkedinCompanySlug` string, nullable — LinkedIn company vanity slug
            - `companyDomains` string[], nullable — Known company domains
            - `title` string, nullable, required — Job title
            - `isCurrent` boolean, required — Whether this is a current position
            - `startDate` string, nullable, required — ISO start date
            - `endDate` string, nullable, required — ISO end date
            - `location` string, nullable, required — Position location
            - `employmentType` string, nullable, required — Employment type
            - `seniority` string, nullable, required — Seniority level
          - RoleTenureChange
            - `kind` 'numeric', required
            - `previous` number, nullable, required — Previous tenure in months
            - `current` number, nullable, required — Current tenure in months
            - `direction` 'increased' | 'decreased', required — Direction of change
            - `absoluteChange` number, required — Absolute change in months
            - `percentChange` number, nullable, required — Percent change, null if previous was zero or null
          - CompanyTenureChange
            - `kind` 'numeric', required
            - `previous` number, nullable, required — Previous tenure in months
            - `current` number, nullable, required — Current tenure in months
            - `direction` 'increased' | 'decreased', required — Direction of change
            - `absoluteChange` number, required — Absolute change in months
            - `percentChange` number, nullable, required — Percent change, null if previous was zero or null
          - LayoffEventChange
            - `date` string, nullable, required — ISO date of the layoff event
            - `numLaidOff` number, nullable, required — Number of employees laid off
            - `percentLaidOff` number, nullable, required — Percentage of workforce laid off
            - `source` string, nullable, required — Source URL for the layoff report
          - TrackedEmployeeChange
            - `userId` string, required — LinkedIn user ID
            - `name` string, nullable, required — Employee name
            - `title` string, nullable, required — Job title
            - `startDate` string, nullable — ISO date when the employee started at this company
            - `primarySlug` string, nullable, required — LinkedIn profile slug
            - `linkedinUrl` string, nullable, required — Full LinkedIn profile URL
          - InvestorChange
            - `name` string, required — Investor name
            - `uuid` string, nullable, required — Unique identifier
            - `type` string[], required — Investor types
            - `linkedinSlug` string, nullable, required — Investor LinkedIn profile slug
            - `crunchbaseUrl` string, nullable, required — Reference URL
          - AcquisitionChange
            - `acquireeName` string, required — Name of the acquired company
            - `acquireeUuid` string, nullable, required — Unique identifier
            - `acquireeUrl` string, nullable, required — Reference URL
            - `priceUsd` number, nullable, required — Acquisition price in USD
            - `acquisitionDate` string, nullable, required — ISO date of acquisition
          - CertificationChange
            - `title` string, required — Certification title
            - `company` string, nullable, required — Issuing organization
            - `credentialId` string, nullable, required — Credential ID
            - `issueDate` string, nullable, required — ISO issue date
          - DepartmentSizeChange
            - `department` string, required — Department name
            - `count` number, required — Current employee count
          - PersonReactionChange
            - `reactionId` string, required — Unique reaction identifier (dedup key)
            - `type` string, nullable, required — Reaction type (LIKE, LOVE, INSIGHTFUL, CELEBRATE, SUPPORT, FUNNY)
            - `postContent` string, nullable, required — Content of the reacted post
            - `postUrl` string, nullable, required — URL to the LinkedIn post
            - `postAuthorName` string, nullable, required — Name of the post author
            - `reactedAgo` string, nullable, required — Relative time since the reaction
            - `reactedAt` string, nullable — Exact ISO timestamp when the reaction occurred
          - PersonCommentChange
            - `commentId` string, required — Unique comment identifier (dedup key)
            - `content` string, nullable, required — Content of the comment
            - `postContent` string, nullable, required — Content of the original post
            - `postUrl` string, nullable, required — URL to the LinkedIn post
            - `postAuthorName` string, nullable, required — Name of the post author
            - `commentedAgo` string, nullable, required — Relative time since the comment
            - `commentedAt` string, nullable — Exact ISO timestamp when the comment was made
          - ScalarDeltaChange
            - `kind` 'scalar', required
            - `previous` union, required — Previous value
              - …
            - `current` union, required — Current value
              - …
          - PersonExperienceChange
            - `linkedinCompanyId` string, nullable, required — LinkedIn company ID
            - `companyName` string, nullable, required — Company name
            - `companyLinkedinUrl` string, nullable, required — Company LinkedIn URL
            - `linkedinCompanySlug` string, nullable — LinkedIn company vanity slug
            - `companyDomains` string[], nullable — Known company domains
            - `title` string, nullable, required — Job title
            - `isCurrent` boolean, required — Whether this is a current position
            - `startDate` string, nullable, required — ISO start date
            - `endDate` string, nullable, required — ISO end date
            - `location` string, nullable, required — Position location
            - `employmentType` string, nullable, required — Employment type
            - `seniority` string, nullable, required — Seniority level
          - TenureChange
            - `kind` 'numeric', required
            - `previous` number, nullable, required — Previous tenure in months
            - `current` number, nullable, required — Current tenure in months
            - `direction` 'increased' | 'decreased', required — Direction of change
            - `absoluteChange` number, required — Absolute change in months
            - `percentChange` number, nullable, required — Percent change, null if previous was zero or null
          - NumericDeltaChange
            - `kind` 'numeric', required
            - `previous` number, nullable, required — Previous value
            - `current` number, nullable, required — Current value
            - `direction` 'increased' | 'decreased', required — Direction of change
            - `absoluteChange` number, required — Absolute numeric change
            - `percentChange` number, nullable, required — Percent change, null if previous was zero or null
          - NamedItemChange
            - `name` string, required — Name of the item (technology, tag, or skill)
      - `sources` string[], required — URLs providing proof or more information about this signal.
      - `methodology` string, required — Explanation of how this signal was detected and verified.
      - `observedAt` string, date-time, required — When the signal was detected.
      - `centiCreditsCharged` integer, required — Credits charged for the tracker check that produced this signal, in centi-credits (100 = 1 credit).
      - `isDummy` boolean, required — When true, this signal was generated synthetically via the `fire-dummy` endpoint.
    - `nextCursor` string, nullable, required — Cursor for fetching the next page. Null when there are no more results.
  - `chargeInfo` union, required
    - object — Credits were charged immediately for this operation
      - `method` 'charged-now', required
      - `creditsCharged` number, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits will be charged after the operation completes
      - `method` 'charging-later', required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits that were charged for an asynchronous operation
      - `method` 'charged-for-async-process', required
      - `creditsCharged` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — No credits were charged for this operation
      - `method` 'free', required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits were refunded for this operation
      - `method` 'credits-refunded', required
      - `creditsRefunded` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
  - `warnings` object[], nullable — Warnings about extraneous fields in request
    - `field` string, required — Full path to extraneous field (e.g., 'searchParams.ExtraField')
    - `message` string, required — Warning message
  - `advice` string[], nullable — Tips, recommendations, and suggestions for using this API effectively.

## Other responses

- `400` — Default Response
- `401` — Default Response
- `402` — Default Response
- `403` — Default Response
- `404` — Default Response
- `422` — Default Response
- `429` — Default Response
- `500` — Default Response
- `503` — Default Response

---

[API](https://skmtc.net/fiber/apis/fiber-ai-api.md) · [All operations](https://skmtc.net/fiber/apis/fiber-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fiber/fiber-ai-api/versions/0c537984b99f/schema)