Get a list of spans
GET {{baseUrl}}/api/v2/spans/events?filter[query]=<string>&filter[from]=<string>&filter[to]=<string>&sort=timestamp&page[cursor]=<string>&page[limit]=10
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 | Required | 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
{"data":[{"attributes":{"attributes":{"culpac":{}},"custom":{"aliquip_8":{},"commodo_9c1":{}},"end_timestamp":"\u003cdateTime\u003e","env":"\u003cstring\u003e","host":"\u003cstring\u003e","ingestion_reason":"\u003cstring\u003e","parent_id":"\u003cstring\u003e","resource_hash":"\u003cstring\u003e","resource_name":"\u003cstring\u003e","retained_by":"\u003cstring\u003e","service":"\u003cstring\u003e","single_span":"\u003cboolean\u003e","span_id":"\u003cstring\u003e","start_timestamp":"\u003cdateTime\u003e","tags":["\u003cstring\u003e","\u003cstring\u003e"],"trace_id":"\u003cstring\u003e","type":"\u003cstring\u003e"},"id":"\u003cstring\u003e","type":"spans"},{"attributes":{"attributes":{"Lorem_c":{}},"custom":{"culpa_c":{},"consectetur_cf":{}},"end_timestamp":"\u003cdateTime\u003e","env":"\u003cstring\u003e","host":"\u003cstring\u003e","ingestion_reason":"\u003cstring\u003e","parent_id":"\u003cstring\u003e","resource_hash":"\u003cstring\u003e","resource_name":"\u003cstring\u003e","retained_by":"\u003cstring\u003e","service":"\u003cstring\u003e","single_span":"\u003cboolean\u003e","span_id":"\u003cstring\u003e","start_timestamp":"\u003cdateTime\u003e","tags":["\u003cstring\u003e","\u003cstring\u003e"],"trace_id":"\u003cstring\u003e","type":"\u003cstring\u003e"},"id":"\u003cstring\u003e","type":"spans"}],"links":{"next":"\u003cstring\u003e"},"meta":{"elapsed":"\u003clong\u003e","page":{"after":"\u003cstring\u003e"},"request_id":"\u003cstring\u003e","status":"timeout","warnings":[{"code":"\u003cstring\u003e","detail":"\u003cstring\u003e","title":"\u003cstring\u003e"},{"code":"\u003cstring\u003e","detail":"\u003cstring\u003e","title":"\u003cstring\u003e"}]}}