Get traces by project_name or project_id

GET

/v1/private/traces

GET

/api/v1/private/traces

curl http://localhost:5173/api/v1/private/traces

200Retrieved

{
  "page": 1,
  "size": 1,
  "total": 1,
  "content": [
    {
      "start_time": "2024-01-15T09:30:00Z",
      "id": "string",
      "project_id": "string",
      "name": "string",
      "end_time": "2024-01-15T09:30:00Z",
      "input": {},
      "output": {},
      "metadata": {},
      "tags": [
        "string"
      ],
      "error_info": {
        "exception_type": "string",
        "traceback": "string",
        "message": "string"
      },
      "usage": {},
      "created_at": "2024-01-15T09:30:00Z",
      "last_updated_at": "2024-01-15T09:30:00Z",
      "created_by": "string",
      "last_updated_by": "string",
      "feedback_scores": [
        {
          "name": "string",
          "value": 1.1,
          "source": "ui",
          "category_name": "string",
          "reason": "string",
          "source_queue_id": "string",
          "created_at": "2024-01-15T09:30:00Z",
          "last_updated_at": "2024-01-15T09:30:00Z",
          "created_by": "string",
          "last_updated_by": "string",
          "value_by_author": {}
        }
      ],
      "span_feedback_scores": [
        {
          "name": "string",
          "value": 1.1,
          "source": "ui",
          "category_name": "string",
          "reason": "string",
          "source_queue_id": "string",
          "created_at": "2024-01-15T09:30:00Z",
          "last_updated_at": "2024-01-15T09:30:00Z",
          "created_by": "string",
          "last_updated_by": "string",
          "value_by_author": {}
        }
      ],
      "comments": [
        {
          "text": "string",
          "id": "string",
          "source_queue_id": "string",
          "created_at": "2024-01-15T09:30:00Z",
          "last_updated_at": "2024-01-15T09:30:00Z",
          "created_by": "string",
          "last_updated_by": "string"
        }
      ],
      "guardrails_validations": [
        {
          "span_id": "string",
          "checks": [
            {
              "name": "TOPIC",
              "result": "passed"
            }
          ]
        }
      ],
      "total_estimated_cost": 1.1,
      "span_count": 1,
      "duration": 1.1,
      "ttft": 1.1,
      "thread_id": "string",
      "visibility_mode": "default",
      "llm_span_count": 1,
      "has_tool_spans": true,
      "providers": [
        "string"
      ],
      "experiment": {
        "id": "string",
        "name": "string",
        "dataset_id": "string",
        "dataset_item_id": "string"
      },
      "annotation_queues": [
        {
          "id": "string",
          "name": "string"
        }
      ],
      "source": "sdk",
      "environment": "string"
    }
  ],
  "sortableBy": [
    "string"
  ]
}

Get traces by project_name or project_id

Query parameters

pageintegerOptional>=1Defaults to 1

sizeintegerOptional>=1Defaults to 10

project_namestringOptional

project_idstringOptionalformat: "uuid"

filtersstringOptional

truncatebooleanOptionalDefaults to false

Truncate input, output and metadata to slim payloads

strip_attachmentsbooleanOptionalDefaults to false

If true, returns attachment references like [file.png]; if false, downloads and reinjects stripped attachments

sortingstringOptional

excludestringOptional

searchstringOptional

Full-text search across trace fields

from_timedatetimeOptional

Filter traces created from this time (ISO-8601 format).

to_timedatetimeOptional

Filter traces created up to this time (ISO-8601 format). If not provided, defaults to current time. Must be after ‘from_time’.

annotation_queue_idstringOptionalformat: "uuid"

Filter traces belonging to this annotation queue and scope feedback scores/comments to it

Response

Trace resource

pageintegerOptional

sizeintegerOptional

totallongOptional

contentlist of objectsOptional

sortableBylist of stringsOptional