---
title: "List signals on an end-user's traces"
method: GET
path: "/v1/projects/{projectSlug}/users/{userId}/signals"
tags: ["Users"]
---

# List signals on an end-user's traces

`GET /v1/projects/{projectSlug}/users/{userId}/signals`

Returns the signals that occurred on the end-user's traces, most recent occurrence first. Occurrence counts are scoped to the user; signal identity and lifecycle states are the project's.

## Path parameters

- `projectSlug` string, required — Project slug (human-readable identifier)
- `userId` string, required — End-user identifier. URL-encode values containing special characters.

## Query parameters

- `limit` integer — Maximum number of signals to return.

## Response `200`

User signals

- UserSignalsResponse
  - `items` UserSignal[], required — Signals seen on the user's traces, most recent occurrence first.
    - `signalId` string, required — Stable identifier of the signal.
    - `name` string, required — Human-readable signal name.
    - `description` string, required — Signal description.
    - `states` string[], required — Lifecycle states currently applying to the signal.
    - `priority` string, nullable, required — Signal priority. `null` when unset.
    - `occurrences` integer, required — Occurrences on the user's traces.
    - `affectedTraces` integer, required — Distinct traces of the user that contributed an occurrence.
    - `firstSeenAt` string, required — ISO-8601 timestamp of the first occurrence on the user's traces.
    - `lastSeenAt` string, required — ISO-8601 timestamp of the most recent occurrence on the user's traces.

## 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/6a8789c59a5c/schema)