Skip to main content
GET
/
v1
/
projects
/
{project_identifier}
/
spans
/
otlpv1
Search spans with simple filters (no DSL)
curl --request GET \
  --url https://api.example.com/v1/projects/{project_identifier}/spans/otlpv1
{
  "data": [
    {
      "attributes": [
        {
          "key": "<string>",
          "value": {
            "array_value": {
              "values": [
                "<unknown>"
              ]
            },
            "bool_value": true,
            "bytes_value": "<string>",
            "double_value": 123,
            "int_value": 0,
            "kvlist_value": null,
            "string_value": "<string>"
          }
        }
      ],
      "dropped_attributes_count": 2147483647,
      "dropped_events_count": 2147483647,
      "dropped_links_count": 2147483647,
      "end_time_unix_nano": 9223372036854776000,
      "events": [
        {
          "attributes": [
            {
              "key": "<string>",
              "value": {
                "array_value": {
                  "values": [
                    "<unknown>"
                  ]
                },
                "bool_value": true,
                "bytes_value": "<string>",
                "double_value": 123,
                "int_value": 0,
                "kvlist_value": null,
                "string_value": "<string>"
              }
            }
          ],
          "dropped_attributes_count": 2147483647,
          "name": "<string>",
          "time_unix_nano": 9223372036854776000
        }
      ],
      "flags": 2147483647,
      "kind": "SPAN_KIND_INTERNAL",
      "links": null,
      "name": "<string>",
      "parent_span_id": "<string>",
      "span_id": "<string>",
      "start_time_unix_nano": 9223372036854776000,
      "status": {
        "code": -1,
        "message": "<string>"
      },
      "trace_id": "<string>",
      "trace_state": "<string>"
    }
  ],
  "next_cursor": "<string>"
}

Path Parameters

​
project_identifier
string
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.

Query Parameters

​
cursor
string | null

Pagination cursor (Span Global ID)

​
limit
integer
default:100

Maximum number of spans to return

Required range: x <= 1000
​
start_time
string<date-time> | null

Inclusive lower bound time

​
end_time
string<date-time> | null

Exclusive upper bound time

​
trace_id
string[] | null

Filter by one or more trace IDs

​
parent_id
string | null

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

​
name
string[] | null

Filter by span name(s)

​
status_code
string[] | null

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

​
attribute
string[] | null

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

Paginated response where each span follows OTLP JSON structure.

​
data
OtlpSpan · object[]
required
​
next_cursor
string | null
required