Get a list of spans

GET {{baseUrl}}/api/v2/spans/events

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

Use this endpoint to see your latest spans. This endpoint is rate limited to 300 requests per hour.

Request Params

Key	Datatype	Description
`filter[query]`	string	Search query following spans syntax.
`filter[from]`	string	Minimum timestamp for requested spans. Supports date-time ISO8601, date math, and regular timestamps (milliseconds).
`filter[to]`	string	Maximum timestamp for requested spans. Supports date-time ISO8601, date math, and regular timestamps (milliseconds).
`sort`	string	Order of spans in results.
`page[cursor]`	string	List following results with a cursor provided in the previous query.
`page[limit]`	number	Maximum number of spans in the response.

HEADERS

Key	Datatype	Required	Description
`Accept`	string

RESPONSES

status: OK

{&quot;data&quot;:[{&quot;attributes&quot;:{&quot;attributes&quot;:{&quot;customAttribute&quot;:123,&quot;duration&quot;:2345},&quot;custom&quot;:{&quot;sedcc5&quot;:{}},&quot;end_timestamp&quot;:&quot;2023-01-02T09:42:36.420Z&quot;,&quot;env&quot;:&quot;prod&quot;,&quot;host&quot;:&quot;i-0123&quot;,&quot;ingestion_reason&quot;:&quot;rule&quot;,&quot;parent_id&quot;:&quot;0&quot;,&quot;resource_hash&quot;:&quot;a12345678b91c23d&quot;,&quot;resource_name&quot;:&quot;agent&quot;,&quot;retained_by&quot;:&quot;retention_filter&quot;,&quot;service&quot;:&quot;agent&quot;,&quot;single_span&quot;:true,&quot;span_id&quot;:&quot;1234567890987654321&quot;,&quot;start_timestamp&quot;:&quot;2023-01-02T09:42:36.320Z&quot;,&quot;tags&quot;:[&quot;team:A&quot;],&quot;trace_id&quot;:&quot;1234567890987654321&quot;,&quot;type&quot;:&quot;web&quot;},&quot;id&quot;:&quot;AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA&quot;,&quot;type&quot;:&quot;spans&quot;},{&quot;attributes&quot;:{&quot;attributes&quot;:{&quot;customAttribute&quot;:123,&quot;duration&quot;:2345},&quot;custom&quot;:{&quot;irure_dca&quot;:{}},&quot;end_timestamp&quot;:&quot;2023-01-02T09:42:36.420Z&quot;,&quot;env&quot;:&quot;prod&quot;,&quot;host&quot;:&quot;i-0123&quot;,&quot;ingestion_reason&quot;:&quot;rule&quot;,&quot;parent_id&quot;:&quot;0&quot;,&quot;resource_hash&quot;:&quot;a12345678b91c23d&quot;,&quot;resource_name&quot;:&quot;agent&quot;,&quot;retained_by&quot;:&quot;retention_filter&quot;,&quot;service&quot;:&quot;agent&quot;,&quot;single_span&quot;:true,&quot;span_id&quot;:&quot;1234567890987654321&quot;,&quot;start_timestamp&quot;:&quot;2023-01-02T09:42:36.320Z&quot;,&quot;tags&quot;:[&quot;team:A&quot;],&quot;trace_id&quot;:&quot;1234567890987654321&quot;,&quot;type&quot;:&quot;web&quot;},&quot;id&quot;:&quot;AAAAAWgN8Xwgr1vKDQAAAABBV2dOOFh3ZzZobm1mWXJFYTR0OA&quot;,&quot;type&quot;:&quot;spans&quot;}],&quot;links&quot;:{&quot;next&quot;:&quot;https://app.datadoghq.com/api/v2/spans/event?filter[query]=foo\u0026page[cursor]=eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==&quot;},&quot;meta&quot;:{&quot;elapsed&quot;:132,&quot;page&quot;:{&quot;after&quot;:&quot;eyJzdGFydEF0IjoiQVFBQUFYS2tMS3pPbm40NGV3QUFBQUJCV0V0clRFdDZVbG8zY3pCRmNsbHJiVmxDWlEifQ==&quot;},&quot;request_id&quot;:&quot;MWlFUjVaWGZTTTZPYzM0VXp1OXU2d3xLSVpEMjZKQ0VKUTI0dEYtM3RSOFVR&quot;,&quot;status&quot;:&quot;done&quot;,&quot;warnings&quot;:[{&quot;code&quot;:&quot;unknown_index&quot;,&quot;detail&quot;:&quot;indexes: foo, bar&quot;,&quot;title&quot;:&quot;One or several indexes are missing or invalid, results hold data from the other indexes&quot;},{&quot;code&quot;:&quot;unknown_index&quot;,&quot;detail&quot;:&quot;indexes: foo, bar&quot;,&quot;title&quot;:&quot;One or several indexes are missing or invalid, results hold data from the other indexes&quot;}]}}