Governance Flags

GET/api/executives/governance

Returns corporate governance flags related to executive compensation practices, extracted from DEF 14A proxy statements.

These flags reveal important governance characteristics around insider trading and compensation award timing:

Flag	What it means
`insiderTradingPolicy`	Whether the company has formally adopted insider trading policies and procedures
`mnpiConsideredInAwardTiming`	Whether the company considers Material Non-Public Information (MNPI) when timing equity award grants — a "true" response indicates the company is aware of the optics around granting awards before material announcements
`awardTimingPredetermined`	Whether equity award grant dates are predetermined (e.g., on a fixed schedule) rather than discretionary — predetermined timing reduces the risk of "spring-loading" awards
`mnpiDisclosureTimedForComp`	Whether the company times MNPI disclosures to affect compensation valuations — a "true" flag is a potential governance concern

Data source: SEC XBRL-tagged DEF 14A filings.

Get API key Try it live in the API explorer

Query parameters

symbol string optional min length 1 · max length 10

Stock ticker symbol. Identify the entity by exactly one of: symbol, cik, cusip, composite_figi, or share_class_figi. At least one is required.

Example: AAPL
cik integer optional

SEC Central Index Key (CIK).

Example: 320193
cusip string optional min length 9 · max length 9

CUSIP identifier (9 characters).

Example: 037833100
composite_figi string optional

Composite OpenFIGI identifier.

Example: BBG000B9XRY4
share_class_figi string optional

Share-class OpenFIGI identifier.

Example: BBG001S5N8V8

Example request

curl 'https://api.stockfit.io/v1/api/executives/governance?symbol=AAPL&cik=320193&cusip=037833100&composite_figi=BBG000B9XRY4&share_class_figi=BBG001S5N8V8' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Governance flags (null if no DEF 14A governance data available)

Response schema

insiderTradingPolicy boolean | null
Whether insider trading policies and procedures are adopted
mnpiConsideredInAwardTiming boolean | null
Whether MNPI is considered when timing equity award grants
awardTimingPredetermined boolean | null
Whether equity award timing is predetermined
mnpiDisclosureTimedForComp boolean | null
Whether MNPI disclosure is timed to affect compensation valuation

Example response

{
  "insiderTradingPolicy": true,
  "mnpiConsideredInAwardTiming": false,
  "awardTimingPredetermined": true,
  "mnpiDisclosureTimedForComp": false
}

400 Bad Request

Invalid parameters or company not found

Response schema

error string
Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

error string
Human-readable error message

Example response

{}