---
title: "GET /api/v1/traces"
method: GET
path: "/api/v1/traces"
tags: ["Traces"]
---

# GET /api/v1/traces

`GET /api/v1/traces`

Get trace with feedback list

## Query parameters

- `page` integer — Page number to retrieve. Page size is fixed.
- `modelIds` string — Comma separated list of model IDs or aliases to filter traces.
- `projectId` string, uuid — Project identifier to filter traces.
- `sortBy` 'createdAt' | 'score' — Sort traces by creation time or score.
- `sortOrder` 'asc' | 'desc' — Sort order to use for the selected sortBy field.

## Response `200`

success response

- TraceListResponse
  - `results` Trace[], required
    - `id` string, uuid, required — Unique trace identifier.
    - `createdAt` string, date-time, required — ISO timestamp representing when the trace was recorded.
    - `modelId` string, required — Model identifier attached to the trace.
    - `projectId` string, uuid, nullable, required — Project identifier, null when the trace is not linked to a project.
    - `input` string, required — Prompt or message provided to the model.
    - `output` string, required — Model response captured for the trace.
    - `score` number, nullable, required — Score between 0 and 1. Null when the trace has not been scored yet.
    - `feedback` string, nullable, required — Feedback provided for the trace.
    - `addedToDataset` boolean, required — Flag indicating whether the trace is already in the dataset.
    - `processingStatus` 'none' | 'processing' | 'failed', required — Background processing status used when generating improved datapoints.
  - `total` integer, required — Total number of traces that match the current filters, across all pages.

## Other responses

- `400` — bad request
- `401` — unauthenticated
- `403` — unauthorized
- `404` — not found
- `409` — conflict
- `500` — internal server error

## Changes

- **2025-11-12** `d71329d1d771` — 5 breaking, 1 warning, 6 info
  - the `results/items/input` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `results/items/modelId` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `results/items/output` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `results/items/createdAt` response's property type/format changed from `string`/`date` to `string`/`date-time` for status `200`
  - …8 more
- **2025-11-12** `25d63a01824a` — 2 warning, 7 info
  - deleted the `query` request parameter `conversationId`
  - deleted the `query` request parameter `modelId`
  - added the new optional `query` request parameter `modelIds`
  - added the new optional `query` request parameter `sortBy`
  - …5 more
- **2025-09-09** `25b5483d62a9` — 1 warning
  - removed the optional property `results/items/conversationId` from the response with the `200` status
- **2025-09-04** `6fce808cc14e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/premai-io/apis/prem-studio-api/changes/api/v1/traces/get.md)

---

[API](https://skmtc.dev/premai-io/apis/prem-studio-api.md) · [All operations](https://skmtc.dev/premai-io/apis/prem-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/premai-io/prem-studio-api/revisions/2cb1f5df1b89/schema)