checks

Synchronous evidence research

Synchronous evidence research — single HTTP call, blocks until complete.

Recommended for agents and scripts. Submit a claim or URL, wait 60-120s, receive the full result with claims, elements, evidence, and analytics. No SSE, no polling, no claim selection required.

For URL/article inputs, claims are auto-selected (top-ranked, up to 5).

Sends nothing until the run finishes, and the edge closes a connection silent for ~125 s, so a slow run (URL inputs especially) can be cut off while it completes. Agents: use /agent/check?async=true and poll.

Rate limit: 10/minute

post/api/v1/checks/run

Request

  • Base URL: https://api.trueight.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.trueight.com/api/v1/checks/run
  • Auth: none declared

Request body

input_typestring required

Input type: 'url' (article analysis), 'text' (direct claim), 'image' (OCR), or 'video' (transcript)

contentstring nullable

Claim text (required when input_type is 'text'). Supports both statements and questions. Capped at 10,000 chars to prevent DoS via oversized inputs.

urlstring nullable

URL to analyse (required when input_type is 'url' or 'video'). HTTPS prefix is added automatically if omitted.

file_pathstring nullable

Server path for uploaded images (use POST /upload first)

user_querystring nullable

Optional Search Clarity question (max 200 chars). When provided, the pipeline generates a focused answer alongside the evidence landscape.

frozen_evidenceobject nullable

Pre-supplied evidence for replay testing (internal use only)

Response

Complete evidence landscape with claims, elements, and evidence

idstring required

Check ID (UUID)

inputType'url' | 'text' | 'image' | 'video' required

Supported input types for evidence research.

inputContentobject nullable

Original input data

inputUrlstring nullable

Source URL (if url input type)

status'processing' | 'waiting_for_selection' | 'completed' | 'failed' required

Pipeline status values.

creditsUsedinteger required

Credits consumed by this check

processingTimeMsinteger nullable

Total pipeline processing time in milliseconds

errorMessagestring nullable

Error details (only present on failed checks)

entryModestring nullable

How the check was initiated: article or direct

selectedClaimsCountinteger nullable

Number of claims selected for analysis

articleDomainstring nullable

Primary domain classification of the article

articleSecondaryDomainsstring[] nullable

Secondary domain classifications

articleJurisdictionstring nullable

Detected jurisdiction for adapter routing (UK, US, or global)

articleClassificationSourcestring nullable

How the article domain was classified

userQuerystring nullable

User's Search Clarity question (if provided)

queryResponsestring nullable

Search Clarity answer

queryConfidencenumber nullable

Search Clarity confidence score

querySourcesobject[] nullable

Sources used for Search Clarity answer

queryRelatedClaimsobject[] nullable

Claims related to the Search Clarity question

createdAtstring required

Check creation timestamp (ISO 8601)

completedAtstring nullable

Check completion timestamp (ISO 8601)

currentStagestring nullable

Current pipeline stage (only during processing): ingest, extract, retrieve, classify, map, etc.

progressnumber nullable

Pipeline progress percentage (0-100)

progressMessagestring nullable

Human-readable progress message

Example response

{
  "claims": [
    {
      "claimMap": {
        "claimType": "empirical",
        "elements": [
          {
            "description": "Did UK GDP grow in Q3 2025?",
            "elementId": "e1",
            "evidenceRefs": [
              {
                "evidenceId": "a1b2c3d4",
                "relationship": "supports",
                "snippet": "GDP grew by 0.6% in Q3 2025..."
              }
            ],
            "state": "supported"
          }
        ],
        "normalisedClaim": "UK GDP grew in Q3 2025",
        "orientation": "Evidence broadly supports this claim. 2 of 2 elements are supported by primary and reporting sources.",
        "orientationBasis": {
          "disputed": 0,
          "rule": "all_supported",
          "supported": 2,
          "unresolved": 0
        }
      },
      "evidence": [
        {
          "classificationMethod": "heuristic",
          "contentBasis": "api",
          "evidenceId": "a1b2c3d4",
          "evidenceType": "data",
          "id": "ev_abc123",
          "publishedDate": "2025-11-15T00:00:00",
          "receiptStatus": "shown",
          "relevanceScore": 4.2,
          "snippet": "GDP grew by 0.6% in Q3 2025, following growth of 0.5% in Q2...",
          "source": "Office for National Statistics",
          "tier": "primary",
          "title": "UK GDP quarterly estimate",
          "url": "https://www.ons.gov.uk/economy/data"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.