Skip to main content
GET
Get spans
You are reading the docs of Galtea 5.12. Read this page in the latest version.

Authorizations

Authorization
string
header
required

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

ids
string[]

Filter by span IDs

inferenceResultIds
string[]

Filter by the IDs of the traces the spans belong to

sessionIds
string[]

Filter by session IDs (via the trace relationship)

types
enum<string>[]

Filter by span types. Only the values below are accepted, and any other value gives a 400. A span whose declared type was outside this list is stored under the type it was normalized to on write, so filter by that one. An LLM span is a GENERATION.

Available options:
SPAN,
GENERATION,
EVENT,
AGENT,
TOOL,
CHAIN,
RETRIEVER,
EVALUATOR,
EMBEDDING,
GUARDRAIL
names
string[]

Filter by span names

sort
string[]

Sort format createdAt,asc or createdAt,desc

offset
integer

Number of items to skip

limit
integer

Maximum number of items to return

fromStartTime
string<date-time>

Filter spans started at or after this timestamp (ISO 8601 format)

toStartTime
string<date-time>

Filter spans started at or before this timestamp (ISO 8601 format)

Response

Spans retrieved successfully

id
string
Example:

"trace_123"

inferenceResultId
string
Example:

"ir_123"

name
string
Example:

"fetch_user_data"

type
enum<string> | null
Available options:
SPAN,
GENERATION,
EVENT,
AGENT,
TOOL,
CHAIN,
RETRIEVER,
EVALUATOR,
EMBEDDING,
GUARDRAIL
Example:

"TOOL"

description
string | null

Human-readable description of the operation. Maximum 1MB.

Example:

"Fetches user data from the database by ID"

inputData
object | null

Input parameters passed to the operation

Example:
outputData

Result returned by the operation. Usually an object; a plain string for retrieval-context spans

Example:
error
string | null

Error message if failed

Example:

"Connection timeout"

latencyMs
number | null

Execution time in milliseconds

Example:

45.5

metadata
object | null

Additional custom metadata

Example:
parentTraceId
string | null

ID of parent span for hierarchical relationships

Example:

"trace_parent_123"

startTime
string<date-time> | null
endTime
string<date-time> | null
createdAt
string<date-time>
deletedAt
string<date-time> | null