Sign in

v51

OpenAPI 3.1.0raw.githubusercontent.com2026-08-01105276529.8 KB
spans

Search spans with simple filters (no DSL)

Return spans within a project filtered by time range. Supports cursor-based pagination.

get/v1/projects/{project_identifier}/spans/otlpv1

Path parameters

project_identifierstring required

The project identifier: either project ID or project name. If using a project name, it cannot contain slash (/), question mark (?), or pound sign (#) characters.

The project identifier: either project ID or project name. If using a project name, it cannot contain slash (/), question mark (?), or pound sign (#) characters.

Query parameters

cursorstring nullable

Pagination cursor (Span Global ID)

Pagination cursor (Span Global ID)

limitinteger

Maximum number of spans to return

Maximum number of spans to return

start_timestring date-time nullable

Inclusive lower bound time

Inclusive lower bound time

end_timestring date-time nullable

Exclusive upper bound time

Exclusive upper bound time

trace_idstring[] nullable

Filter by one or more trace IDs

Filter by one or more trace IDs

span_idstring[] nullable

Filter by one or more span IDs

Filter by one or more span IDs

parent_idstring nullable

Filter by parent span ID. Use "null" to get root spans only.

Filter by parent span ID. Use "null" to get root spans only.

namestring[] nullable

Filter by span name(s)

Filter by span name(s)

status_codestring[] nullable

Filter by status code(s). Values: OK, ERROR, UNSET

Filter by status code(s). Values: OK, ERROR, UNSET

attributestring[] nullable

Filter spans by key:value. Key is a dot-path (e.g. user.id, metadata.tier). Value is JSON-parsed: k:12345 is int, k:true is bool, otherwise string (k:user-42). To match a numeric- or boolean-looking STRING, JSON-quote it: user.id:"12345" (URL-encoded %2212345%22). Split is on the first : only, so values may contain colons (session.id:sess:abc:123, ISO timestamps). Repeat the param to AND filters. List-valued attributes (e.g. tag.tags) cannot be matched here. Returns 422 on malformed input (missing colon, empty key/value, or list/dict/null value).

Filter spans by key:value. Key is a dot-path (e.g. user.id, metadata.tier). Value is JSON-parsed: k:12345 is int, k:true is bool, otherwise string (k:user-42). To match a numeric- or boolean-looking STRING, JSON-quote it: user.id:"12345" (URL-encoded %2212345%22). Split is on the first : only, so values may contain colons (session.id:sess:abc:123, ISO timestamps). Repeat the param to AND filters. List-valued attributes (e.g. tag.tags) cannot be matched here. Returns 422 on malformed input (missing colon, empty key/value, or list/dict/null value).

Response

Successful Response

next_cursorstring nullable required