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/jsonResponse Properties:
data: Array of spans matching the request.
Example:
{
"data": [
"unknown_type"
],
"links": "unknown_type",
"meta": "unknown_type"
}400: Bad Request.
Content-Type:
application/jsonResponse Properties:
errors: A list of errors.
Example:
{
"errors": [
"unknown_type"
]
}403: Forbidden: Access denied.
Content-Type:
application/jsonResponse Properties:
errors: A list of errors.
Example:
{
"errors": [
"unknown_type"
]
}422: Unprocessable Entity.
Content-Type:
application/jsonResponse Properties:
errors: A list of errors.
Example:
{
"errors": [
"unknown_type"
]
}429: Too many requests: The rate limit set by the API has been exceeded.
Content-Type:
application/jsonResponse Properties:
errors: A list of errors.
Example:
{
"errors": [
"unknown_type"
]
}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. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Array of spans matching the request. | |
| meta | No | ||
| links | No |