Get spans by project_name or project_id and optionally by trace_id and/or type

GET

/v1/private/spans

GET

/api/v1/private/spans

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

200Retrieved

{
  "page": 1,
  "size": 1,
  "total": 1,
  "content": [
    {
      "start_time": "2024-01-15T09:30:00Z",
      "id": "string",
      "project_name": "string",
      "project_id": "string",
      "trace_id": "string",
      "parent_span_id": "string",
      "name": "string",
      "type": "general",
      "end_time": "2024-01-15T09:30:00Z",
      "input": {},
      "output": {},
      "metadata": {},
      "model": "string",
      "provider": "string",
      "tags": [
        "string"
      ],
      "usage": {},
      "error_info": {
        "exception_type": "string",
        "traceback": "string",
        "message": "string"
      },
      "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": {}
        }
      ],
      "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"
        }
      ],
      "total_estimated_cost": 1.1,
      "total_estimated_cost_version": "string",
      "duration": 1.1,
      "ttft": 1.1,
      "source": "sdk",
      "environment": "string"
    }
  ],
  "sortableBy": [
    "string"
  ]
}

Get spans by project_name or project_id and optionally by trace_id and/or type

Query parameters

pageintegerOptional>=1Defaults to 1

sizeintegerOptional>=1Defaults to 10

project_namestringOptional

project_idstringOptionalformat: "uuid"

trace_idstringOptionalformat: "uuid"

typeenumOptional

Allowed values:

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 span fields

from_timedatetimeOptional

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

to_timedatetimeOptional

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

Response

Spans resource

pageintegerOptional

sizeintegerOptional

totallongOptional

contentlist of objectsOptional

sortableBylist of stringsOptional