Skip to main content
POST
Query Spans
Returns a list of span summaries matching the provided filters. All filters are optional. If min_start_datetime is not provided, the query defaults to the last 15 minutes. Start with run_id when investigating a specific agent run. Use limit and offset to paginate results and order to sort by start time. To retrieve the full record for a specific span, use the retrieve span endpoint.

Authorizations

Authorization
string
header
required

Your Seekr API key, sent in the Authorization header with no 'Bearer' prefix.

Headers

x-team-id
string | null

Body

application/json

Object to contain request data for retrieving spans in bulk.

min_start_datetime
string<date-time> | null
max_start_datetime
string<date-time> | null
agent_id
string | null
run_id
string | null
trace_id
string | null
thread_id
string | null
group
string | null
metadata
Metadata · object | null
limit
integer
default:100
order
enum<string>
default:desc

Options for order query param in list endpoints.

Available options:
asc,
desc
offset
integer
default:0

Response

Success

run_id
string
required
thread_id
string
required
agent_id
string
required
trace_id
string
required
span_id
string
required
span_name
string
required
level
integer
required
service_name
string
required
start_timestamp
string<date-time>
required
end_timestamp
string<date-time>
required
kind
enum<string>
required

Indicates the type of record for a logfire record.

Available options:
span,
pending_span,
log,
span_event
message
string
required
group
string | null
parent_span_id
string | null
otel_scope_name
string | null
is_exception
boolean | null
exception_type
string | null
gen_ai_operation_name
string | null
gen_ai_request_model
string | null
gen_ai_response_model
string | null
gen_ai_system
string | null
gen_ai_usage_input_tokens
string | null
gen_ai_usage_output_token
string | null
seekr_metadata
Seekr Metadata · object | null
Last modified on July 31, 2026