Search spans

POST {{baseUrl}}/api/v2/spans/events/search

List endpoint returns spans that match a span search query. Results are paginated.

Use this endpoint to build complex spans filtering and search. This endpoint is rate limited to 300 requests per hour.

Request Body

{"data"=>{"attributes"=>{"filter"=>{"from"=>"now-15m", "query"=>"*", "to"=>"now"}, "options"=>{"timeOffset"=>"<long>", "timezone"=>"UTC"}, "page"=>{"cursor"=>"<string>", "limit"=>10}, "sort"=>"-timestamp"}, "type"=>"search_request"}}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;data&quot;:[{&quot;attributes&quot;:{&quot;attributes&quot;:{&quot;culpac&quot;:{}},&quot;custom&quot;:{&quot;aliquip_8&quot;:{},&quot;commodo_9c1&quot;:{}},&quot;end_timestamp&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;env&quot;:&quot;\u003cstring\u003e&quot;,&quot;host&quot;:&quot;\u003cstring\u003e&quot;,&quot;ingestion_reason&quot;:&quot;\u003cstring\u003e&quot;,&quot;parent_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;resource_hash&quot;:&quot;\u003cstring\u003e&quot;,&quot;resource_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;retained_by&quot;:&quot;\u003cstring\u003e&quot;,&quot;service&quot;:&quot;\u003cstring\u003e&quot;,&quot;single_span&quot;:&quot;\u003cboolean\u003e&quot;,&quot;span_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;start_timestamp&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;tags&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;trace_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;\u003cstring\u003e&quot;},&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;spans&quot;},{&quot;attributes&quot;:{&quot;attributes&quot;:{&quot;Lorem_c&quot;:{}},&quot;custom&quot;:{&quot;culpa_c&quot;:{},&quot;consectetur_cf&quot;:{}},&quot;end_timestamp&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;env&quot;:&quot;\u003cstring\u003e&quot;,&quot;host&quot;:&quot;\u003cstring\u003e&quot;,&quot;ingestion_reason&quot;:&quot;\u003cstring\u003e&quot;,&quot;parent_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;resource_hash&quot;:&quot;\u003cstring\u003e&quot;,&quot;resource_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;retained_by&quot;:&quot;\u003cstring\u003e&quot;,&quot;service&quot;:&quot;\u003cstring\u003e&quot;,&quot;single_span&quot;:&quot;\u003cboolean\u003e&quot;,&quot;span_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;start_timestamp&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;tags&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;trace_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;\u003cstring\u003e&quot;},&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;spans&quot;}],&quot;links&quot;:{&quot;next&quot;:&quot;\u003cstring\u003e&quot;},&quot;meta&quot;:{&quot;elapsed&quot;:&quot;\u003clong\u003e&quot;,&quot;page&quot;:{&quot;after&quot;:&quot;\u003cstring\u003e&quot;},&quot;request_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;status&quot;:&quot;timeout&quot;,&quot;warnings&quot;:[{&quot;code&quot;:&quot;\u003cstring\u003e&quot;,&quot;detail&quot;:&quot;\u003cstring\u003e&quot;,&quot;title&quot;:&quot;\u003cstring\u003e&quot;},{&quot;code&quot;:&quot;\u003cstring\u003e&quot;,&quot;detail&quot;:&quot;\u003cstring\u003e&quot;,&quot;title&quot;:&quot;\u003cstring\u003e&quot;}]}}