---
title: "Get project signal"
method: GET
path: "/v1/projects/{projectSlug}/signals/{signalSlug}"
tags: ["Signals"]
---

# Get project signal

`GET /v1/projects/{projectSlug}/signals/{signalSlug}`

Returns the full-history detail view of one signal: lifecycle `states`, lifetime activity stats (`firstSeenAt`, `lastSeenAt`, `occurrences`, `affectedSessionsPercent`, `tags`), a 14-day occurrence `trend`, the active `evaluations` monitoring it, and the current `monitoringState`.

## Path parameters

- `projectSlug` string, required — Project slug (human-readable identifier)
- `signalSlug` string, required — Signal slug.

## Response `200`

Signal

- SignalDetail
  - `id` string, required — Stable signal identifier.
  - `organizationId` string, required — Organization that owns this signal.
  - `projectId` string, required — Project this signal belongs to.
  - `slug` string, required — URL-safe slug derived from `name`. Unique within the project.
  - `name` string, required — Human-readable name.
  - `description` string, required — Description of the signal.
  - `source` 'annotation' | 'flagger' | 'custom', required — Where the signal originated from.
  - `states` string[], required — Active lifecycle states. A signal may carry multiple states at once (e.g. `escalating` + `new`).
  - `resolvedAt` string, nullable, required — ISO-8601 timestamp at which the signal was resolved, or `null`.
  - `ignoredAt` string, nullable, required — ISO-8601 timestamp at which the signal was ignored, or `null`.
  - `regressedAt` string, nullable, required — ISO-8601 timestamp at which a new occurrence reopened the resolved signal, or `null`.
  - `mutedAt` string, nullable, required — ISO-8601 timestamp at which notifications were muted, or `null`. Muting only silences notifications; incidents still open.
  - `createdAt` string, required — ISO-8601 timestamp of creation.
  - `updatedAt` string, required — ISO-8601 timestamp of the last update.
  - `trend` SignalTrendBucket[], required — Daily occurrence counts over the past 14 days.
    - `bucket` string, required — UTC day bucket (`YYYY-MM-DD`).
    - `count` integer, required — Number of occurrences within the bucket.
  - `tags` string[], required — Tags seen on the signal's occurrences.
  - `firstSeenAt` string, nullable, required — ISO-8601 timestamp of the earliest occurrence over the signal's lifetime, or `null` if none yet.
  - `lastSeenAt` string, nullable, required — ISO-8601 timestamp of the latest occurrence over the signal's lifetime, or `null` if none yet.
  - `occurrences` integer, required — Lifetime occurrence count.
  - `affectedSessionsPercent` number, required — Lifetime fraction of project sessions affected by this signal, in `[0, 1]`.
  - `evaluations` Evaluation[], required — Active evaluations monitoring the signal. Archived and deleted evaluations are excluded.
    - `id` string, required — Stable evaluation identifier.
    - `name` string, required — Human-readable name.
    - `description` string, required — Generated description of the evaluation.
    - `alignedAt` string, nullable, required — ISO-8601 timestamp at which the evaluation was last realigned, or `null` if never aligned.
    - `archivedAt` string, nullable, required — ISO-8601 timestamp at which the evaluation was archived, or `null`.
    - `deletedAt` string, nullable, required — ISO-8601 timestamp at which the evaluation was deleted, or `null`.
    - `createdAt` string, required — ISO-8601 timestamp of creation.
    - `updatedAt` string, required — ISO-8601 timestamp of the last update.
    - `sampling` number, required — Sampling rate as a percentage in `[0, 100]`. `0` means the evaluation is paused.
    - `alignment` EvaluationAlignmentMetrics, nullable, required — Alignment metrics computed from the evaluation's confusion matrix, or `null` for an unaligned (e.g. raw / deterministic) evaluation.
      - `alignmentMetric` number, required — Headline score that judges how well the evaluation tracks human annotations.
      - `accuracy` number, required — Accuracy: `(TP + TN) / total`.
      - `precision` number, required — Precision: `TP / (TP + FP)`.
      - `recall` number, required — Recall / sensitivity: `TP / (TP + FN)`.
      - `specificity` number, required — Specificity: `TN / (TN + FP)`.
      - `trueness` number, required — Mean of precision and negative predictive value.
      - `f1` number, required — F1 score: harmonic mean of precision and recall.
      - `balancedAccuracy` number, required — Balanced accuracy: mean of recall and specificity.
      - `matthewsCorrelationCoefficient` number, required — Matthews correlation coefficient, in `[-1, 1]`.
  - `monitoringState` union, required — Whether the signal is currently being monitored: `automatic`, `idle`, `generating`, `realigning`, or `failed`.
    - object — The signal is automatically monitored by the system and does not need an evaluation.
      - `kind` 'automatic', required
    - object — The signal is not currently being monitored.
      - `kind` 'idle', required
    - object — An evaluation is being generated for this signal. The signal has no active evaluation yet.
      - `kind` 'generating', required
    - object — An active evaluation is being realigned.
      - `kind` 'realigning', required
      - `evaluationId` string, required — Id of the evaluation currently being realigned.
    - object — The most recent generation or realignment workflow for this signal ended in failure.
      - `kind` 'failed', required
      - `phase` 'generate' | 'realign', required — Which workflow failed: `generate` (creating the evaluation) or `realign` (updating it).
      - `evaluationId` string — Id of the evaluation whose realignment failed. Absent when the failure was during `generate`.
      - `reason` string, nullable, required — Resolved failure message, or `null` once Temporal has dropped the failed run.

## Other responses

- `400` — Validation error
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/latitude-dev/apis/latitude.md) · [All operations](https://skmtc.net/latitude-dev/apis/latitude/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/latitude-dev/latitude/revisions/2ce07f01d6c2/schema)