Get trace health for one trace

Get stored check results for one trace; this does not trigger an evaluation. Missing or not_evaluated results are not passes or promises of a future evaluation: unsampled traces may remain unevaluated. Results include applicability, failures, example span IDs, remediation, and evaluation metadata. Each call checks one category: trace_health (default) for instrumentation health or conversation_view for Conversation View compatibility.

GET/v1/projects/{projectId}/trace-health/traces/{traceId}

Authorization

AuthorizationPersonal API key · headerrequired

Your personal API key from Settings > Personal API Keys, sent as Bearer <key>.

X-Organization-IdOrganization ID · headerrequired

The organization to act in. Copy it with Copy organization ID in the organization menu or the settings sidebar.

Path parameters

projectIdstringrequired

traceIdstringrequired

The trace ID

Query parameters

categorystring

Choose instrumentation health or Conversation View compatibility checks

default: "trace_health"

Allowed:trace_healthconversation_view

Responses

200

Response for status 200

trace_healthobjectrequired

Show properties

trace_idstringrequired

checksobject[]required

Show properties

Array of object

check_idstringrequired

is_mutedbooleanrequired

Muted checks retain raw diagnostic results

check_versionnumberrequired

scopestringrequired

Allowed:tracespan

labelstringrequired

failure_labelstringrequired

descriptionstringrequired

remediationstringrequired

applicabilitystringrequired

impact_reasonsobjectrequired

Show properties

conversation viewstring

evalsstring

trace structure for eval contextstring

cost trackingstring

statusstring | nullrequired

Null means no stored result; not_evaluated means the check could not run. Neither is a pass or a guarantee of later evaluation.

Show properties

Any of:

string

string

null

null

applicable_countnumber | nullrequired

failed_countnumber | nullrequired

example_span_idsstring[]required

examples_truncatedbooleanrequired

metadataobjectrequired

trace_started_atstring | nullrequired

observed_through_ingested_atstring | nullrequired

evaluated_atstring | nullrequired

sourcestring | nullrequired

Show properties

Any of:

string

string

null

null

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Personal API keyOrganization IDRemember on this deviceInclude my values in samples

Parameters

projectIdpath*traceIdpath*The trace IDcategoryqueryChoose instrumentation health or Conversation View compatibility checks

Request

curl -X GET 'https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/trace-health/traces/YOUR_TRACE_ID' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'X-Organization-Id: YOUR_ORGANIZATION_ID' \
  -H 'Accept: application/json'

const response = await fetch("https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/trace-health/traces/YOUR_TRACE_ID", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "X-Organization-Id": "YOUR_ORGANIZATION_ID",
    "Accept": "application/json"
  }
});

import requests

response = requests.get(
    "https://api.judgmentlabs.ai/v1/projects/YOUR_PROJECT_ID/trace-health/traces/YOUR_TRACE_ID",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "X-Organization-Id": "YOUR_ORGANIZATION_ID",
        "Accept": "application/json"
    },
)

Response

{
  "trace_health": {
    "trace_id": "string",
    "checks": [
      {
        "check_id": "string",
        "is_muted": true,
        "check_version": 0,
        "scope": "trace",
        "label": "string",
        "failure_label": "string",
        "description": "string",
        "remediation": "string",
        "applicability": "string",
        "impact_reasons": {
          "conversation view": "string",
          "evals": "string",
          "trace structure for eval context": "string",
          "cost tracking": "string"
        },
        "status": "pass",
        "applicable_count": 0,
        "failed_count": 0,
        "example_span_ids": [
          "string"
        ],
        "examples_truncated": true,
        "metadata": {
          "property1": "string",
          "property2": "string"
        },
        "trace_started_at": "string",
        "observed_through_ingested_at": "string",
        "evaluated_at": "string",
        "source": "finalization"
      }
    ]
  }
}