unlob Docs
Browse documentation

How many independent sources say this?

Check whether a claim is independently reported.

get /corroborate

Request

curl \
  -H "x-api-key: $UNLOB_API_KEY" \
  "https://api.unlob.com/corroborate?id=<id>"

Behaviour

Returns the DISTINCT hosts carrying this passage's story, grouped by source and ranked by host authority, and counts them.

The anti-hallucination check: one echoed rumour and an independently reported fact look identical in a result list, and different here. `independent_sources` counts every host that asserted the story, including hosts whose copy was folded into this one as a near-duplicate.

Check it before you state something as established.

Costs 2 credits; a call that runs and fails costs 1.

Parameters

NameTypeDescription
idrequiredstringPassage id to corroborate.
limitintegerMaximum passages per source, default 10, maximum 100.

Responses

StatusMeaning
200Distinct hosts carrying the story, grouped and ranked by authority.
401Missing, unknown or revoked key. A key minted moments ago can answer 401 until it propagates to the serving fleet.
429Over the per-minute rate (spent in credits), or a hard-capped key without the credits this call costs. `retry-after` is present on the rate-limit case only.

The same call over MCP

This capability is corroborate on the MCP server, taking the same parameters and returning the same body. A parity test in the API fails the build if the two ever diverge, so you can read either reference and use the other.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "corroborate",
    "arguments": {
      "id": "<id>"
    }
  }
}

Most clients build that frame for you — see Connect a client.

See Errors for what to do with each status, and Retries and backoff for which are worth repeating.

FAQ

What does 200 mean on GET /corroborate?
Distinct hosts carrying the story, grouped and ranked by authority.
What does 401 mean on GET /corroborate?
Missing, unknown or revoked key. A key minted moments ago can answer 401 until it propagates to the serving fleet.
What does 429 mean on GET /corroborate?
Over the per-minute rate (spent in credits), or a hard-capped key without the credits this call costs. `retry-after` is present on the rate-limit case only.