Claims - Wu-Weism

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.

Hide claim properties

string

UUID of the claim.

source_feature

string

The feature that produced this claim: "chat", "hybrid", or "legal".

claim_kind

string

The epistemic type of the claim. Common values: "hypothesis", "finding", "counterfactual", "mechanism".

status

string

Current status of the claim: "active", "retracted", or "superseded".

confidence_score

number

Numerical confidence in the claim, from 0.0 (no confidence) to 1.0 (certain). Derived from the underlying causal analysis.

uncertainty_label

string

Human-readable uncertainty bucket corresponding to confidence_score: "low", "medium", or "high".

trace_id

string

UUID of the counterfactual trace that produced this claim. Use this to retrieve the full trace via GET /api/scm/counterfactual-traces/.

session_id

string

UUID of the session in which this claim was generated.

created_at

string

ISO 8601 timestamp of when the claim was created.

Example

curl --request GET \
  --url 'https://wuweism.com/api/claims?limit=10&sourceFeature=chat' \
  --header 'Authorization: Bearer <token>'

const params = new URLSearchParams({
  limit: '10',
  sourceFeature: 'chat',
});

const response = await fetch(`https://wuweism.com/api/claims?${params}`, {
  headers: { 'Authorization': 'Bearer <token>' },
});

const { claims } = await response.json();

import requests

response = requests.get(
    'https://wuweism.com/api/claims',
    headers={'Authorization': 'Bearer <token>'},
    params={'limit': 10, 'sourceFeature': 'chat'},
)

claims = response.json()['claims']

{
  "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:

evidence_links

object[]

required

Documents, PDF analyses, or external sources that support this claim.

Show evidence_link properties

linkId

string

UUID of the evidence link.

sourceType

string

Type of evidence: "pdf", "company_profile", "trace", or "external".

label

string

Human-readable description of the evidence source.

url

string

URL or reference path for the source, if available.

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.

Show gate_decision properties

gate

string

Name of the gate: "novelty", "integrity", "identifiability".

passed

boolean

Whether the claim passed this gate.

rationale

string

Explanation of the gate decision.

timestamp

string

ISO 8601 timestamp of the gate evaluation.

Example

curl --request GET \
  --url https://wuweism.com/api/claims/c1a2b3d4-0001-4abc-9def-000000000001 \
  --header 'Authorization: Bearer <token>'

const claimId = 'c1a2b3d4-0001-4abc-9def-000000000001';

const response = await fetch(`https://wuweism.com/api/claims/${claimId}`, {
  headers: { 'Authorization': 'Bearer <token>' },
});

const claim = await response.json();

import requests

claim_id = 'c1a2b3d4-0001-4abc-9def-000000000001'

response = requests.get(
    f'https://wuweism.com/api/claims/{claim_id}',
    headers={'Authorization': 'Bearer <token>'},
)

claim = response.json()

{
  "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"
    }
  ]
}

{
  "success": false,
  "error": "Claim not found"
}

​List claims

​Query parameters

​Response fields

​Example

​Get a specific claim

​Path parameters

​Response fields

​Example

List claims

Query parameters

Response fields

Example

Get a specific claim

Path parameters

Response fields

Example