Skip to main content
POST
https://api.tracelm.ai
/
api
/
v1
/
verification
/
verify
/
{trace_id}
Verify Claims
curl --request POST \
  --url https://api.tracelm.ai/api/v1/verification/verify/{trace_id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "verifiers": [
    {}
  ],
  "knowledge_base_id": "<string>",
  "extract_claims": true
}
'
{
  "trace_id": "<string>",
  "trust_score": 123,
  "claims": [
    {}
  ],
  "verifiers_used": [
    {}
  ],
  "verified_at": "<string>"
}
Triggers verification analysis on a specific trace to check claims against knowledge bases and external sources.

​
Path Parameters

​
trace_id
string
required
The trace ID to verify

​
Request Body

​
verifiers
array
List of verifiers to use. If not specified, all enabled verifiers run.
  • knowledge_base: Check against uploaded facts
  • web_search: Search web for evidence
  • multi_model: Cross-reference with other LLMs
  • citation: Validate cited sources
​
knowledge_base_id
string
Specific knowledge base to use for verification
​
extract_claims
boolean
default:"true"
Whether to extract claims from the response before verification

​
Response

​
trace_id
string
The verified trace ID
​
trust_score
number
Overall trust score (0-100)
​
claims
array
Array of extracted and verified claims:
  • claim_text: The claim statement
  • verdict: supported, contradicted, or unverifiable
  • confidence: Confidence in the verdict (0-1)
  • evidence: Array of evidence objects
​
verifiers_used
array
List of verifiers that were executed
​
verified_at
string
Verification timestamp (ISO 8601)

​
Example

curl -X POST "https://api.tracelm.ai/api/v1/verification/verify/trace_abc123" \
  -H "X-API-Key: $TRACELM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "verifiers": ["knowledge_base", "web_search"],
    "extract_claims": true
  }'

​
Response

{
  "trace_id": "trace_abc123",
  "trust_score": 95,
  "claims": [
    {
      "claim_text": "The capital of France is Paris",
      "verdict": "supported",
      "confidence": 0.98,
      "evidence": [
        {
          "source": "knowledge_base",
          "fact": "Paris is the capital city of France",
          "relevance": 0.99
        },
        {
          "source": "web_search",
          "url": "https://en.wikipedia.org/wiki/Paris",
          "snippet": "Paris is the capital and most populous city of France",
          "relevance": 0.97
        }
      ]
    }
  ],
  "verifiers_used": ["knowledge_base", "web_search"],
  "verified_at": "2024-01-15T10:35:00Z"
}

​
Verdicts

VerdictDescription
supportedClaim is backed by evidence from verifiers
contradictedEvidence contradicts the claim
unverifiableCannot find sufficient evidence to verify

​
Trust Score Levels

ScoreLevelColor
80-100HighGreen
60-79MediumYellow
40-59LowOrange
0-39Very LowRed
Verification is an async process. For high-latency verifiers like web search, consider using webhooks or polling for results.