agent

Smart evidence research with automatic tier fallback

Smart endpoint with automatic tier fallback — recommended for most agent use cases.

Tries cached lookup first (instant, £0.02). On cache miss, escalates through consensus → quick → full up to the tier specified by max_tier. You're only charged for the tier actually executed.

Fallback chain: lookup → consensus → quick → full

Set ?async=true to get a 202 with a pollUrl when the pipeline has to run, instead of one silent connection for the whole run (proxies close a connection idle for ~125 s). Cache and consensus hits still answer at once.

Response headers: X-Check-Id, X-Tru8-Tx-Id

Rate limit: 10/minute

post/api/v1/agent/check

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/agent/check
Auth: none declared

Query parameters

asyncboolean

Headers

Idempotency-Keystring nullable

Request body

claimstring required

The claim text to analyse, or a URL to extract claims from

input_typestring nullable

Input type: 'text' or 'url'. Auto-detected from the claim field if omitted.

max_tierstring

Maximum pipeline tier to execute. The endpoint tries lookup first, then escalates up to this tier. Options: lookup, consensus, quick, full.

max_age_hoursinteger nullable

Maximum cache age in hours for lookup hits. If the cached result is older than this, it's treated as a miss and the endpoint escalates.

compactboolean

If true, returns claims and claim maps only — no evidence arrays.

Response

Evidence landscape returned (check _meta.executedTier for which tier was used, hit for cache status)

idstring required

Check ID (UUID)

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

Pipeline status values.

hitboolean nullable

Cache hit indicator (true = served from cache, absent = fresh pipeline run)

computedobject nullable

(JSON key: _computed) Pre-computed analytics: tier/type distributions, corroboration groups, diagnostic values, timeline, element state summaries

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"
        }
      ]
    }
  ],
  "meta": {
    "landscape": {
      "elementCount": 5,
      "elementStates": {
        "disputed": 1,
        "supported": 3,
        "unresolved": 1
      },
      "evidenceDensity": 13,
      "freshness": {
        "dateSpanDays": 180,
        "freshestDaysAgo": 2,
        "undatedCount": 1
      },
      "gaps": [
        {
          "claimPosition": 0,
          "description": "Is the trend accelerating?",
          "elementId": "e3",
          "evidenceCount": 2,
          "reason": "unresolved"
        }
      ],
      "sourceDiversity": {
        "tierSpread": {
          "commentary": 3,
          "primary": 4,
          "reporting": 6
        },
        "typeCoverage": 4,
        "uniqueDomains": 9
      },
      "sourcesConsidered": 13
    }
  }
}

Changes

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