LAlatitude-dev
Traces

List project traces

Changed on

Returns a cursor-paginated page of traces in the project. Combine filters with query (free-text semantic search) to narrow the result set. Trace list rows exclude per-message LLM content — use getTrace for the full conversation view.

post/v1/projects/{projectSlug}/traces/list

Request

  • Base URL
    https://api.latitude.so
  • Auth
    HTTP bearer

Path parameters

projectSlugstring required

Project slug (human-readable identifier)

Project slug (human-readable identifier). The CLI can also read this from the LATITUDE_PROJECT_SLUG environment variable.

Request body

cursorstring

Opaque cursor returned in a previous response's nextCursor. Omit on the first page.

limitinteger

Page size. Defaults to 50; max 200.

sortBy'relevance' | 'startTime' | 'endTime' | 'durationNs' | 'tokensTotal' | 'costTotalMicrocents'

Field to sort by. Defaults to startTime. Pass relevance together with query to rank by semantic match (best match first, then most recent).

sortDirection'asc' | 'desc'

Sort direction. Defaults to desc (most recent first).

querystring

Free-text semantic search across the trace's input and output messages. Combined with filters via AND.

filtersTraceFilterSet

Filter set keyed by trace field. Each entry holds an array of conditions ANDed together for that field; field-level groups are ANDed across the set. Valid fields: status, name, traceId, sessionId, simulationId, userId, tags, models, providers, serviceNames, tools, definedTools, duration, ttft, cost, spanCount, errorCount, tokensInput, tokensOutput, cacheHitRate, startTime, endTime; score-derived keys (score.passed, score.errored, score.value, score.source, score.sourceId, score.annotatorId, score.signalId, score.simulationId); and arbitrary metadata via metadata.<key>. startTime/endTime take ISO-8601 values (a trace's first span start / last span end). gtePercentile is only supported on duration/ttft/cost — not on time fields. Unknown fields are rejected rather than ignored.

Response

Page of traces

nextCursorstring nullable required

Opaque cursor for fetching the next page. null when there are no more pages. Pass it back in cursor to continue.

hasMoreboolean required

true when there is at least one more page after this one.

Changes

  • 2e9f4f4234a7Revision changes
    • info

      added the new relevance enum value to the request property

  • 55192261472dRevision changes
    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status