Skip to main content
POST
/
api
/
v1
/
people
POST /people
curl --request POST \
  --url https://api.getbeta.io/api/v1/people \
  --header 'Content-Type: application/json' \
  --data '
{
  "company": "<string>",
  "filters": {}
}
'
{
  "entity": {},
  "people": [
    {
      "person.name": "<string>",
      "person.role": {},
      "person.role_type": {},
      "person.is_current": true,
      "person.source_types": [
        {}
      ],
      "person.verified_count": 123,
      "person.last_seen": {}
    }
  ],
  "meta": {
    "meta.total_indexed": 123,
    "meta.coverage_note": "<string>",
    "meta.resolution": {}
  }
}

​
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

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

​
Response

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

​
Code samples

curl -X POST https://api.getbeta.io/api/v1/people \
  -H "Authorization: Bearer $BETA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company": "Anthropic"}'

​
Live response (truncated)

{
  "entity": { "key": "anthropic", "name": "Anthropic" },
  "people": [
    {
      "name": "Dario Amodei",
      "role": "CEO",
      "role_type": "executive",
      "is_current": true,
      "source_types": ["news_mention"],
      "verified_count": 17,
      "last_seen": "2026-03-18"
    },
    {
      "name": "Chris Liddell",
      "role": "Board member (former Microsoft CFO)",
      "role_type": "executive",
      "is_current": true,
      "source_types": ["news_mention"],
      "verified_count": 1,
      "last_seen": "2026-02-14"
    },
    {
      "name": "Irina Ghose",
      "role": "Managing Director of India",
      "role_type": "executive",
      "is_current": true,
      "source_types": ["news_extraction"],
      "verified_count": 18,
      "last_seen": "2026-02-19"
    }
  ],
  "meta": {
    "total_indexed": 15,
    "coverage_note": "People index covers SEC-filed executives, board members, and news-mentioned individuals. Mid-level roles are not indexed.",
    "resolution": { "source": "curated", "confidence": 1 }
  }
}
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

StatusBodyWhen
404{"error": "Company not found", "code": "NOT_FOUND"}No entity resolved
OtherSee /validate for the standard set

​
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.