---
title: "Get Span"
method: POST
path: "/span/{id}/get-item"
tags: ["Span"]
---

# Get Span

`POST /span/{id}/get-item`

## Request

- Base URL: `https://oneuptime.com/api`
- URL: `https://oneuptime.com/api/span/{id}/get-item`
- Auth: API key in header `APIKey`
- TypeScript: <https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/docs/span/:id/get-item/post.ts> (a function with typed inputs; its response is checked against the schema)

Endpoint to retrieve a single Span by ID

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `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

## 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

## 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.
- `404`: Not found. The record does not exist, belongs to another project, or is one you may not read - the same answer for each.
- `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)