> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# SEC Beneficial Ownership API

> SEC Schedule 13D and 13G beneficial ownership filings with issuer name, CIK, CUSIP and securities class. Pass US tickers (SEC filers only).

`POST /v1/data/sec/beneficial-ownership/run`

**Pricing:** $0.01 per filing ($10.00 per 1,000).

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**tickers** `string[]` *required*

One or more US stock tickers, e.g. AAPL or BRK-B. SEC data covers US-listed companies only: non-US listings (RELIANCE.NS) and market indices (NIFTY, SENSEX) are refused with a clear error. One request reads them all.

**lookbackDays** `integer` (default: 365)

Lookback Days as a whole number.

Min `1`; max `3650`.

**scheduleType** `string` (default: all)

Schedule Type to use. Both 13D and 13G by default.

Allowed values: `all` (Both 13D and 13G), `13D` (Only 13D (activist)), `13G` (Only 13G (passive)).

**minPercent** `integer` (default: 0)

Min Percent as a whole number.

Min `0`; max `100`.

**maxResults** `integer` (default: 10)

How many filings to return in total. Defaults to 10; use 0 for all.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/sec/beneficial-ownership/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "tickers": [
      "AAPL",
      "GME",
      "TSM"
    ],
    "lookbackDays": 730,
    "scheduleType": "all",
    "minPercent": 0,
    "maxResults": 3
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/sec/beneficial-ownership/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "tickers": [
        "AAPL",
        "GME",
        "TSM"
    ],
    "lookbackDays": 730,
    "scheduleType": "all",
    "minPercent": 0,
    "maxResults": 3
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/sec/beneficial-ownership/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "tickers": [
    "AAPL",
    "GME",
    "TSM"
  ],
  "lookbackDays": 730,
  "scheduleType": "all",
  "minPercent": 0,
  "maxResults": 3
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one filing, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `accessionNumber` | Accession Number | text |
| `ticker` | Ticker | text |
| `issuerName` | Issuer Name | text |
| `issuerCik` | Issuer Cik | text |
| `issuerCusip` | Issuer Cusip | text |
| `securitiesClass` | Securities Class | text |
| `scheduleType` | Schedule Type | text |
| `isAmendment` | Is Amendment | boolean |
| `filerName` | Filer Name | text |
| `filerType` | Filer Type | text |
| `sharesOwned` | Shares Owned | number |
| `percentOfClass` | Percent Of Class | percentage |
| `soleVotingPower` | Sole Voting Power | number |
| `sharedVotingPower` | Shared Voting Power | number |
| `eventDate` | Event Date | date |
| `filingDate` | Filing Date | date |
| `purpose` | Purpose | text |
| `sourceOfFunds` | Source Of Funds | text |
| `recentTransactions` | Recent Transactions | text |
| `agreements` | Agreements | text |
| `rule13d1` | Rule 13d 1 | text |
| `reportingPersonCount` | Reporting Person Count | number |
| `reportingPersons` | Reporting Persons | object\_array |
| `filingUrl` | Filing URL | url |
| `documentUrl` | Document URL | url |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "sec/beneficial-ownership",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "securitiesClass": "Common Stock",
      "filerType": "Investment adviser",
      "agreements": null,
      "reportingPersonCount": 1,
      "issuerName": "Apple Inc",
      "accessionNumber": "0002100119-26-000139",
      "soleVotingPower": 145321305,
      "issuerCik": "0000320193",
      "scheduleType": "13G",
      "eventDate": "2026-03-31",
      "filingUrl": "https://www.sec.gov/Archives/edgar/data/320193/000210011926000139/0002100119-26-000139-index.htm",
      "sharedVotingPower": 0,
      "filingDate": "2026-04-29",
      "issuerCusip": "037833100",
      "purpose": null,
      "documentUrl": "https://www.sec.gov/Archives/edgar/data/320193/000210011926000139/primary_doc.xml",
      "rule13d1": "Rule 13d-1(b)",
      "percentOfClass": 7.48,
      "filerName": "Vanguard Capital Management",
      "ticker": "AAPL",
      "reportingPersons": [
        {
          "name": "Vanguard Capital Management",
          "cik": null,
          "citizenshipOrOrganization": "PA",
          "type": "Investment adviser",
          "typeCodes": [
            "IA"
          ],
          "sourceOfFunds": null,
          "soleVotingPower": 145321305,
          "sharedVotingPower": 0,
          "soleDispositivePower": 1099168953,
          "sharedDispositivePower": 0,
          "sharesOwned": 1099168953,
          "percentOfClass": 7.48,
          "memberOfGroup": null
        }
      ],
      "sharesOwned": 1099168953,
      "sourceOfFunds": null,
      "recentTransactions": null,
      "isAmendment": false
    }
  ]
}
```

## Related APIs

For officer and director trades use [`sec/insider-trades`](https://docs.mindcase.co/apis/sec/insider-trades); for the full filing index use [`sec/filings`](https://docs.mindcase.co/apis/sec/filings).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.