Skip to main content
POST
Search spans

Authorizations

Authorization
string
header
required

A workspace API key, created in Superlog under Settings → API keys.

Body

application/json
range
enum<string>
default:1h

How far back from now to read, when since is not given.

Available options:
15m,
1h,
6h,
24h,
7d
since
string<date-time>

Start of the window. Overrides range.

until
string<date-time>

End of the window. Defaults to now. Windows are at most 30 days.

attributes
object[]

Exact matches on span attributes, such as http.route or http.response.status_code. HTTP status codes live here, not in statusCode.

Maximum array length: 20
limit
integer
default:50

Most rows to return.

Required range: 1 <= x <= 500
minDurationMs
number

Only spans at least this long.

Required range: 0 <= x <= 3600000
name
string

Only spans with this name.

Required string length: 1 - 500
resourceAttributes
object[]

Filters on resource attributes of the service that sent the data, such as deployment.environment.

Maximum array length: 20
service
string

Only this service.name.

Required string length: 1 - 200
statusCode
enum<string>

The OpenTelemetry span status. HTTP servers set ERROR only for 5xx responses; 4xx responses stay UNSET.

Available options:
STATUS_CODE_OK,
STATUS_CODE_ERROR,
STATUS_CODE_UNSET

Response

OK

since
string
required
spans
object[]
required
until
string
required