Company and governance data

Directors and Board Members

POSThttps://api.sec-api.io/directors-and-board-members

Search current and historical directors and board members of public companies and unlisted entities such as funds and trusts. Each record carries the name, position, age, director class, date of first election, independence status, committee memberships and qualifications of every director reported by one filing, covering 2007 to present.

Read the guide for this API →

Authentication

Send the API key either as a header or as a query parameter. The header is preferred; the query parameter exists for cases where a header cannot be set, such as opening a URL directly in a browser.

Authorization: required header

The API key on its own. Do not prefix it with Bearer or any other word.

Example Authorization: YOUR_API_KEY

token: optional query parameter

The API key, appended to the URL. Use this only when a header is not possible.

Request body

A JSON object. Content-Type must be application/json.

query: required string

The search expression in Lucene syntax, written as field:value. Every field listed under Searchable fields can be used, combined with AND, OR, NOT, ranges and wildcards.

Example ticker:AAPL

from: string, Maximum 10000

Index of the first result to return, used for pagination. Increment by the value of size to page through results.

Default "0"

size: string, Maximum 50

Number of disclosure records to return in one response.

Default "50"

sort: array of object

Sort order. Each item maps one field to an order object, for example [{ "filedAt": { "order": "desc" } }].

Default [{ "filedAt": { "order": "desc" } }]

order: string

Either asc or desc.

Searchable fields

Every field below can be used inside query. 14 fields are searchable, and they match the structure of the objects returned in the response.

FieldDescription
idUnique identifier of the record
accessionNoFiling accession number the directors were extracted from
filedAtDisclosure date / time
cikCIK of the company or entity
tickerTicker symbol of the company (empty for unlisted entities)
entityNameLegal name of the company or entity
directors.nameDirector name
directors.positionDirector position / title (e.g. "Lead Independent Director")

Response

A JSON object. Nested attributes are collapsed; expand one to see its fields.

total: object

How many disclosure records matched the query.

value: integer

Number of matching records.

relation: string

Either eq, meaning value is exact, or gte, meaning value is a floor.

data: array of object

The matching records, at most size per response. One record holds the board of one company as reported by one filing. Every field of a record is itself searchable.

id: string

Unique identifier of the record in the dataset.

filedAt: string

Date and time the information was disclosed with the SEC, ISO 8601 in Eastern Time.

accessionNo: string

Accession number of the filing the information was extracted from, for example 0001308179-26-000008.

cik: string

Central Index Key (CIK) of the company or entity the directors are associated with.

ticker: string

Ticker symbol of the company or entity. Empty when the entity is not listed on a stock exchange.

entityName: string

Name of the company or entity, for example Apple Inc.

Status codes

200Success. The response holds total and data.
400The request body could not be parsed, or the Lucene expression in query is malformed.
403The API key is missing, or it is not valid.
429Too many requests. Slow the request rate and retry.
500Server error. Retry, and report it if it persists.