# Directors and Board Members API Reference | SEC API

> Complete API reference for the SEC Directors and Board Members Data API. Every request parameter, every searchable field and every response attribute, with types, constraints and a live example response.

Source: https://sec-api.io/api-reference/directors-board-members

Company and governance data

POST`https://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 →](https://sec-api.io/docs/directors-and-board-members-data-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.

| Field | Description |
| --- | --- |
| `id` | Unique identifier of the record |
| `accessionNo` | Filing accession number the directors were extracted from |
| `filedAt` | Disclosure date / time |
| `cik` | CIK of the company or entity |
| `ticker` | Ticker symbol of the company (empty for unlisted entities) |
| `entityName` | Legal name of the company or entity |
| `directors.name` | Director name |
| `directors.position` | Director position / title (e.g. "Lead Independent Director") |
| `directors.age` | Director age |
| `directors.directorClass` | Director class — "I", "II", "III", etc. |
| `directors.dateFirstElected` | Date the director was first elected |
| `directors.isIndependent` | Director independence status (true / false / null) |
| `directors.committeeMemberships` | Committee memberships, e.g. "Audit Committee" |
| `directors.qualificationsAndExperience` | Free-text qualifications and prior experience |

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

directors: array of object

The directors and board members associated with the company or entity, as reported by the filing.

name: string

Name of the director.

position: string

Positions or titles of the director, for example President, Chief Executive Officer and Director.

age: string

Age of the director, for example 65.

directorClass: string

Class of the director, for example I, II or III. Empty when the filing reports no class.

dateFirstElected: string

Date the director was first elected, for example 2020 or November 2019.

isIndependent: boolean

Whether the director is independent. Null when the filing does not state the independence status.

committeeMemberships: array of string

Committees the director sits on, for example Audit Committee and Compliance Committee.

qualificationsAndExperience: array of string

Qualifications and prior experience of the director, for example Chairman, Somerset & Company and Managing Director, The Carlyle Group.

## Status codes

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

## Request example

POST https://api.sec-api.io/directors-and-board-members

```json
{
  "query": "ticker:AAPL",
  "from": "0",
  "size": "1",
  "sort": [{ "filedAt": { "order": "desc" } }]
}
```

```python
from sec_api import DirectorsBoardMembersApi

directorsBoardMembersApi = DirectorsBoardMembersApi("YOUR_API_KEY")

response = directorsBoardMembersApi.get_data({
    "query": "ticker:AAPL",
    "from": "0",
    "size": "1",
    "sort": [{"filedAt": {"order": "desc"}}],
})
```

```javascript
import { directorsBoardMembersApi } from "sec-api";

directorsBoardMembersApi.setApiKey("YOUR_API_KEY");

const response = await directorsBoardMembersApi.getData({
  query: "ticker:AAPL",
  from: "0",
  size: "1",
  sort: [{ filedAt: { order: "desc" } }],
});
```

```bash
curl -X POST https://api.sec-api.io/directors-and-board-members \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "ticker:AAPL",
    "from": "0",
    "size": "1",
    "sort": [{ "filedAt": { "order": "desc" } }]
  }'
```

## Response example

200 OK · application/json

```json
{
  "total": {
    "value": 20,
    "relation": "eq"
  },
  "data": [
    {
      "id": "42fe18db08211769589dc61fbd461443",
      "filedAt": "2026-01-08T16:31:36-05:00",
      "accessionNo": "0001308179-26-000008",
      "cik": "320193",
      "ticker": "AAPL",
      "entityName": "Apple Inc.",
      "directors": [
        {
          "name": "Alex Gorsky",
          "position": "Former Chair and CEO, Johnson & Johnson; Director",
          "age": "65",
          "directorClass": "II",
          "dateFirstElected": "2021",
          "isIndependent": false,
          "committeeMemberships": [
            "Nominating Committee",
            "People and Compensation Committee"
          ],
          "qualificationsAndExperience": [
            "executive leadership experience",
            "brand marketing expertise",
            "experience in health and technology"
          ]
        },
        {
          "name": "Andrea Jung",
          "position": "President and CEO, Grameen America; Director",
          "age": "67",
          "directorClass": "I",
          "dateFirstElected": "2008",
          "isIndependent": null,
          "committeeMemberships": [
            "Nominating Committee",
            "People and Compensation Committee (Chair)"
          ],
          "qualificationsAndExperience": [
            "executive leadership experience",
            "global business perspective",
            "extensive brand marketing and consumer products experience",
            "service as a chair and chief executive officer of a large international public company"
          ]
        },
        {
          "name": "Tim Cook",
          "position": "CEO; Chief Executive Officer",
          "age": "65",
          "directorClass": "",
          "dateFirstElected": "2011",
          "isIndependent": null,
          "committeeMemberships": [],
          "qualificationsAndExperience": [
            "extensive executive leadership experience in the technology industry",
            "management of worldwide operations",
            "sales, service, and support"
          ]
        },
        {
          "name": "Wanda Austin",
          "position": "Former President and CEO, The Aerospace Corporation; Director",
          "age": "71",
          "directorClass": "I",
          "dateFirstElected": "2024",
          "isIndependent": true,
          "committeeMemberships": [
            "Audit Committee"
          ],
          "qualificationsAndExperience": [
            "executive leadership experience",
            "expertise in advanced technology and innovation",
            "experience with environment, cybersecurity, and public policy",
            "global business perspective"
          ]
        }
      ]
    }
  ]
}
```