Get spans
Get a list of spans with filtering and pagination. See Spans. These endpoints serve spans, the steps inside a trace. Their REST path /traces keeps the old name of this entity.
Authorizations
API key authorization. Pass your API key in the Authorization header as a Bearer token. Both new (gsk_*) and legacy (gsk-) API keys are accepted, e.g. Authorization: Bearer gsk_... or Authorization: Bearer gsk-....
Query Parameters
Filter by span IDs
Filter by the IDs of the traces the spans belong to
Filter by session IDs (via the trace relationship)
Filter by span types (SPAN, GENERATION, EVENT, AGENT, TOOL, CHAIN, RETRIEVER, EVALUATOR, EMBEDDING, GUARDRAIL)
SPAN, GENERATION, EVENT, AGENT, TOOL, CHAIN, RETRIEVER, EVALUATOR, EMBEDDING, GUARDRAIL Filter by span names
Sort format createdAt,asc or createdAt,desc
Number of items to skip
Maximum number of items to return
Filter spans started at or after this timestamp (ISO 8601 format)
Filter spans started at or before this timestamp (ISO 8601 format)
Response
Spans retrieved successfully
"trace_123"
"ir_123"
"fetch_user_data"
SPAN, GENERATION, EVENT, AGENT, TOOL, CHAIN, RETRIEVER, EVALUATOR, EMBEDDING, GUARDRAIL "TOOL"
Human-readable description of the operation. Maximum 1MB.
"Fetches user data from the database by ID"
Input parameters passed to the operation
Result returned by the operation. Usually an object; a plain string for retrieval-context spans
Error message if failed
"Connection timeout"
Execution time in milliseconds
45.5
Additional custom metadata
ID of parent span for hierarchical relationships
"trace_parent_123"