Skip to main content

Documentation Index

Fetch the complete documentation index at: https://wuweism.com/llms.txt

Use this file to discover all available pages before exploring further.

Every causal assertion generated by Wu-Weism — whether from the causal chat, hybrid synthesize pipeline, or legal reasoning feature — is recorded as a claim in your account’s claim ledger. Claims carry a confidence score, uncertainty label, and provenance links back to the trace and session that produced them.
All claims endpoints require authentication. Include your session token in the Authorization header.

List claims

GET /api/claims
Returns a paginated list of claims for your account. Filter by session, trace, or source feature to narrow results.

Query parameters

limit
number
default:"20"
Maximum number of claims to return. Accepted range: 1–100. Defaults to 20.
sourceFeature
string
Filter claims by the feature that produced them. One of:
  • chat — claims from the causal chat interface
  • hybrid — claims from the hybrid synthesize pipeline
  • legal — claims from the legal reasoning feature
sessionId
string
Filter claims to a specific session UUID. Returns only claims produced in that session.
traceId
string
Filter claims linked to a specific counterfactual trace UUID.

Response fields

success
boolean
required
true when the request succeeds.
claims
object[]
required
Array of claim objects.

Example

curl --request GET \
  --url 'https://wuweism.com/api/claims?limit=10&sourceFeature=chat' \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "claims": [
    {
      "id": "c1a2b3d4-0001-4abc-9def-000000000001",
      "source_feature": "chat",
      "claim_kind": "hypothesis",
      "status": "active",
      "confidence_score": 0.82,
      "uncertainty_label": "high",
      "trace_id": "b3f1c2d4-88ae-4e1a-9c3b-7f2a0d5e6b19",
      "session_id": "s9f8e7d6-cc4d-4f1a-b802-d6e7f3a0c291",
      "created_at": "2026-01-15T10:30:00Z"
    },
    {
      "id": "c1a2b3d4-0001-4abc-9def-000000000002",
      "source_feature": "chat",
      "claim_kind": "counterfactual",
      "status": "active",
      "confidence_score": 0.61,
      "uncertainty_label": "medium",
      "trace_id": "a1b2c3d4-11aa-4e1a-9c3b-aabbccddeeff",
      "session_id": "s9f8e7d6-cc4d-4f1a-b802-d6e7f3a0c291",
      "created_at": "2026-01-15T10:35:22Z"
    }
  ]
}

Get a specific claim

GET /api/claims/{claimId}
Returns the full record for a single claim, including evidence links and gate decisions from the causal reasoning pipeline.

Path parameters

claimId
string
required
UUID of the claim to retrieve.

Response fields

All fields from the list response apply. The full record also includes:
Documents, PDF analyses, or external sources that support this claim.
gate_decisions
object[]
required
Records of each gate the claim passed through in the reasoning pipeline (e.g., novelty gate, integrity gate). Empty array if no gates were applied.

Example

curl --request GET \
  --url https://wuweism.com/api/claims/c1a2b3d4-0001-4abc-9def-000000000001 \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "id": "c1a2b3d4-0001-4abc-9def-000000000001",
  "source_feature": "chat",
  "claim_kind": "hypothesis",
  "status": "active",
  "confidence_score": 0.82,
  "uncertainty_label": "high",
  "trace_id": "b3f1c2d4-88ae-4e1a-9c3b-7f2a0d5e6b19",
  "session_id": "s9f8e7d6-cc4d-4f1a-b802-d6e7f3a0c291",
  "created_at": "2026-01-15T10:30:00Z",
  "evidence_links": [
    {
      "linkId": "el-001",
      "sourceType": "pdf",
      "label": "McEwen et al. (2012) — Stress and hippocampal plasticity",
      "url": null
    },
    {
      "linkId": "el-002",
      "sourceType": "trace",
      "label": "Counterfactual trace: cortisol_level → hippocampal_volume",
      "url": "/api/scm/counterfactual-traces/b3f1c2d4-88ae-4e1a-9c3b-7f2a0d5e6b19"
    }
  ],
  "gate_decisions": [
    {
      "gate": "identifiability",
      "passed": true,
      "rationale": "Back-door criterion satisfied with adjustment set ['stress_exposure'].",
      "timestamp": "2026-01-15T10:29:55Z"
    },
    {
      "gate": "novelty",
      "passed": true,
      "rationale": "Claim is sufficiently distinct from prior claims in this session.",
      "timestamp": "2026-01-15T10:29:58Z"
    }
  ]
}