ListSpansGet
Retrieve and paginate spans matching a search query with specified filters, timestamps, and sorting. Supports date-time ISO8601 and date math for precise span retrieval.
Instructions
List endpoint returns spans that match a span search query. .
Use this endpoint to see your latest spans.
This endpoint is rate limited to 300
requests per hour.
Query Parameters:
filter[query]: Search query following spans syntax.
filter[from]: Minimum timestamp for requested spans. Supports date-time ISO8601, date math, and regular timestamps (milliseconds).
filter[to]: Maximum timestamp for requested spans. Supports date-time ISO8601, date math, and regular timestamps (milliseconds).
sort: Order of spans in results.
page[cursor]: List following results with a cursor provided in the previous query.
page[limit]: Maximum number of spans in the response.
Responses:
200 (Success): OK
Content-Type:
application/json
Response Properties:
data: Array of spans matching the request.
Example:
400: Bad Request.
Content-Type:
application/json
Response Properties:
errors: A list of errors.
Example:
403: Forbidden: Access denied.
Content-Type:
application/json
Response Properties:
errors: A list of errors.
Example:
422: Unprocessable Entity.
Content-Type:
application/json
Response Properties:
errors: A list of errors.
Example:
429: Too many requests: The rate limit set by the API has been exceeded.
Content-Type:
application/json
Response Properties:
errors: A list of errors.
Example:
Input Schema
Name | Required | Description | Default |
---|---|---|---|
filter[from] | No | Minimum timestamp for requested spans. Supports date-time ISO8601, date math, and regular timestamps (milliseconds). | |
filter[query] | No | Search query following spans syntax. | |
filter[to] | No | Maximum timestamp for requested spans. Supports date-time ISO8601, date math, and regular timestamps (milliseconds). | |
page[cursor] | No | List following results with a cursor provided in the previous query. | |
page[limit] | No | Maximum number of spans in the response. | |
sort | No | Sort parameters when querying spans. |