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

Production rollout verified on 24 September 2026: the hosted API includes evidence policy 13 and the hosted MCP connector runs 1.9.0. This does not publish or upgrade the npm package installed by local clients. Inspect response metadata and the installed client version; saved responses retain their original policy and evidence time.

MCP 1.9.0 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

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_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

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