agent

Instant cached lookup

Instant cached analysis — £0.02 per hit, no charge on miss.

Searches for a previous analysis of this claim (scoped to your account). Returns 200 in both cases — check the hit field to distinguish.

Cache hit: Full evidence landscape with hit: true. Cache miss: {hit: false, nextSuggestedTier, upgradeCostPence}.

Response headers (hit only): X-Check-Id, X-Tru8-Tx-Id

Rate limit: 30/minute

post/api/v1/agent/lookup

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

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.

compactboolean nullable

If true, returns claims and claim maps only — no evidence arrays. Reduces payload size for agents that only need orientation.

Response

Cache hit (full response with hit: true) or cache miss (structured miss with hit: false). Both return 200.

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.