# Ownership

> Schedule 13D and 13G filings by a company's large shareholders, one record per reporting owner.

```text
GET /v1/companies/{id}/ownership
```

The beneficial owners that reported a large stake in a company on Schedule 13D or 13G, newest filing first. Each record is one reporting owner on one filing.

```bash
curl -H "X-API-Key: $BELFORT_API_KEY" \
  "https://belfort-data-api.vercel.app/v1/companies/AAPL/ownership?form=SCHEDULE%2013G"
```

## Parameters

| Parameter | Values | Default |
|---|---|---|
| `form` | `SCHEDULE 13D`, `SCHEDULE 13G`, `SCHEDULE 13D/A` or `SCHEDULE 13G/A`. | All |
| `limit` | 1–100 records. | 20 |

This route doesn't page.

## One record

| Field | Meaning |
|---|---|
| `issuer_cik` | The company. |
| `owner_name`, `owner_cik` | The reporting owner. |
| `form`, `filed`, `event_date` | The form, the day it was filed, and the date of the event that required it. |
| `shares`, `percent_of_class` | The amount owned and the percent of the class, **as filed text**. Blank is `null`, never 0. |
| `amendment_number`, `prior_accession` | For an amendment, its number and the earlier filing it names, when present. |
| `accession`, `filing_url` | The filing, and its page on EDGAR. |

## What to expect

- **Structured filings from 2024-12-18 only.** That's when the SEC began requiring Schedules 13D and 13G in a structured format. Older text filings aren't covered.
- **Co-owners are separate records.** Several owners on one filing each get a record. Don't add their shares together as if they were separate holdings.
- **Amounts are text.** `shares` and `percent_of_class` are kept exactly as filed, so parse them yourself.

---
Source: https://docs.belfortagent.xyz/datasets/ownership/