For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Trust CenterStatusSupportGet a demoPlatform
DocumentationEvals API ReferenceIntegrations & OTELPlatform SettingsSelf-HostingGuidesChangelog
DocumentationEvals API ReferenceIntegrations & OTELPlatform SettingsSelf-HostingGuidesChangelog
  • Get Started
    • Introduction
    • Quickstart
    • Authentication
    • Data Models
    • API Conventions
  • Data Models
      • GETList Spans
      • GETRetrieve Span
  • Evals
  • Legacy
LogoLogo
Trust CenterStatusSupportGet a demoPlatform
Data ModelsSpans

Retrieve Span

GET
https://api.confident-ai.com/v1/spans/:spanUuid
GET
/v1/spans/:spanUuid
$curl https://api.confident-ai.com/v1/spans/SPAN-UUID \
>     -H "CONFIDENT_API_KEY: <PROJECT-API-KEY>"
200Retrieved
1{
2  "success": true,
3  "data": {
4    "uuid": "SPAN-UUID",
5    "name": "Span Name",
6    "status": "SUCCESS",
7    "startTime": "2025-01-15T10:30:00Z",
8    "endTime": "2025-01-15T10:30:05Z",
9    "type": "LLM",
10    "model": "gpt-4o",
11    "provider": "OpenAI",
12    "integration": "LangChain",
13    "promptAlias": "Prompt Alias",
14    "id": "SPAN-ID",
15    "traceUuid": "TRACE-UUID"
16  },
17  "deprecated": false
18}
Retrieves a single, detailed span by its unique identifier.
Was this page helpful?
Previous

List Threads

Next
Built with

Path parameters

spanUuidstringRequired
This is the span UUID you wish to retrieve.

Headers

CONFIDENT_API_KEYstringRequiredformat: "uuid"
The API key of your Confident AI project.

Response

Successfully retrieved the detailed span.
successboolean
This is true if the span was successfully retrieved.
dataobject
The payload containing the detailed span data.
deprecatedboolean
This is true if this endpoint is deprecated.