Skip to main content
POST
POST /people

Use case

Get the indexed-people list for a company — executives, board members, founders, investors. The index covers SEC-filed individuals and news-mentioned individuals; mid-career and individual-contributor roles are not indexed by design. When you query a role type that isn’t covered, BETA returns sparse results with an explicit coverage_note — see Citation Contract.

Request

string
required
Company name or entity key. 2–200 characters.
object
Narrow the result set:

Response

object
Resolved entity (key, name).
array
Up to 25 person records, ordered by role priority (CEO → President → CFO → CTO → COO → others) then by verified_count.
object

Code samples

Live response (truncated)

Deduplication caveat: news-extraction sources occasionally produce multiple records for the same person with slightly different role text (e.g., "CEO" and "Chief (CEO)"). Treat them as one person; dedupe on name (or normalized name) + role_type in your consumer.

Errors

Citation pointer

When people: [] or sparse, read meta.coverage_note — that’s BETA’s explicit declaration of what the index doesn’t cover. See Citation Contract → What BETA refuses to assert.