Skip to main content
POST
POST /validate

Use case

Resolve a company name from a customer email, chat message, or CRM record into a canonical BETA entity before calling other endpoints. /validate is a fast cache lookup — call it first to avoid wasted lookups on unknown or low-confidence inputs.

Request

string
required
Company name to validate. Must be 2–200 characters.

Response

boolean
true if BETA resolved the input. Always check resolution.confidence alongside this — verified: true with low confidence means a fuzzy/fallback match, not a confident one.
number
Confidence score (0–1) for the entity match.
object
Canonical entity record. null when verified: false.
object
Provenance metadata — see Citation Contract.
string | null
Present when verified: false — explanation, e.g., "Company not found in database".

Code samples

Live response

Errors

Citation pointer

See Citation Contract for how resolution.source and resolution.confidence are populated — and why verified: true with resolution.source: "sec_fallback" is not the same trust signal as resolution.source: "curated".