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 Traces
      • POSTTrace Ingestion
      • GETRetrieve Trace
  • Evals
  • Legacy
LogoLogo
Trust CenterStatusSupportGet a demoPlatform
Data ModelsTraces

Retrieve Trace

GET
https://api.confident-ai.com/v1/traces/:traceUuid
GET
/v1/traces/:traceUuid
$curl https://api.confident-ai.com/v1/traces/traceUuid \
>     -H "CONFIDENT_API_KEY: <PROJECT-API-KEY>"
200Retrieved
1{
2  "success": true,
3  "data": {
4    "uuid": "TRACE-ID",
5    "startTime": "2025-01-15T10:30:00Z",
6    "endTime": "2025-01-15T10:30:05Z",
7    "projectId": "PROJECT-ID",
8    "spans": [
9      {
10        "id": "SPAN-ID",
11        "uuid": "SPAN-UUID",
12        "name": "Span Name",
13        "startTime": "2025-01-15T10:30:00Z",
14        "endTime": "2025-01-15T10:30:05Z",
15        "traceUuid": "TRACE-UUID",
16        "status": "SUCCESS",
17        "type": "LLM",
18        "model": "gpt-4o",
19        "provider": "OpenAI",
20        "integration": "LangChain"
21      }
22    ],
23    "name": "Trace Name",
24    "environment": "production"
25  },
26  "deprecated": false
27}
Retrieves an existing trace on your Confident AI project.
Was this page helpful?
Previous

List Spans

Next
Built with

Path parameters

traceUuidstringRequired
This is the trace UUID you wish to retrieve.

Headers

CONFIDENT_API_KEYstringRequired
The API key of your Confident AI project.

Response

successboolean
This is true if the trace was successfully retrieved.
dataobject
This maps to the retrieved trace data.
deprecatedboolean
This is true if this endpoint is deprecated.