Skip to main content
POST
POST /enrich

Use case

After resolving an entity with /validate, call /enrich for the full BETA picture: firmographics, market cap, headline insight, optionally SWOT + competitors + priorities (include: ['intelligence']), events during a tenure window (include: ['events'] with tenure), key people inline (include: ['people']), or historical intelligence snapshots (include: ['intelligence_history']).

Request

string
required
Company name or canonical entity key. 2–200 characters.
object
When present, scopes events to a window: { "start": "YYYY-MM", "end": "YYYY-MM" }.
array
Subset of ["events", "people", "intelligence", "intelligence_history"].

Response

boolean
Same semantics as /validate.
number
Entity-match confidence (0–1).
object
Canonical entity. Extends /validate’s entity with exchange, headquarters, founded, employees, description.
object
Where available: marketCap (formatted, e.g., "$1.2T"), revenueRange (e.g., "$10B+").
string | null
Display summary — synthesized 2–4 paragraph briefing on the company. News-corroborated, source-cited inline as [N] footnote markers.
string | null
Short (~1 sentence) insight surfaced from the latest synthesis run.
array
Material events (SEC 8-K filings) — populated when include: ['events'] and tenure is provided.
array
Indexed people — populated when include: ['people']. See /people for full schema.
object | null
SWOT, competitors, priorities, changelog, confidence — populated when include: ['intelligence'].
object | null
Temporal snapshots (up to 30) — populated when include: ['intelligence_history'].
object
enrichedAt (ISO datetime), sources (array of structured datasets used), resolution (per Citation Contract), costEstimate (USD).

Code samples

Live response

Private companies (like Stripe) often have no SEC events — events: [] is expected, not an error. Public companies return populated arrays when include: ['events'] is set.

Errors

Citation pointer

See Citation Contract for how meta.sources[], intelligence.competitors[*].source, and the [N] footnote markers in context are populated.