Skip to main content
POST
/
api
/
v1
/
enrich
POST /enrich
curl --request POST \
  --url https://api.getbeta.io/api/v1/enrich \
  --header 'Content-Type: application/json' \
  --data '
{
  "company": "<string>",
  "tenure": {},
  "include": [
    {}
  ]
}
'
{
  "verified": true,
  "confidence": 123,
  "entity": {},
  "scale": {},
  "context": {},
  "headlineInsight": {},
  "events": [
    {}
  ],
  "people": [
    {}
  ],
  "intelligence": {},
  "intelligence_history": {},
  "meta": {}
}

​
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

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

​
Response

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

​
Code samples

curl -X POST https://api.getbeta.io/api/v1/enrich \
  -H "Authorization: Bearer $BETA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company": "Stripe", "include": ["events"]}'

​
Live response

{
  "verified": true,
  "confidence": 1,
  "entity": {
    "key": "stripe",
    "name": "Stripe Inc.",
    "type": "private_company",
    "ticker": null,
    "industry": "financial_services",
    "publicUrl": "https://getbeta.io/company/stripe"
  },
  "scale": {},
  "context": "Stripe published its 2025 annual letter and announced a tender offer to provide liquidity to current and former employees [11]. The company completed its acquisition of Metronome, expanding its platform capabilities [6]. Stripe powered Higgsfield's global expansion and marketplace launch, demonstrating continued adoption across commerce platforms [5]...",
  "events": [],
  "people": [],
  "meta": {
    "enrichedAt": "2026-05-20T03:49:30.379Z",
    "sources": ["entity_resolution", "entity_summaries"],
    "resolution": { "source": "curated", "confidence": 1 },
    "costEstimate": 0.008
  }
}
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

StatusBodyWhen
400{"error": "Ambiguous company name", "code": "NEEDS_DISAMBIGUATION", "alternatives": [...]}Multiple entities matched
404{"verified": false, "error": "Company not found", "code": "NOT_FOUND"}No entity resolved
OtherSee /validate for the standard set

​
Citation pointer

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