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

# List signal traces

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

## Request

- Base URL: `https://api.latitude.so`
- URL: `https://api.latitude.so/v1/projects/{projectSlug}/signals/{signalSlug}/traces`
- Auth: HTTP bearer

Returns the page of distinct traces that contributed at least one occurrence of the signal, ordered by most recent activity first.

## Path parameters

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

## Query parameters

- `cursor` string: Opaque cursor returned in a previous response's `nextCursor`. Omit on the first page.
- `limit` integer: Page size. Defaults to 50; max 200.

## Response `200`

Page of traces

- PaginatedTraces
  - `items` Trace[], required: Page of items, in the requested sort order.
    - `organizationId` string, required: Organization that owns this trace.
    - `projectId` string, required: Project this trace belongs to.
    - `traceId` string, required: 32-character trace identifier.
    - `spanCount` integer, required: Total number of spans in the trace.
    - `errorCount` integer, required: Number of spans flagged with an error status.
    - `startTime` string, required: ISO-8601 timestamp of the trace's earliest span.
    - `endTime` string, required: ISO-8601 timestamp of the trace's latest span.
    - `durationNs` number, required: Wall-clock duration of the trace in nanoseconds.
    - `timeToFirstTokenNs` number, required: Nanoseconds from the start of the first LLM span to its first emitted token. `0` if not measured.
    - `tokensInput` number, required: Total input tokens across LLM spans.
    - `tokensOutput` number, required: Total output tokens across LLM spans.
    - `tokensCacheRead` number, required: Total tokens served from the provider's prompt cache.
    - `tokensCacheCreate` number, required: Total tokens written to the provider's prompt cache.
    - `tokensReasoning` number, required: Total reasoning tokens reported by the model.
    - `tokensTotal` number, required: Sum of all token counters.
    - `costInputMicrocents` number, required: Cost of input tokens in microcents (100,000,000 per USD).
    - `costOutputMicrocents` number, required: Cost of output tokens in microcents (100,000,000 per USD).
    - `costTotalMicrocents` number, required: Total cost in microcents (100,000,000 per USD).
    - `sessionId` string, nullable, required: Conversation/session identifier set by the SDK. `null` when absent.
    - `userId` string, nullable, required: End-user identifier set by the SDK. `null` when absent.
    - `simulationId` string, nullable, required: CUID of the simulation that produced this trace. `null` when not a simulation.
    - `tags` string[], required: Free-form tags attached at ingest time.
    - `models` string[], required: Model identifiers seen across the trace's LLM spans.
    - `providers` string[], required: LLM-provider identifiers seen across the trace's spans.
    - `serviceNames` string[], required: OpenTelemetry `service.name` values seen in the trace.
    - `rootSpanId` string, nullable, required: Identifier of the trace's root span. `null` when no root span has been ingested.
    - `rootSpanName` string, nullable, required: `name` attribute of the root span. `null` when no root span has been ingested.
    - `positiveAnnotationCount` integer, required: Number of `passed = true` annotations attached to this trace.
    - `negativeAnnotationCount` integer, required: Number of `passed = false` annotations attached to this trace.
  - `nextCursor` string, nullable, required: Opaque cursor for fetching the next page. `null` when there are no more pages. Pass it back in `cursor` to continue.
  - `hasMore` boolean, required: `true` when there is at least one more page after this one.

## Other responses

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

## Changes

- **2026-06-18** `94100174a89b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/latitude-dev/apis/latitude/changes/v1/projects/:projectSlug/signals/:signalSlug/traces/get.md)

---

[API](https://skmtc.dev/latitude-dev/apis/latitude.md) - [All operations](https://skmtc.dev/latitude-dev/apis/latitude/llms.txt) - [OpenAPI document](https://skmtc.dev/latitude-dev/apis/latitude/revisions/0685be1cbf9f?raw)