Skip to content
Documentation/Verification

Stream verification

Receive verification events as work progresses, then wait for the final result and completion event.

Markdown
POST/api/v1/verify/streamhttps://api.webcite.co

When to use it

Use curl --no-buffer to inspect the stream. See reading SSE safely for a client that retains partial network frames.

Use claim, include_stance, include_verdict, and decompose_claim. The shared request schema also lists include_numeric_assess, but the stream handler does not apply it; use the JSON verify endpoint for that option.

MCP completion contract

The hosted API uses evidence policy 13. The hosted MCP connector runs the current release; mcp-health reports its live version and tool count. A local MCP server runs the npm package version you installed. Inspect response metadata and the installed client version; saved responses retain their original policy and evidence time.

The MCP verify_claim_stream tool requires both the full result and a later done marker. Its structuredContent retains the result and a separate stream_usage receipt. Incomplete streams and accounting failures report partial_result; do not automatically replay a billable request after an ambiguous failure.

Request

Same 2/3/4-credit prices as JSON verification.

Examples run on your server. Set WEBCITE_API_KEY first. Python examples use the requests package.

curl
curl --no-buffer --fail-with-body -X POST 'https://api.webcite.co/api/v1/verify/stream' \
  -H "x-api-key: $WEBCITE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "claim": "The Eiffel Tower is 330 meters tall",
  "include_stance": true,
  "include_verdict": true
}'

Request body

claimstringrequired

The factual claim to verify

decompose_claimboolean

Break complex claims into sub-claims and verify each independently

Default: false

evidence_scopeobject

Ground the claim in a folder's filed sources instead of the web: {folder_id, include_descendants (default true)}. The response carries folder citations (stable citation_id, span, quote, folder_id, relation); stance and verdict are not produced. Omit for the unchanged web verification.

Show evidence_scope fields
folder_idstring
include_descendantsboolean

Default: true

filtersobject

Required source constraints. An unmet constraint returns no qualifying citation.

include_numeric_assessboolean

If true, also run deterministic numeric assessment on the claim text (no extra figure operands). Skips with reason when the claim is not numeric. Default false. Does not add a separate credit charge in this release; uses the verify bill only.

Default: false

include_source_readsboolean

Include retained supplied-URL read receipts. Requires a signed product source-verify delegation with an active workspace grant. Public MCP responses remain redacted.

include_stanceboolean

Include stance analysis for each source (adds 1 credit)

Default: true

include_verdictboolean

Generate an overall verdict with confidence score (adds 1 credit)

Default: true

source_urlsstring[]

Up to five public HTTPS source URLs to inspect directly.

thread_idstring

Thread ID to continue a conversation

Response

Content-Type is text/event-stream. Each data frame contains a JSON object with a type. Read result for the final structured response, usage for the billing receipt, and done for successful completion. error and accounting_error are separate failures. End of connection without done is not successful completion.

200 response

See the response guidance above. A complete JSON schema is not published for this response.

Errors

For 400, check the request fields and source identifiers. For 401, check your API key. For 429, wait for the retry interval. See the errors guide before retrying a billable request.

401
Unauthorized - API key required
429
Rate limit exceeded
Error handling and retry guidance