# Institutional holdings filings (13F-HR)

**Use case:** 

Form 13F-HR filings, which institutional managers file quarterly to disclose their US equity holdings. Berkshire Hathaway is included by CIK as well as ticker, because the SEC maps two share-class tickers to that one company.

## Input

```json
{
  "companies": [
    "BRK-B",
    "1067983"
  ],
  "forms": [
    "13F-HR"
  ],
  "includeFullHistory": true,
  "filedSince": "",
  "filedUntil": "",
  "maxFilingsPerCompany": 60,
  "maxRetries": 4
}
```

## Output

```json
{
  "companyName": {
    "label": "Company Name",
    "format": "string"
  },
  "tickers": {
    "label": "Tickers",
    "format": "array"
  },
  "cik": {
    "label": "Cik",
    "format": "string"
  },
  "form": {
    "label": "Form",
    "format": "string"
  },
  "filingDate": {
    "label": "Filing Date",
    "format": "string"
  },
  "reportDate": {
    "label": "Report Date",
    "format": "string"
  },
  "accessionNumber": {
    "label": "Accession Number",
    "format": "string"
  },
  "primaryDocDescription": {
    "label": "Primary Doc Description",
    "format": "string"
  },
  "documentUrl": {
    "label": "Document Url",
    "format": "string"
  },
  "items": {
    "label": "Items",
    "format": "string"
  },
  "sizeBytes": {
    "label": "Size Bytes",
    "format": "integer"
  },
  "isXBRL": {
    "label": "Is X B R L",
    "format": "boolean"
  },
  "filingSource": {
    "label": "Filing Source",
    "format": "string"
  },
  "sicDescription": {
    "label": "Sic Description",
    "format": "string"
  },
  "exchanges": {
    "label": "Exchanges",
    "format": "array"
  },
  "status": {
    "label": "Status",
    "format": "string"
  },
  "note": {
    "label": "Note",
    "format": "string"
  },
  "source": {
    "label": "Source",
    "format": "string"
  },
  "sicCode": {
    "label": "Sic Code",
    "format": "string"
  },
  "entityType": {
    "label": "Entity Type",
    "format": "string"
  },
  "stateOfIncorporation": {
    "label": "State Of Incorporation",
    "format": "string"
  },
  "fiscalYearEnd": {
    "label": "Fiscal Year End",
    "format": "string"
  },
  "acceptanceDateTime": {
    "label": "Acceptance Date Time",
    "format": "string"
  },
  "act": {
    "label": "Act",
    "format": "string"
  },
  "fileNumber": {
    "label": "File Number",
    "format": "string"
  },
  "primaryDocument": {
    "label": "Primary Document",
    "format": "string"
  },
  "filingIndexUrl": {
    "label": "Filing Index Url",
    "format": "string"
  },
  "isInlineXBRL": {
    "label": "Is Inline X B R L",
    "format": "boolean"
  },
  "checkedAt": {
    "label": "Checked At",
    "format": "string"
  }
}
```

## About this Actor

This example demonstrates how to use [SEC EDGAR Filings Scraper & API - 10-K, 10-Q, 8-K by Ticker](https://apify.com/neverempty/sec-edgar-filings.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/neverempty/sec-edgar-filings.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
This Task's input is already configured above — use it as-is rather than inventing a new one.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/neverempty/sec-edgar-filings.md

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
