--- title: "List Span" method: POST path: "/span/get-list" tags: ["Span"] --- # List Span `POST /span/get-list` ## Request - Base URL: `https://oneuptime.com/api` - URL: `https://oneuptime.com/api/span/get-list` - Auth: API key in header `APIKey` - TypeScript: (a function with typed inputs; its response is checked against the schema) Endpoint to list all Span items ## Request body - object - `query` SpanItemV3QuerySchema: Query schema for SpanItemV3. A field takes a plain value, which it matches exactly, or an operator its type allows. Telemetry tables are large: bound every query by startTime. - `projectId` union: Query operators for projectId field of type Object ID. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - `primaryEntityId` union: Query operators for primaryEntityId field of type Object ID. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - `primaryEntityType` union: Query operators for primaryEntityType field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `startTime` union: Query operators for startTime field of type DateTime64. Supported operators: EqualTo, NotEqual, IsNull, NotNull, GreaterThan, GreaterThanOrEqual, LessThan, LessThanOrEqual, InBetween. Times are ISO-8601, such as 2026-01-01T00:00:00.000Z. - string, date-time - object - `_type` 'NotEqual', required - `value` string, date-time, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'GreaterThan', required - `value` string, date-time, required - object - `_type` 'GreaterThanOrEqual', required - `value` string, date-time, required - object - `_type` 'LessThan', required - `value` string, date-time, required - object - `_type` 'LessThanOrEqual', required - `value` string, date-time, required - object - `_type` 'InBetween', required - `startValue` string, date-time, required - `endValue` string, date-time, required - `endTime` union: Query operators for endTime field of type DateTime64. Supported operators: EqualTo, NotEqual, IsNull, NotNull, GreaterThan, GreaterThanOrEqual, LessThan, LessThanOrEqual, InBetween. Times are ISO-8601, such as 2026-01-01T00:00:00.000Z. - string, date-time - object - `_type` 'NotEqual', required - `value` string, date-time, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'GreaterThan', required - `value` string, date-time, required - object - `_type` 'GreaterThanOrEqual', required - `value` string, date-time, required - object - `_type` 'LessThan', required - `value` string, date-time, required - object - `_type` 'LessThanOrEqual', required - `value` string, date-time, required - object - `_type` 'InBetween', required - `startValue` string, date-time, required - `endValue` string, date-time, required - `startTimeUnixNano` union: Query operators for startTimeUnixNano field of type UInt64. Supported operators: EqualTo, NotEqual, IsNull, NotNull, GreaterThan, GreaterThanOrEqual, LessThan, LessThanOrEqual, InBetween. A value past 2^53 is sent as a string of digits. - number - string - object - `_type` 'NotEqual', required - `value` union, required - number - string - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'GreaterThan', required - `value` union, required - number - string - object - `_type` 'GreaterThanOrEqual', required - `value` union, required - number - string - object - `_type` 'LessThan', required - `value` union, required - number - string - object - `_type` 'LessThanOrEqual', required - `value` union, required - number - string - object - `_type` 'InBetween', required - `startValue` union, required - number - string - `endValue` union, required - number - string - `durationUnixNano` union: Query operators for durationUnixNano field of type Long Number. Supported operators: EqualTo, NotEqual, IsNull, NotNull, GreaterThan, GreaterThanOrEqual, LessThan, LessThanOrEqual, InBetween. A value past 2^53 is sent as a string of digits. - number - string - object - `_type` 'NotEqual', required - `value` union, required - number - string - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'GreaterThan', required - `value` union, required - number - string - object - `_type` 'GreaterThanOrEqual', required - `value` union, required - number - string - object - `_type` 'LessThan', required - `value` union, required - number - string - object - `_type` 'LessThanOrEqual', required - `value` union, required - number - string - object - `_type` 'InBetween', required - `startValue` union, required - number - string - `endValue` union, required - number - string - `endTimeUnixNano` union: Query operators for endTimeUnixNano field of type UInt64. Supported operators: EqualTo, NotEqual, IsNull, NotNull, GreaterThan, GreaterThanOrEqual, LessThan, LessThanOrEqual, InBetween. A value past 2^53 is sent as a string of digits. - number - string - object - `_type` 'NotEqual', required - `value` union, required - number - string - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'GreaterThan', required - `value` union, required - number - string - object - `_type` 'GreaterThanOrEqual', required - `value` union, required - number - string - object - `_type` 'LessThan', required - `value` union, required - number - string - object - `_type` 'LessThanOrEqual', required - `value` union, required - number - string - object - `_type` 'InBetween', required - `startValue` union, required - number - string - `endValue` union, required - number - string - `traceId` union: Query operators for traceId field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `spanId` union: Query operators for spanId field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `sessionId` union: Query operators for sessionId field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `parentSpanId` union: Query operators for parentSpanId field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `traceState` union: Query operators for traceState field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `attributes` object: Query operators for attributes field of type Map(String, String). Supported operators: EqualTo, NotEqual, IsNull, NotNull, Search. Filtered by key, each key with these operators: {"attributes": {"": }}. - `attributeKeys` union: Query operators for attributeKeys field of type Array of Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, Search. EqualTo, NotEqual and Search match one element; Includes matches any of several. - object - `_type` 'EqualTo', required - `value` string, required - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'Search', required - `value` string, required - `entityKeys` union: Query operators for entityKeys field of type Array of Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, Search. EqualTo, NotEqual and Search match one element; Includes matches any of several. - object - `_type` 'EqualTo', required - `value` string, required - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'Search', required - `value` string, required - `serviceEntityKey` union: Query operators for serviceEntityKey field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `hostEntityKey` union: Query operators for hostEntityKey field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `k8sPodEntityKey` union: Query operators for k8sPodEntityKey field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `k8sNodeEntityKey` union: Query operators for k8sNodeEntityKey field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `k8sClusterEntityKey` union: Query operators for k8sClusterEntityKey field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `containerEntityKey` union: Query operators for containerEntityKey field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `events` union: Query operators for events field of type JSON Array. Supported operators: IsNull, NotNull. - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - `links` union: Query operators for links field of type JSON. Supported operators: IsNull, NotNull. - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - `statusCode` union: Query operators for statusCode field of type Number. Supported operators: EqualTo, NotEqual, IsNull, NotNull, GreaterThan, GreaterThanOrEqual, LessThan, LessThanOrEqual, InBetween. - number - object - `_type` 'NotEqual', required - `value` number, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'GreaterThan', required - `value` number, required - object - `_type` 'GreaterThanOrEqual', required - `value` number, required - object - `_type` 'LessThan', required - `value` number, required - object - `_type` 'LessThanOrEqual', required - `value` number, required - object - `_type` 'InBetween', required - `startValue` number, required - `endValue` number, required - `statusMessage` union: Query operators for statusMessage field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `name` union: Query operators for name field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `kind` union: Query operators for kind field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `hasException` union: Query operators for hasException field of type Boolean. Supported operators: EqualTo, NotEqual, IsNull, NotNull. - boolean - object - `_type` 'NotEqual', required - `value` boolean, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - `isRootSpan` union: Query operators for isRootSpan field of type Boolean. Supported operators: EqualTo, NotEqual, IsNull, NotNull. - boolean - object - `_type` 'NotEqual', required - `value` boolean, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - `isEntrySpan` union: Query operators for isEntrySpan field of type Boolean. Supported operators: EqualTo, NotEqual, IsNull, NotNull. - boolean - object - `_type` 'NotEqual', required - `value` boolean, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - `isLlmSpan` union: Query operators for isLlmSpan field of type Boolean. Supported operators: EqualTo, NotEqual, IsNull, NotNull. - boolean - object - `_type` 'NotEqual', required - `value` boolean, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - `llmSystem` union: Query operators for llmSystem field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `llmOperation` union: Query operators for llmOperation field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `llmRequestModel` union: Query operators for llmRequestModel field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `llmResponseModel` union: Query operators for llmResponseModel field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `llmAgentName` union: Query operators for llmAgentName field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `llmToolName` union: Query operators for llmToolName field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `llmInputTokens` union: Query operators for llmInputTokens field of type Number. Supported operators: EqualTo, NotEqual, IsNull, NotNull, GreaterThan, GreaterThanOrEqual, LessThan, LessThanOrEqual, InBetween. - number - object - `_type` 'NotEqual', required - `value` number, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'GreaterThan', required - `value` number, required - object - `_type` 'GreaterThanOrEqual', required - `value` number, required - object - `_type` 'LessThan', required - `value` number, required - object - `_type` 'LessThanOrEqual', required - `value` number, required - object - `_type` 'InBetween', required - `startValue` number, required - `endValue` number, required - `llmOutputTokens` union: Query operators for llmOutputTokens field of type Number. Supported operators: EqualTo, NotEqual, IsNull, NotNull, GreaterThan, GreaterThanOrEqual, LessThan, LessThanOrEqual, InBetween. - number - object - `_type` 'NotEqual', required - `value` number, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'GreaterThan', required - `value` number, required - object - `_type` 'GreaterThanOrEqual', required - `value` number, required - object - `_type` 'LessThan', required - `value` number, required - object - `_type` 'LessThanOrEqual', required - `value` number, required - object - `_type` 'InBetween', required - `startValue` number, required - `endValue` number, required - `llmTotalTokens` union: Query operators for llmTotalTokens field of type Number. Supported operators: EqualTo, NotEqual, IsNull, NotNull, GreaterThan, GreaterThanOrEqual, LessThan, LessThanOrEqual, InBetween. - number - object - `_type` 'NotEqual', required - `value` number, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'GreaterThan', required - `value` number, required - object - `_type` 'GreaterThanOrEqual', required - `value` number, required - object - `_type` 'LessThan', required - `value` number, required - object - `_type` 'LessThanOrEqual', required - `value` number, required - object - `_type` 'InBetween', required - `startValue` number, required - `endValue` number, required - `llmCost` union: Query operators for llmCost field of type Decimal. Supported operators: EqualTo, NotEqual, IsNull, NotNull, GreaterThan, GreaterThanOrEqual, LessThan, LessThanOrEqual, InBetween. - number - object - `_type` 'NotEqual', required - `value` number, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'GreaterThan', required - `value` number, required - object - `_type` 'GreaterThanOrEqual', required - `value` number, required - object - `_type` 'LessThan', required - `value` number, required - object - `_type` 'LessThanOrEqual', required - `value` number, required - object - `_type` 'InBetween', required - `startValue` number, required - `endValue` number, required - `llmConversationId` union: Query operators for llmConversationId field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `llmUserId` union: Query operators for llmUserId field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `llmUserEmail` union: Query operators for llmUserEmail field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `llmTeam` union: Query operators for llmTeam field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `llmCallKind` union: Query operators for llmCallKind field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `llmIssues` union: Query operators for llmIssues field of type Array of Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, Search. EqualTo, NotEqual and Search match one element; Includes matches any of several. - object - `_type` 'EqualTo', required - `value` string, required - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'Search', required - `value` string, required - `llmUserMessagePreview` union: Query operators for llmUserMessagePreview field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes, EqualToOrNull, Search. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - object - `_type` 'EqualToOrNull', required - `value` string, required - object - `_type` 'Search', required - `value` string, required - `_id` union: Query operators for _id field of type Object ID. Supported operators: EqualTo, NotEqual, IsNull, NotNull, Includes. - string - object - `_type` 'NotEqual', required - `value` string, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'Includes', required - `value` string[], required - `createdAt` union: Query operators for createdAt field of type Date. Supported operators: EqualTo, NotEqual, IsNull, NotNull, GreaterThan, GreaterThanOrEqual, LessThan, LessThanOrEqual, InBetween. Times are ISO-8601, such as 2026-01-01T00:00:00.000Z. - string, date-time - object - `_type` 'NotEqual', required - `value` string, date-time, required - object - `_type` 'IsNull', required - object - `_type` 'NotNull', required - object - `_type` 'GreaterThan', required - `value` string, date-time, required - object - `_type` 'GreaterThanOrEqual', required - `value` string, date-time, required - object - `_type` 'LessThan', required - `value` string, date-time, required - object - `_type` 'LessThanOrEqual', required - `value` string, date-time, required - object - `_type` 'InBetween', required - `startValue` string, date-time, required - `endValue` string, date-time, required - `select` SpanItemV3SelectSchema: Select schema for SpanItemV3. Set fields to true to include them in the response. - `projectId` boolean - `primaryEntityId` boolean - `primaryEntityType` boolean - `startTime` boolean - `endTime` boolean - `startTimeUnixNano` boolean - `durationUnixNano` boolean - `endTimeUnixNano` boolean - `traceId` boolean - `spanId` boolean - `sessionId` boolean - `parentSpanId` boolean - `traceState` boolean - `attributes` boolean - `attributeKeys` boolean - `entityKeys` boolean - `serviceEntityKey` boolean - `hostEntityKey` boolean - `k8sPodEntityKey` boolean - `k8sNodeEntityKey` boolean - `k8sClusterEntityKey` boolean - `containerEntityKey` boolean - `events` boolean - `links` boolean - `statusCode` boolean - `statusMessage` boolean - `name` boolean - `kind` boolean - `hasException` boolean - `isRootSpan` boolean - `isEntrySpan` boolean - `isLlmSpan` boolean - `llmSystem` boolean - `llmOperation` boolean - `llmRequestModel` boolean - `llmResponseModel` boolean - `llmAgentName` boolean - `llmToolName` boolean - `llmInputTokens` boolean - `llmOutputTokens` boolean - `llmTotalTokens` boolean - `llmCost` boolean - `llmConversationId` boolean - `llmUserId` boolean - `llmUserEmail` boolean - `llmTeam` boolean - `llmCallKind` boolean - `llmIssues` boolean - `llmUserMessagePreview` boolean - `_id` boolean - `createdAt` boolean - `sort` SpanItemV3SortSchema: Sort schema for SpanItemV3. Only sortable fields are included. - `projectId` 'ASC' | 'DESC': Sort order for projectId field - `primaryEntityId` 'ASC' | 'DESC': Sort order for primaryEntityId field - `primaryEntityType` 'ASC' | 'DESC': Sort order for primaryEntityType field - `startTime` 'ASC' | 'DESC': Sort order for startTime field - `endTime` 'ASC' | 'DESC': Sort order for endTime field - `startTimeUnixNano` 'ASC' | 'DESC': Sort order for startTimeUnixNano field - `durationUnixNano` 'ASC' | 'DESC': Sort order for durationUnixNano field - `endTimeUnixNano` 'ASC' | 'DESC': Sort order for endTimeUnixNano field - `traceId` 'ASC' | 'DESC': Sort order for traceId field - `spanId` 'ASC' | 'DESC': Sort order for spanId field - `sessionId` 'ASC' | 'DESC': Sort order for sessionId field - `parentSpanId` 'ASC' | 'DESC': Sort order for parentSpanId field - `traceState` 'ASC' | 'DESC': Sort order for traceState field - `serviceEntityKey` 'ASC' | 'DESC': Sort order for serviceEntityKey field - `hostEntityKey` 'ASC' | 'DESC': Sort order for hostEntityKey field - `k8sPodEntityKey` 'ASC' | 'DESC': Sort order for k8sPodEntityKey field - `k8sNodeEntityKey` 'ASC' | 'DESC': Sort order for k8sNodeEntityKey field - `k8sClusterEntityKey` 'ASC' | 'DESC': Sort order for k8sClusterEntityKey field - `containerEntityKey` 'ASC' | 'DESC': Sort order for containerEntityKey field - `statusCode` 'ASC' | 'DESC': Sort order for statusCode field - `statusMessage` 'ASC' | 'DESC': Sort order for statusMessage field - `name` 'ASC' | 'DESC': Sort order for name field - `kind` 'ASC' | 'DESC': Sort order for kind field - `hasException` 'ASC' | 'DESC': Sort order for hasException field - `isRootSpan` 'ASC' | 'DESC': Sort order for isRootSpan field - `isEntrySpan` 'ASC' | 'DESC': Sort order for isEntrySpan field - `isLlmSpan` 'ASC' | 'DESC': Sort order for isLlmSpan field - `llmSystem` 'ASC' | 'DESC': Sort order for llmSystem field - `llmOperation` 'ASC' | 'DESC': Sort order for llmOperation field - `llmRequestModel` 'ASC' | 'DESC': Sort order for llmRequestModel field - `llmResponseModel` 'ASC' | 'DESC': Sort order for llmResponseModel field - `llmAgentName` 'ASC' | 'DESC': Sort order for llmAgentName field - `llmToolName` 'ASC' | 'DESC': Sort order for llmToolName field - `llmInputTokens` 'ASC' | 'DESC': Sort order for llmInputTokens field - `llmOutputTokens` 'ASC' | 'DESC': Sort order for llmOutputTokens field - `llmTotalTokens` 'ASC' | 'DESC': Sort order for llmTotalTokens field - `llmCost` 'ASC' | 'DESC': Sort order for llmCost field - `llmConversationId` 'ASC' | 'DESC': Sort order for llmConversationId field - `llmUserId` 'ASC' | 'DESC': Sort order for llmUserId field - `llmUserEmail` 'ASC' | 'DESC': Sort order for llmUserEmail field - `llmTeam` 'ASC' | 'DESC': Sort order for llmTeam field - `llmCallKind` 'ASC' | 'DESC': Sort order for llmCallKind field - `llmUserMessagePreview` 'ASC' | 'DESC': Sort order for llmUserMessagePreview field - `retentionDate` 'ASC' | 'DESC': Sort order for retentionDate field - `_id` 'ASC' | 'DESC': Sort order for _id field - `createdAt` 'ASC' | 'DESC': Sort order for createdAt field - `groupBy` SpanItemV3GroupBySchema: Group by schema for SpanItemV3. Only one field can be set to true for grouping. - `projectId` boolean: Group by projectId field. Only one field can be selected for grouping. - `primaryEntityId` boolean: Group by primaryEntityId field. Only one field can be selected for grouping. - `primaryEntityType` boolean: Group by primaryEntityType field. Only one field can be selected for grouping. - `traceId` boolean: Group by traceId field. Only one field can be selected for grouping. - `spanId` boolean: Group by spanId field. Only one field can be selected for grouping. - `sessionId` boolean: Group by sessionId field. Only one field can be selected for grouping. - `parentSpanId` boolean: Group by parentSpanId field. Only one field can be selected for grouping. - `traceState` boolean: Group by traceState field. Only one field can be selected for grouping. - `serviceEntityKey` boolean: Group by serviceEntityKey field. Only one field can be selected for grouping. - `hostEntityKey` boolean: Group by hostEntityKey field. Only one field can be selected for grouping. - `k8sPodEntityKey` boolean: Group by k8sPodEntityKey field. Only one field can be selected for grouping. - `k8sNodeEntityKey` boolean: Group by k8sNodeEntityKey field. Only one field can be selected for grouping. - `k8sClusterEntityKey` boolean: Group by k8sClusterEntityKey field. Only one field can be selected for grouping. - `containerEntityKey` boolean: Group by containerEntityKey field. Only one field can be selected for grouping. - `statusCode` boolean: Group by statusCode field. Only one field can be selected for grouping. - `statusMessage` boolean: Group by statusMessage field. Only one field can be selected for grouping. - `name` boolean: Group by name field. Only one field can be selected for grouping. - `kind` boolean: Group by kind field. Only one field can be selected for grouping. - `hasException` boolean: Group by hasException field. Only one field can be selected for grouping. - `isRootSpan` boolean: Group by isRootSpan field. Only one field can be selected for grouping. - `isEntrySpan` boolean: Group by isEntrySpan field. Only one field can be selected for grouping. - `isLlmSpan` boolean: Group by isLlmSpan field. Only one field can be selected for grouping. - `llmSystem` boolean: Group by llmSystem field. Only one field can be selected for grouping. - `llmOperation` boolean: Group by llmOperation field. Only one field can be selected for grouping. - `llmRequestModel` boolean: Group by llmRequestModel field. Only one field can be selected for grouping. - `llmResponseModel` boolean: Group by llmResponseModel field. Only one field can be selected for grouping. - `llmAgentName` boolean: Group by llmAgentName field. Only one field can be selected for grouping. - `llmToolName` boolean: Group by llmToolName field. Only one field can be selected for grouping. - `llmInputTokens` boolean: Group by llmInputTokens field. Only one field can be selected for grouping. - `llmOutputTokens` boolean: Group by llmOutputTokens field. Only one field can be selected for grouping. - `llmTotalTokens` boolean: Group by llmTotalTokens field. Only one field can be selected for grouping. - `llmConversationId` boolean: Group by llmConversationId field. Only one field can be selected for grouping. - `llmUserId` boolean: Group by llmUserId field. Only one field can be selected for grouping. - `llmUserEmail` boolean: Group by llmUserEmail field. Only one field can be selected for grouping. - `llmTeam` boolean: Group by llmTeam field. Only one field can be selected for grouping. - `llmCallKind` boolean: Group by llmCallKind field. Only one field can be selected for grouping. - `llmUserMessagePreview` boolean: Group by llmUserMessagePreview field. Only one field can be selected for grouping. - `_id` boolean: Group by _id field. Only one field can be selected for grouping. - `createdAt` boolean: Group by createdAt field. Only one field can be selected for grouping. - `limit` number: Maximum number of items to return. Defaults to 10. - `skip` number: Number of items to skip for pagination. Defaults to 0. ## Response `200` Successful response - object - `data` SpanItemV3[] - `projectId` string, required: Project ID - `primaryEntityId` string, required: Service ID - `primaryEntityType` string: Service Type - `startTime` string: Start Time - `endTime` string: End Time - `startTimeUnixNano` string: Start Time in Unix Nano - `durationUnixNano` number, required: Duration in Unix Nano - `endTimeUnixNano` string: End Time - `traceId` string, required: Trace ID - `spanId` string, required: Span ID - `sessionId` string: Session ID - `parentSpanId` string: Parent Span ID - `traceState` string: Trace State - `attributes` string: Attributes - `attributeKeys` string[]: Attribute Keys - `entityKeys` string[]: Entity Keys - `serviceEntityKey` string: Service Entity Key - `hostEntityKey` string: Host Entity Key - `k8sPodEntityKey` string: Kubernetes Pod Entity Key - `k8sNodeEntityKey` string: Kubernetes Node Entity Key - `k8sClusterEntityKey` string: Kubernetes Cluster Entity Key - `containerEntityKey` string: Container Entity Key - `events` object[]: Events - `links` object: Links - `statusCode` number: Status Code - `statusMessage` string: Status Message - `name` string: Name - `kind` string: Kind - `hasException` boolean: Has Exception - `isRootSpan` boolean: Is Root Span - `isEntrySpan` boolean: Is Entry Span - `isLlmSpan` boolean: Is LLM Span - `llmSystem` string: LLM System - `llmOperation` string: LLM Operation - `llmRequestModel` string: LLM Request Model - `llmResponseModel` string: LLM Response Model - `llmAgentName` string: LLM Agent Name - `llmToolName` string: LLM Tool Name - `llmInputTokens` number: LLM Input Tokens - `llmOutputTokens` number: LLM Output Tokens - `llmTotalTokens` number: LLM Total Tokens - `llmCost` number: LLM Cost (USD) - `llmConversationId` string: LLM Conversation ID - `llmUserId` string: LLM User ID - `llmUserEmail` string: LLM User Email - `llmTeam` string: LLM Team - `llmCallKind` string: LLM Call Kind - `llmIssues` string[]: LLM Answer Issues - `llmUserMessagePreview` string: LLM User Message Preview - `count` number ## Other responses - `400`: Bad request. This response indicates that the request was malformed or contained invalid data. - `401`: Unauthorized. This response indicates that the request requires user authentication. - `402`: Payment Required. This response indicates that the request requires payment or a valid subscription. - `403`: Forbidden. This response indicates that the server understood the request, but refuses to authorize it. - `405`: Project not found. This response indicates that the requested project does not exist or is not accessible. - `408`: Request Timeout. This response indicates that the server timed out waiting for the request. - `415`: Unable to reach server. This response indicates that the server is currently unreachable or down. - `422`: Not authorized. This response indicates that the user does not have permission to access the requested resource. - `500`: Internal Server Error. This response indicates that the server encountered an unexpected condition that prevented it from fulfilling the request. --- [API](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification.md) - [All operations](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/revisions/ba3307d00304?raw)