Skip to main content
POST
POST /corroborate

Use case

Verify a factual claim about a company against BETA’s structured sources (SEC filings, M&A transactions, material events, news, people index) before your agent acts on it. Returns corroborated: true with evidence + confidence, or corroborated: false with reason: "no_match" when sources don’t support the claim. This is the citation-discipline primitive — treat corroborated: false as informational, not as failure. For the standard integration pattern, see Recipes → Corroborate before write.

Request

string
required
Company name or entity key. 2–200 characters.
array
required
Array of 1–10 claim objects. Each claim:

Response

object
Resolved entity (key, name, verified).
array
One result per submitted claim, indexed by claim_index.
object
sources_available, entity_coverage (public_company | private_company), corroborated_at (ISO timestamp), resolution (per Citation Contract).

Code samples

Live response

Cost notes

/corroborate is BETA’s most expensive call (0.10/claimduringoverageversus0.10/claim during overage versus 0.05 for the others). Batch up to 10 claims per request to minimize round-trip cost and latency.

Errors

Citation pointer

See Citation Contract for how corroborated: false is the explicit refusal signal — the most important shape this endpoint produces.