# beatandraise.com SEC Filings API

> The SEC EDGAR archive (every filing since 1993, about 18.8 million) and structured data built on it: documents as text, 10-K/10-Q/8-K Items, XBRL financial statements, insider transactions, 13F holders, shares outstanding, every field of every SEC XML form, and tools to verify figures and quotes against the filing.

Base URL: https://beatandraise.com/api/v1. Authenticate with `X-API-Key: <key>` or `Authorization: Bearer <key>`; create a free key at https://beatandraise.com/api-keys. Free plan: 100 successful requests, 10 a second. Pro: unlimited requests, 20 a second (https://beatandraise.com/sec-filings-api#plans).

## How to use it well

- Find a company's CIK first: GET /company/search?q=apple. Send CIKs with or without leading zeros.
- For one section of a 10-K, 10-Q or 8-K (Risk Factors, MD&A, Item 2.02) use /items, not the whole document: it is a fraction of the size and is never the table of contents.
- Before stating a figure from a filing, check it with /document/verify-figure (digits are compared however they are written: "$416.2 billion" matches 416,161 in millions); before quoting text, /document/verify. Cite the highlight_url they return: it opens the filing with those exact characters marked.
- To check a whole draft: put [ref:<ref>] after each figure (refs come from /document/figures and verify-figure), [calc: ref:a, ref:b] after a computed one, and POST it to /check-citations. Present its linked_text; a citation that fails is marked unverified.
- Every result drawn from a filing carries a source object (sec_url, filing_index_url, beatandraise_url, citation). Cite those links, not your memory.
- Data is as filed: values, form types and categories are the SEC's own. Share counts are never split-adjusted; 13F values are in the filer's unit; report each share class on its own.
- Errors are JSON {"error": "<code>", "message": "..."}. 401: get a key at https://beatandraise.com/api-keys. 402: the free plan's calls are used. 429: wait Retry-After seconds. A non-2xx response does not use a free call.

## Filings

- GET /filings: List filings by company, form and date
- GET /filing/{accession}: One filing: metadata and every file
- GET /filing/{accession}/tables: The XBRL financial-table pages of a filing
- GET /files/{accession}: The files a filing lists, with download links
- GET /files/{accession}/{filename}: Download one file exactly as stored
- GET /search: Full-text search across filings

## Documents

- GET /document/{cik}/{accession}/{filename}: A document as markdown or HTML
- GET /items/{accession}: The Items of a 10-K, 10-Q or 8-K
- GET /items/{accession}/{item}: One Item of a 10-K, 10-Q or 8-K
- GET /document/search/{cik}/{accession}: Search inside a filing
- GET /document/search/{cik}/{accession}/{filename}: Search inside one document

## Structured data

- GET /form-data: Every filing of an XML form, every field
- GET /statements/{cik}/{accession}: Financial statements of one 10-K or 10-Q
- GET /financial-history: Statements from a company's last several reports
- GET /get-statements: Experimental: a statement period by period
- GET /insider-transactions: Form 4 insider transactions
- GET /insiders: In development: insider trading totals
- GET /shares-outstanding: Shares outstanding over time, and splits
- GET /holdings/{cik}: A 13F manager's positions
- GET /institutional-holders/{company}: Who holds a company (13F)
- GET /company/search: Find a company by name or ticker
- GET /company/{cik}: A company: names, tickers, industry
- GET /sic: SIC industry codes and their companies

## Checking figures and quotes

- GET /document/verify/{cik}/{accession}/{filename}: Is this sentence or figure in the document?
- GET /document/verify-figure/{cik}/{accession}: Is this number in the filing, however written?
- GET /document/verify-figure/{cik}/{accession}/{filename}: As above, in one document
- GET /document/figures/{cik}/{accession}/{filename}: Every number in a document, with its label
- POST /check-citations: Check every cited number in a draft

## Account

- GET /account: Your plan, limits and usage this month
- GET /status: Service status

## Docs

- [Every endpoint in full, with parameters and example responses](https://beatandraise.com/llms-full.txt)
- [OpenAPI 3.1 specification](https://beatandraise.com/api/v1/openapi.json): import into an agent, Postman or a client generator
- [Try it in the browser](https://beatandraise.com/public-api/try)
- [Documentation](https://beatandraise.com/public-api): field-by-field pages for every SEC XML form and the Items of 10-K, 10-Q and 8-K

## Optional

- [MCP server](https://beatandraise.com/mcp): the same data as tools for Claude, ChatGPT and Codex, no code
- [Plans and terms](https://beatandraise.com/sec-filings-api#plans)


# Endpoints

## Filings

### GET /filings

List filings by company, form and date. Filing metadata, newest first, deduplicated per accession. Each filing's content_object lists its files (filename, doc_type, sequence; sequence 1 is the primary document) and every file has a source with its sec.gov and beatandraise.com links. 8-Ks carry their items ("2.02 Results of Operations…") and, when the press release has one, a headline. Without cik, from defaults to 30 days before to.

Parameters:

- cik (query, string, optional): CIK, 10 digits with or without leading zeros.
- form (query, string, optional): Form type as filed ("10-K", "8-K", "4", "13F-HR", "S-1"), or up to 20 comma-separated ("10-K,10-K/A"). Amendments are their own form types.
- from (query, string, optional): Earliest date, YYYY-MM-DD.
- to (query, string, optional): Latest date, YYYY-MM-DD.
- limit (query, integer, optional, default 100): Results per call (1-1000, default 100).
- offset (query, integer, optional, default 0): Pagination offset.

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/filings?cik=0000320193&form=10-K&from=2024-01-01"
```

Example response (application/json, arrays cut to two items):

```
{
 "count": 2,
 "filings": [
  {
   "accession_number": "0000320193-25-000079",
   "cik": "0000320193",
   "company_name": "Apple Inc.",
   "content_object": [
    {
     "description": "10-K",
     "doc_type": "10-K",
     "filename": "aapl-20250927.htm",
     "markdown_exists": 1,
     "sequence": "1",
     "source": {
      "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm",
      "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
      "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/aapl-20250927.htm"
     },
     "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm"
    },
    {
     "description": "EX-4.1",
     "doc_type": "EX-4.1",
     "filename": "a10-kexhibit4109272025.htm",
     "markdown_exists": 1,
     "sequence": "2",
     "source": {
      "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/a10-kexhibit4109272025.htm",
      "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
      "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/a10-kexhibit4109272025.htm"
     },
     "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/a10-kexhibit4109272025.htm"
    }
   ],
   "filename": "edgar/data/320193/0000320193-25-000079.txt",
   "filing_date": "2025-10-31T00:00:00Z",
   "form": "10-K",
   "source": {
    "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm",
    "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
    "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/aapl-20250927.htm",
    "citation": "Apple Inc., Form 10-K, filed 2025-10-31, https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm"
   }
  },
  {
   "accession_number": "0000320193-24-000123",
   "cik": "0000320193",
   "company_name": "Apple Inc.",
   "content_object": [
    {
     "description": "10-K",
     "doc_type": "10-K",
     "filename": "aapl-20240928.htm",
     "markdown_exists": 1,
     "sequence": "1",
     "source": {
      "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm",
 
…
```

### GET /filing/{accession}

One filing: metadata and every file. The filing's metadata and content_object (every document, exhibit, XBRL page and image), with source links.

Parameters:

- accession (path, string, required): SEC accession number, as 0000320193-25-000079.

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/filing/0000320193-25-000079"
```

Example response (application/json, arrays cut to two items):

```
{
 "accession_number": "0000320193-25-000079",
 "cik": "0000320193",
 "company_name": "Apple Inc.",
 "content_object": [
  {
   "description": "10-K",
   "doc_type": "10-K",
   "filename": "aapl-20250927.htm",
   "markdown_exists": 1,
   "sequence": "1",
   "source": {
    "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm",
    "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
    "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/aapl-20250927.htm"
   },
   "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm"
  },
  {
   "description": "EX-4.1",
   "doc_type": "EX-4.1",
   "filename": "a10-kexhibit4109272025.htm",
   "markdown_exists": 1,
   "sequence": "2",
   "source": {
    "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/a10-kexhibit4109272025.htm",
    "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
    "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/a10-kexhibit4109272025.htm"
   },
   "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/a10-kexhibit4109272025.htm"
  }
 ],
 "filename": "edgar/data/320193/0000320193-25-000079.txt",
 "filing_date": "2025-10-31T00:00:00Z",
 "form": "10-K",
 "source": {
  "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm",
  "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
  "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/aapl-20250927.htm",
  "citation": "Apple Inc., Form 10-K, filed 2025-10-31, https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm"
 }
}
```

### GET /filing/{accession}/tables

The XBRL financial-table pages of a filing. One entry per R-page in the filing's FilingSummary.xml (cover, statements, notes, details) with its filename, title and a keyword type (xbrl_role_normalized: income_statement, balance_sheet, cash_flow…). Empty for filings without XBRL. To know which page is which statement, /statements is more reliable.

Parameters:

- accession (path, string, required): SEC accession number, as 0000320193-25-000079.

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/filing/0000320193-25-000079/tables"
```

Example response (application/json, arrays cut to two items):

```
{
 "accession_number": "0000320193-25-000079",
 "count": 70,
 "tables": [
  {
   "cik": "0000320193",
   "filename": "R1.htm",
   "long_name": "0000001 - Document - Cover Page",
   "menu_category": "Cover",
   "position": 1,
   "report_type": "Sheet",
   "short_name": "Cover Page",
   "source": {
    "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/R1.htm",
    "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
    "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/R1.htm"
   },
   "xbrl_role": "http://www.apple.com/role/CoverPage",
   "xbrl_role_normalized": "cover"
  },
  {
   "cik": "0000320193",
   "filename": "R2.htm",
   "long_name": "0000002 - Document - Auditor Information",
   "menu_category": "Cover",
   "position": 2,
   "report_type": "Sheet",
   "short_name": "Auditor Information",
   "source": {
    "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/R2.htm",
    "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
    "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/R2.htm"
   },
   "xbrl_role": "http://www.apple.com/role/AuditorInformation",
   "xbrl_role_normalized": null
  }
 ]
}
```

### GET /files/{accession}

The files a filing lists, with download links. Every file of the filing with its download_url (the endpoint below) and sec_url. Listing is a normal call; only downloads count against the download limits.

Parameters:

- accession (path, string, required): SEC accession number, as 0000320193-25-000079.

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/files/0000320193-25-000079"
```

Example response (application/json, arrays cut to two items):

```
{
 "accession_number": "0000320193-25-000079",
 "ciks": [
  "0000320193"
 ],
 "files": [
  {
   "filename": "aapl-20250927.htm",
   "doc_type": "10-K",
   "sequence": "1",
   "download_url": "/api/v1/files/0000320193-25-000079/aapl-20250927.htm",
   "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm"
  }
 ]
}
```

### GET /files/{accession}/{filename}

Download one file exactly as stored. Streams the file as filed (HTML, XML, PDF, image…). Append _markdown to an HTML or PDF filename for its stored text copy. Counts against the download limits (Free: 100 per 5 minutes, 1 GB a month; Pro: 10,000 a day, 50 GB a month). A file the filing lists but storage lacks is fetched again from sec.gov within minutes: retry.

Parameters:

- accession (path, string, required): SEC accession number, as 0000320193-25-000079.
- filename (path, string, required): A file of the filing, as its content_object or /files lists it.

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/files/0000320193-25-000079/aapl-20250927.htm"
```

Example response (application/octet-stream, arrays cut to two items):

```
<the file's bytes>
```

### GET /search

Full-text search across filings. Relevance-ranked search over filing documents since 2020 (Forms 3/4/5, 144, N-PORT, 13F and D are not indexed), with highlighted snippets and facets by form and year.

Parameters:

- q (query, string, required): Search words ("cybersecurity incident", "supply chain risk").
- form (query, string, optional): Only this form type.
- cik (query, string, optional): CIK, 10 digits with or without leading zeros.
- year (query, string, optional): Only this filing year.
- limit (query, integer, optional, default 20): Results per call (1-100, default 20).
- page (query, integer, optional, default 0): Page, from 0.

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/search?q=supply%20chain%20risk&form=10-K&cik=0000320193&year=2025"
```

Example response (application/json, arrays cut to two items):

```
{
 "facet_counts": {
  "facet_fields": {
   "cik": [
    "0001704715",
    8
   ],
   "form": [
    "10-K",
    4765
   ]
  },
  "facet_heatmaps": {},
  "facet_intervals": {},
  "facet_queries": {},
  "facet_ranges": {
   "filing_date": {
    "counts": [
     "2025-01-01T00:00:00Z",
     4765
    ],
    "end": "2028-01-01T00:00:00Z",
    "gap": "+1YEAR",
    "start": "2000-01-01T00:00:00Z"
   }
  }
 },
 "highlighting": {
  "0000723125_0000723125-25-000028_ex1032-iddfaamendmentno2.htm": {},
  "0000723125_0000723125-25-000028_ex1033-nydfaamendmentno2.htm": {}
 },
 "response": {
  "docs": [
   {
    "accession_number": "0000723125-25-000028",
    "cik": "0000723125",
    "company_names": [
     "MICRON TECHNOLOGY INC"
    ],
    "filename": "ex1033-nydfaamendmentno2.htm",
    "filing_date": "2025-10-03T00:00:00Z",
    "form": "10-K",
    "id": "0000723125_0000723125-25-000028_ex1033-nydfaamendmentno2.htm",
    "score": 32.202847,
    "source": {
     "sec_url": "https://www.sec.gov/Archives/edgar/data/723125/000072312525000028/ex1033-nydfaamendmentno2.htm",
     "filing_index_url": "https://www.sec.gov/Archives/edgar/data/723125/000072312525000028/0000723125-25-000028-index.htm",
     "beatandraise_url": "https://beatandraise.com/cik/0000723125/accessionNumber/0000723125-25-000028/ex1033-nydfaamendmentno2.htm",
     "citation": "MICRON TECHNOLOGY INC, Form 10-K, filed 2025-10-03, https://www.sec.gov/Archives/edgar/data/723125/000072312525000028/ex1033-nydfaamendmentno2.htm"
    }
   },
   {
    "accession_number": "0000723125-25-000028",
    "cik": "0000723125",
    "company_names": [
     "MICRON TECHNOLOGY INC"
    ],
    "filename": "ex1032-iddfaamendmentno2.htm",
    "filing_date": "2025-10-03T00:00:00Z",
    "form": "10-K",
    "id": "0000723125_0000723125-25-000028_ex1032-iddfaamendmentno2.htm",
    "score": 31.045588,
    "source": {
     "sec_url": "https://www.sec.gov/Archives/edgar/data/723125/000072312525000028/ex1032-iddfaamendmentno2.htm",
     "filing_index_url": "https://www.sec.gov/Archives/edgar/data/723125/000072312525000028/0000723125-25-000028-index.htm",
     "beatandraise_url": "https://beatandraise.com/cik/0000723125/accessionNumber/0000723125-25-000028/ex1032-iddfaamendmentno2.htm",
     "citation": "MICRON TECHNOLOGY INC, Form 10-K, filed 2025-10-03, https://www.sec.gov/Archives/edgar/data/723125/000072312525000028/ex1032-iddfaamendmentno2.htm"
    }
   }
  ],
  "maxScore": 32.202847,
  "numFound": 4765,
  "numFoundExact": true,
  "st
…
```

## Documents

### GET /document/{cik}/{accession}/{filename}

A document as markdown or HTML. The document's text, one paragraph, heading or table row per line (default), or the HTML as filed (get_markdown=false). Its links come in headers: X-Beatandraise-URL, X-Source-URL (sec.gov), X-Filing-Index-URL. Pass cik 0 to let the API find the CIK from the accession. For one section of a 10-K/10-Q/8-K use /items instead.

Parameters:

- cik (path, string, required): Company or filer CIK, 10 digits with leading zeros ("0000320193") or without ("320193").
- accession (path, string, required): SEC accession number, as 0000320193-25-000079.
- filename (path, string, required): A file of the filing, as its content_object or /files lists it.
- get_markdown (query, boolean, optional, default true): false for the HTML as filed.

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/document/0000320193/0000320193-25-000079/aapl-20250927.htm"
```

Example response (text/markdown, arrays cut to two items):

```
xml version='1.0' encoding='ASCII'?
XBRL Document Created with the Workiva Platform
Copyright 2025 Workiva
r:b93d322a-f6d3-4356-8a13-e3e1c42e12bd,g:44705cc3-5a3a-440a-975b-ed1d3694d858,d:719388195b384d85a4e238ad88eba90a
false
2025
FY
0000320193
P1Y
P1Y
P1Y
P1Y
http://fasb.org/us-gaap/2025#LongTermDebtNoncurrent
http://fasb.org/us-gaap/2025#LongTermDebtNoncurrent
http://fasb.org/us-gaap/2025#OtherAssetsNoncurrent
http://fasb.org/us-gaap/2025#OtherAssetsNoncurrent
http://fasb.org/us-gaap/2025#PropertyPlantAndEquipmentNet
http://fasb.org/us-gaap/2025#PropertyPlantAndEquipmentNet
http://fasb.org/us-gaap/2025#OtherLiabilitiesCurrent
http://fasb.org/us-gaap/2025#OtherLiabilitiesCurrent
http://fasb.org/us-gaap/2025#OtherLiabilitiesNoncurrent
http://fasb.org/us-gaap/2025#OtherLiabilitiesNoncurrent
http://fasb.org/us-gaap/2025#OtherLiabilitiesCurrent
http://fasb.org/us-gaap/2025#OtherLiabilitiesCurrent
http://fasb.org/us-gaap/2025#OtherLiabilitiesNoncurrent
http://fasb.org/us-gaap/2025#OtherLiabilitiesNoncurrent
iso4217:USD
xbrli:shares
iso4217:USD
xbrli:shares
xbrli:pure
aapl:Customer
aapl:Vendor
aapl:Subsidiary
0000320193
2024-09-29
2025-09-27
0000320193
us-gaap:CommonStockMember
2024-09-29
2025-09-27
0000320193
aapl:A0.000Notesdue2025Member
2024-09-29
2025-09-27
0000320193
aapl:A1.625NotesDue2026Member
2024-09-29
2025-09-27
0000320193
aapl:A2.000NotesDue2027Member
2024-09-29
2025-09-27
0000320193
aapl:A1.375NotesDue2029Member
2024-09-29
2025-09-27
0000320193
aapl:A3.050NotesDue2029
…
```

### GET /items/{accession}

The Items of a 10-K, 10-Q or 8-K. Which Items the filing has ("1A", "7", "2.02"), each with its part, the SEC's title, the heading as written, its length and a highlight_url marking the whole section. Found by the headings in the document, never the table of contents. not_located lists the form's items not found.

Parameters:

- accession (path, string, required): SEC accession number, as 0000320193-25-000079.

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/items/0000320193-25-000079"
```

Example response (application/json, arrays cut to two items):

```
{
 "accession_number": "0000320193-25-000079",
 "filename": "aapl-20250927.htm",
 "form": "10-K",
 "items": [
  {
   "part": "I",
   "item": "1",
   "title": "Business",
   "heading": "Business",
   "length": 16081,
   "highlight_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/aapl-20250927.htm?hl=21823,16081&src=mcp#br-hl-0"
  },
  {
   "part": "I",
   "item": "1A",
   "title": "Risk Factors",
   "heading": "Risk Factors",
   "length": 68462,
   "highlight_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/aapl-20250927.htm?hl=37904,68462&src=mcp#br-hl-0"
  }
 ],
 "not_located": [],
 "source": {
  "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm",
  "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
  "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/aapl-20250927.htm"
 }
}
```

### GET /items/{accession}/{item}

One Item of a 10-K, 10-Q or 8-K. The Item's text (markdown, or format=html). Headers: X-Item, X-Item-Title, X-Item-Part, X-Highlight-URL. If the heading was not found you get the text between the neighbouring items and X-Item-Approximate: true.

Parameters:

- accession (path, string, required): SEC accession number, as 0000320193-25-000079.
- item (path, string, required): A number ("1A", "7", "2.02") or a name ("Risk Factors", "MD&A"); URL-encode it.
- part (query, string, optional, one of I, II): 10-Q only: "I" or "II" when the number is in both parts.
- format (query, string, optional, one of html): html for the HTML fragment.

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/items/0000320193-25-000079/1A"
```

Example response (text/markdown, arrays cut to two items):

```
Item 1A.    Risk Factors
The following summarizes factors that could have a material adverse effect on the Company’s business, reputation, results of operations, financial condition and stock price. The Company may not be able to accurately predict, control or mitigate these risks. Statements in this section are based on the Company’s beliefs and opinions regarding matters that could materially adversely affect the Company in the future and are not representations as to whether such matters have or have not occurred previously. The risks and uncertainties described below are not exhaustive and should not be considered a complete statement of all potential risks or uncertainties that the Company faces or may face in the future.
This section should be read in conjunction with Part II, Item 7, “Management’s Discussion and Analysis of Financial Condition and Results of Operations” and the consolidated financial statements and accompanying notes in Part II, Item 8, “Financial Statements and Supplementary Data” of this Form 10-K.
Macroeconomic and Industry Risks
The Company’s operations and performance depend significantly on global and regional economic conditions and adverse economic conditions can materially adversely affect the Company’s business, results of operations, financial condition and stock price.
The Company has international operations with sales outside the U.S. representing a majority of the Company’s total net sales. In addition, the Company’s global supply chain 
…
```

### GET /document/search/{cik}/{accession}

Search inside a filing. Matching lines with context, across every readable document of the filing (main document and exhibits, up to 12). Comma-separated terms match any; a comma inside a number ("3,007") is kept. Each file carries its source.

Parameters:

- cik (path, string, required): Company or filer CIK, 10 digits with leading zeros ("0000320193") or without ("320193").
- accession (path, string, required): SEC accession number, as 0000320193-25-000079.
- q (query, string, required): Terms, comma-separated.
- context (query, integer, optional, default 10): Lines of context around each match (0-50, default 10).

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/document/search/0000320193/0000320193-25-000079?q=iPhone%20net%20sales"
```

Example response (application/json, arrays cut to two items):

```
{
 "accession_number": "0000320193-25-000079",
 "cik": "0000320193",
 "filename": "aapl-20250927.htm",
 "results": [
  {
   "lines": [
    {
     "line_number": 1271,
     "text": "iPhone",
     "is_match": false
    },
    {
     "line_number": 1272,
     "text": "iPhone net sales increased during 2025 compared to 2024 due to higher net sales of Pro models.",
     "is_match": true
    }
   ]
  }
 ],
 "search_terms": [
  "iphone net sales"
 ],
 "source": {
  "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm",
  "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
  "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/aapl-20250927.htm"
 },
 "total_lines": 2394,
 "total_matches": 1
}
```

### GET /document/search/{cik}/{accession}/{filename}

Search inside one document. As above, in one document.

Parameters:

- cik (path, string, required): Company or filer CIK, 10 digits with leading zeros ("0000320193") or without ("320193").
- accession (path, string, required): SEC accession number, as 0000320193-25-000079.
- filename (path, string, required): A file of the filing, as its content_object or /files lists it.
- q (query, string, required): Terms, comma-separated.
- context (query, integer, optional, default 10): Lines of context (0-50, default 10).

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/document/search/0000320193/0000320193-25-000079/aapl-20250927.htm?q=iPhone%20net%20sales"
```

Example response (application/json, arrays cut to two items):

```
{
 "accession_number": "0000320193-25-000079",
 "cik": "0000320193",
 "filename": "aapl-20250927.htm",
 "results": [
  {
   "lines": [
    {
     "line_number": 1271,
     "text": "iPhone",
     "is_match": false
    },
    {
     "line_number": 1272,
     "text": "iPhone net sales increased during 2025 compared to 2024 due to higher net sales of Pro models.",
     "is_match": true
    }
   ]
  }
 ],
 "search_terms": [
  "iphone net sales"
 ],
 "source": {
  "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm",
  "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
  "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/aapl-20250927.htm"
 },
 "total_lines": 2394,
 "total_matches": 1
}
```

## Structured data

### GET /form-data

Every filing of an XML form, every field. Every filing of one XML form type (Forms 3/4/5, 144, D, SCHEDULE 13D/13G, 13F-HR cover, N-CEN…) for a company or reporting person, newest first. format=json: SEC's element names and values as filed ("@name" attributes, repeated elements as arrays, "#order" keeps element order; compact=true drops it); the JSON converts back to the original XML (https://beatandraise.com/tools/sec_json_to_xml.py). format=xml: the XML with its SHA-256. Pass next_cursor back as cursor for older filings.

Parameters:

- cik (query, string, required): CIK, 10 digits with or without leading zeros.
- form (query, string, required): Form type as filed: "4", "144", "SCHEDULE 13G", "D"…
- from (query, string, optional): Earliest date, YYYY-MM-DD.
- to (query, string, optional): Latest date, YYYY-MM-DD.
- format (query, string, optional, one of json, xml, default json): json or xml.
- compact (query, boolean, optional, default false): Drop "#order".
- amendments (query, boolean, optional, default true): Include /A filings.
- limit (query, integer, optional, default 20): Filings per call (json 1-100, xml 1-50, default 20).
- cursor (query, string, optional): next_cursor from the previous call.

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/form-data?cik=0000320193&form=4&from=2024-01-01"
```

Example response (application/json, arrays cut to two items):

```
{
 "cik": "0000320193",
 "count": 1,
 "coverage_from": "2003-01-01",
 "filings": [
  {
   "accession_number": "0001140361-26-039785",
   "form": "4",
   "filing_date": "2026-10-15",
   "filename": "form4.xml",
   "root": "ownershipDocument",
   "schema_version": "X0609",
   "data": {
    "aff10b5One": "true",
    "documentType": "4",
    "footnotes": {
     "footnote": {
      "#text": "This transaction was made pursuant to a Rule 10b5-1 trading plan adopted by the reporting person on May 5, 2026.",
      "@id": "F1"
     }
    },
    "issuer": {
     "issuerCik": "0000320193",
     "issuerForeignTradingSymbol": "",
     "issuerName": "Apple Inc.",
     "issuerTradingSymbol": "AAPL"
    },
    "nonDerivativeTable": {
     "nonDerivativeTransaction": {
      "ownershipNature": {
       "directOrIndirectOwnership": {
        "value": "D"
       }
      },
      "postTransactionAmounts": {
       "sharesOwnedFollowingTransaction": {
        "value": "37194"
       }
      },
      "securityTitle": {
       "footnoteId": {
        "@id": "F1"
       },
       "value": "Common Stock"
      },
      "transactionAmounts": {
       "transactionAcquiredDisposedCode": {
        "value": "D"
       },
       "transactionPricePerShare": {
        "value": "345.00"
       },
       "transactionShares": {
        "value": "2399"
       }
      },
      "transactionCoding": {
       "equitySwapInvolved": "false",
       "transactionCode": "S",
       "transactionFormType": "4"
      },
      "transactionDate": {
       "value": "2026-10-13"
      }
     }
    },
    "ownerSignature": {
     "signatureDate": "2026-10-15",
     "signatureName": "/s/ Sam Whittington, Attorney-in-Fact for Jennifer Newstead"
    },
    "periodOfReport": "2026-10-13",
    "reportingOwner": {
     "reportingOwnerAddress": {
      "rptOwnerCity": "CUPERTINO",
      "rptOwnerNonUSAddressFlag": "false",
      "rptOwnerState": "CA",
      "rptOwnerStateDescription": "",
      "rptOwnerStreet1": "ONE APPLE PARK WAY",
      "rptOwnerStreet2": "",
      "rptOwnerZipCode": "95014"
     },
     "reportingOwnerId": {
      "rptOwnerCik": "0001780525",
      "rptOwnerName": "Newstead Jennifer"
     },
     "reportingOwnerRelationship": {
      "isDirector": "false",
      "isOfficer": "true",
      "isOther": "false",
      "isTenPercentOwner": "false",
      "officerTitle": "SVP, GC and Government Affairs"
     }
    },
    "schemaVersion": "X0609"
   },
   "source": {
    "sec_url": "https://www.sec.gov
…
```

### GET /statements/{cik}/{accession}

Financial statements of one 10-K or 10-Q. Balance sheet, income statement, cash flow, equity and comprehensive income as the filing presents them (each R-page's text), chosen from the filing's own XBRL. include_tags=true adds lines: every line's XBRL concept, members and unit, and its figures for the filing's own period with value, ref and highlight_url.

Parameters:

- cik (path, string, required): Company or filer CIK, 10 digits with leading zeros ("0000320193") or without ("320193").
- accession (path, string, required): SEC accession number, as 0000320193-25-000079.
- include_tags (query, boolean, optional, default false): Add tagged lines (about 5x larger).

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/statements/0000320193/0000320193-25-000079"
```

Example response (application/json, arrays cut to two items):

```
{
 "accession_number": "0000320193-25-000079",
 "cik": "0000320193",
 "company_name": "Apple Inc.",
 "count": 5,
 "filing_date": "2025-10-31T00:00:00Z",
 "form": "10-K",
 "source": {
  "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
  "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079",
  "citation": "Apple Inc., Form 10-K, filed 2025-10-31, https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm"
 },
 "statements": [
  {
   "type": "balance_sheet",
   "short_name": "CONSOLIDATED BALANCE SHEETS - USD ($)",
   "long_name": "CONSOLIDATED BALANCE SHEETS - USD ($)",
   "r_file": "R5.htm",
   "found_by": "statement_roles",
   "content": "CONSOLIDATED BALANCE SHEETS - USD ($)shares in Thousands, $ in Millions  Sep. 27, 2025  Sep. 28, 2024\nCurrent assets:    \nCash and cash equivalents  $ 35,934  $ 29,943\nMarketable securities  18,763  35,228\nAccounts receivable, net  39,777  33,410\nVendor non-trade receivables  33,180  32,833\nInventories  5,718  7,286\nOther current assets  14,585  14,287\nTotal current assets  147,957  152,987\nNon-cu…",
   "source": {
    "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/R5.htm",
    "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
    "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/R5.htm"
   }
  },
  {
   "type": "cash_flow",
   "short_name": "CONSOLIDATED STATEMENTS OF CASH FLOWS - USD ($)",
   "long_name": "CONSOLIDATED STATEMENTS OF CASH FLOWS - USD ($)",
   "r_file": "R8.htm",
   "found_by": "statement_roles",
   "content": "CONSOLIDATED STATEMENTS OF CASH FLOWS - USD ($)$ in Millions  12 Months Ended\nSep. 27, 2025  Sep. 28, 2024  Sep. 30, 2023\nStatement of Cash Flows [Abstract]      \nCash, cash equivalents, and restricted cash and cash equivalents, beginning balances  $ 29,943  $ 30,737  $ 24,977\nOperating activities:      \nNet income  112,010  93,736  96,995\nAdjustments to reconcile net income to cash generated by o…",
   "source": {
    "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/R8.htm",
    "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
    "beatandraise_url": "https://beatandraise.com/cik/0000320
…
```

### GET /financial-history

Statements from a company's last several reports. The same statements from the last 5 annual reports (10-K, 20-F, 40-F; max 10) or 8 10-Qs (max 20), newest first, filing by filing as presented: not merged, so periods repeat and the newest filing's figure is current.

Parameters:

- cik (query, string, required): CIK, 10 digits with or without leading zeros.
- period (query, string, optional, one of annual, quarterly, default annual): annual or quarterly.
- statements (query, string, optional): Comma-separated subset: income_statement, balance_sheet, cash_flow, equity, comprehensive_income.
- limit (query, integer, optional): Number of filings.
- before (query, string, optional): Only filings filed on or before this date (YYYY-MM-DD).
- fiscal_year (query, integer, optional): Fiscal year as the company states it.
- fiscal_period (query, string, optional, one of Q1, Q2, Q3, FY): Q1, Q2, Q3 or FY (no Q4: it is in the annual report).
- include_tags (query, boolean, optional, default false): Add tagged lines.

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/financial-history?cik=0000320193"
```

Example response (application/json, arrays cut to two items):

```
{
 "cik": "0000320193",
 "company_name": "Apple Inc.",
 "period": "annual",
 "filings": [
  {
   "accession_number": "0000320193-25-000079",
   "form": "10-K",
   "filing_date": "2025-10-31",
   "fiscal_year": 2025,
   "fiscal_period": "FY",
   "statements": [
    {
     "type": "income_statement",
     "short_name": "CONSOLIDATED STATEMENTS OF OPERATIONS - USD ($)",
     "long_name": "CONSOLIDATED STATEMENTS OF OPERATIONS - USD ($)",
     "r_file": "R3.htm",
     "found_by": "statement_roles",
     "content": "CONSOLIDATED STATEMENTS OF OPERATIONS - USD ($)shares in Thousands, $ in Millions  12 Months Ended\nSep. 27, 2025  Sep. 28, 2024  Sep. 30, 2023\nNet sales  $ 416,161  $ 391,035  $ 383,285\nCost of sales  220,960  210,352  214,137\nGross margin  195,201  180,683  169,148\nOperating expenses:      \nResearch and development  34,550  31,370  29,915\nSelling, general and administrative  27,601  26,097  24,93…",
     "source": {
      "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/R3.htm",
      "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
      "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/R3.htm"
     }
    }
   ]
  }
 ],
 "note": "Each filing's statements as that filing presents them, newest filing first. A 10-K shows two or three years and a 10-Q this year's and last year's quarter, so periods repeat across filings; for a period shown in more than one, the newest filing's figure is the current one (it may restate). Labels, line items and scale (thousands or millions, given in each statement's heading) can differ between fi…"
}
```

### GET /get-statements

Experimental: a statement period by period. One row per line and period, every value a filed XBRL fact with its source filing. Quarters a filing does not report on their own (often Q4) are derived from year-to-date figures and say so (how, facts).

Parameters:

- cik (query, string, required): CIK or ticker.
- statement (query, string, required, one of income, cash_flow, balance_sheet): Which statement.
- period (query, string, required, one of quarterly, annual): quarterly or annual.
- from (query, string, optional): Earliest date, YYYY-MM-DD.
- to (query, string, optional): Latest date, YYYY-MM-DD.

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/get-statements?cik=AAPL&statement=income&period=annual&from=2024-01-01"
```

Example response (application/json, arrays cut to two items):

```
{
 "cik": "0000320193",
 "statement": "income",
 "period": "annual",
 "snapshot": "20261019T070501Z",
 "rows": [
  {
   "fy": 2024,
   "fp": "FY",
   "fiscal_year_end": "2024-09-28",
   "period_start": "2023-10-01",
   "period_end": "2024-09-28",
   "line_order": 2,
   "label": "Net sales",
   "concept": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax",
   "unit": "iso4217:USD",
   "role": "duration",
   "value": 391035000000,
   "display_value": 391035000000,
   "scale": 6,
   "how": "reported",
   "sources": "0000320193-24-000123",
   "source_files": [
    {
     "accession": "0000320193-24-000123",
     "form": "10-K",
     "filing_date": "2024-11-01",
     "r_file": "R3.htm",
     "primary_doc": "aapl-20240928.htm"
    }
   ],
   "facts": [
    {
     "accession": "0000320193-24-000123",
     "period_start": "2023-10-01",
     "period_end": "2024-09-28",
     "months": 12,
     "value": 391035000000,
     "text": "$ 391,035"
    }
   ]
  },
  {
   "fy": 2024,
   "fp": "FY",
   "fiscal_year_end": "2024-09-28",
   "period_start": "2023-10-01",
   "period_end": "2024-09-28",
   "line_order": 3,
   "label": "Cost of sales",
   "concept": "us-gaap:CostOfGoodsAndServicesSold",
   "unit": "iso4217:USD",
   "role": "duration",
   "value": 210352000000,
   "display_value": 210352000000,
   "scale": 6,
   "how": "reported",
   "sources": "0000320193-24-000123",
   "source_files": [
    {
     "accession": "0000320193-24-000123",
     "form": "10-K",
     "filing_date": "2024-11-01",
     "r_file": "R3.htm",
     "primary_doc": "aapl-20240928.htm"
    }
   ],
   "facts": [
    {
     "accession": "0000320193-24-000123",
     "period_start": "2023-10-01",
     "period_end": "2024-09-28",
     "months": 12,
     "value": 210352000000,
     "text": "210,352"
    }
   ]
  }
 ]
}
```

### GET /insider-transactions

Form 4 insider transactions. Transactions per Form 4 with owner (name, title, relationship), date, code (P purchase, S sale, A award, M exercise, G gift, F tax), shares, price and holdings after. Table II (options, RSUs, convertibles) with include_table_ii=true. cik is the issuer, not the insider.

Parameters:

- cik (query, string, required): CIK, 10 digits with or without leading zeros.
- from (query, string, optional): Earliest date, YYYY-MM-DD.
- to (query, string, optional): Latest date, YYYY-MM-DD.
- limit (query, integer, optional, default 20): Results per call (1-100, default 20).
- offset (query, integer, optional, default 0): Pagination offset.
- include_table_ii (query, boolean, optional, default false): Add Table II lines.

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/insider-transactions?cik=0000320193&from=2024-01-01"
```

Example response (application/json, arrays cut to two items):

```
{
 "cik": "0000320193",
 "count": 2,
 "transactions": [
  {
   "accession_number": "0001140361-26-039785",
   "filing_date": "2026-10-15T00:00:00Z",
   "issuer_name": "Apple Inc.",
   "issuer_ticker": "AAPL",
   "owner_name": "Newstead Jennifer",
   "owner_cik": "0001780525",
   "is_director": false,
   "is_officer": true,
   "officer_title": "SVP, GC and Government Affairs",
   "is_ten_pct_owner": false,
   "transaction_date": "2026-10-13",
   "security_title": "Common Stock",
   "transaction_code": "S",
   "shares": "2399",
   "price_per_share": "345.00",
   "acquired_disposed": "D",
   "shares_after": "37194",
   "direct_indirect": "D",
   "source": {
    "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126039785/form4.xml",
    "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126039785/0001140361-26-039785-index.htm",
    "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0001140361-26-039785/form4.xml",
    "citation": "Apple Inc., Form 4, filed 2026-10-15, https://www.sec.gov/Archives/edgar/data/320193/000114036126039785/form4.xml"
   }
  },
  {
   "accession_number": "0001140361-26-039158",
   "filing_date": "2026-10-08T00:00:00Z",
   "issuer_name": "Apple Inc.",
   "issuer_ticker": "AAPL",
   "owner_name": "Newstead Jennifer",
   "owner_cik": "0001780525",
   "is_director": false,
   "is_officer": true,
   "officer_title": "SVP, GC and Government Affairs",
   "is_ten_pct_owner": false,
   "transaction_date": "2026-10-06",
   "security_title": "Common Stock",
   "transaction_code": "S",
   "shares": "2399",
   "price_per_share": "332.01",
   "acquired_disposed": "D",
   "shares_after": "39593",
   "direct_indirect": "D",
   "source": {
    "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126039158/form4.xml",
    "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000114036126039158/0001140361-26-039158-index.htm",
    "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0001140361-26-039158/form4.xml",
    "citation": "Apple Inc., Form 4, filed 2026-10-08, https://www.sec.gov/Archives/edgar/data/320193/000114036126039158/form4.xml"
   }
  }
 ]
}
```

### GET /insiders

In development: insider trading totals. Open-market buys, sales and Form 144 planned sales totalled for a company (cik) or one insider (owner), with top buyers and sellers and the share under 10b5-1 plans. Since 2024.

Parameters:

- cik (query, string, optional): CIK, 10 digits with or without leading zeros.
- owner (query, string, optional): An insider's CIK, instead of cik.
- months (query, integer, optional): Look-back in months.

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/insiders?cik=0000320193&months=6"
```

Example response (application/json, arrays cut to two items):

```
{
 "mode": "issuer",
 "cik": "0000320193",
 "name": "Apple Inc.",
 "tickers": [
  "AAPL"
 ],
 "from": "2026-04-19",
 "to": "2026-10-19",
 "coverage_from": "2024-01-01",
 "buys": {
  "count": 0,
  "shares": 0,
  "value_usd": 0
 },
 "sells": {
  "count": 18,
  "shares": 584706,
  "value_usd": 181306174.39000005
 },
 "planned_sales_144": {
  "count": 10,
  "shares": 675619,
  "value_usd": 140175735.48
 },
 "top_sellers": [
  {
   "cik": "0001214128",
   "name": "LEVINSON ARTHUR D",
   "role": "Director",
   "trades": 2,
   "shares": 300000,
   "value_usd": 86740722.31,
   "last_date": "2026-05-27",
   "plan_10b5_1_pct": 0
  },
  {
   "cik": "0001214156",
   "name": "COOK TIMOTHY D",
   "role": "Executive Chair, Director",
   "trades": 1,
   "shares": 191753,
   "value_usd": 63845841.04,
   "last_date": "2026-10-02",
   "plan_10b5_1_pct": 100
  }
 ],
 "top_buyers": [],
 "events": [
  {
   "date": "2026-10-16",
   "filing_date": "2026-10-16",
   "form": "144",
   "kind": "planned_sale",
   "label": "Planned sale (Form 144)",
   "owner_cik": "0002050912",
   "owner_name": "KEVAN PAREKH",
   "role": "Officer",
   "issuer_cik": "0000320193",
   "issuer_name": "Apple Inc.",
   "security": "Common",
   "shares": 1392,
   "value_usd": 476064,
   "plan_10b5_1": true,
   "plan_adopted": [
    "2025-11-21"
   ],
   "accession_number": "0001950047-26-010286",
   "source": {
    "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000195004726010286/primary_doc.xml",
    "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000195004726010286/0001950047-26-010286-index.htm",
    "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0001950047-26-010286/primary_doc.xml",
    "citation": "Apple Inc., Form 144, filed 2026-10-16, https://www.sec.gov/Archives/edgar/data/320193/000195004726010286/primary_doc.xml"
   }
  },
  {
   "date": "2026-10-13",
   "filing_date": "2026-10-15",
   "form": "4",
   "kind": "sell",
   "code": "S",
   "label": "Open-market sale",
   "owner_cik": "0001780525",
   "owner_name": "Newstead Jennifer",
   "role": "SVP, GC and Government Affairs",
   "issuer_cik": "0000320193",
   "issuer_name": "Apple Inc.",
   "ticker": "AAPL",
   "security": "Common Stock",
   "shares": 2399,
   "price": 345,
   "price_low": 345,
   "price_high": 345,
   "date_from": "2026-10-13",
   "lines": 1,
   "value_usd": 827655,
   "shares_after": 37194,
   "plan_10b5_1": true,
   "accession_number": "0001140361-26-039785",
   "sou
…
```

### GET /shares-outstanding

Shares outstanding over time, and splits. Cover-page shares outstanding per class from every 10-K, 10-Q, 20-F and 40-F since 2009, as filed (never split-adjusted), with ratio_to_previous; splits lists each split and reverse split with the filing that restated the counts.

Parameters:

- cik (query, string, required): CIK, 10 digits with or without leading zeros.
- share_class (query, string, optional): Only this class, as returned in share_class.
- from (query, string, optional): Earliest date, YYYY-MM-DD.
- to (query, string, optional): Latest date, YYYY-MM-DD.

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/shares-outstanding?cik=0000320193&from=2024-01-01"
```

Example response (application/json, arrays cut to two items):

```
{
 "cik": "0000320193",
 "company": "Apple Inc.",
 "count": 11,
 "coverage_from": "2009-01-01",
 "listed": [
  {
   "share_class": "CommonStockMember",
   "title": "Common Stock, $0.00001 par value per share",
   "symbol": "AAPL",
   "exchange": "NASDAQ"
  },
  {
   "share_class": "A1.625NotesDue2026Member",
   "title": "1.625% Notes due 2026",
   "exchange": "NASDAQ"
  }
 ],
 "note": "Cover-page counts as filed, never split-adjusted, so a split shows as a jump in ratio_to_previous (not exactly the ratio: buybacks and issuance move the count too). splits lists each stock split and reverse split: a 10-K or 10-Q restated the company's earlier share counts by its ratio, which accounting rules require for every split, between happened_after and by. restated_figures is how many share…",
 "rows": [
  {
   "share_class": "common",
   "as_of": "2024-01-19",
   "shares": 15441881000,
   "ratio_to_previous": 0.9929,
   "form": "10-Q",
   "filing_date": "2024-02-02",
   "accession_number": "0000320193-24-000006",
   "source": {
    "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000006/0000320193-24-000006-index.htm",
    "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-24-000006",
    "citation": "Apple Inc., Form 10-Q, filed 2024-02-02, https://www.sec.gov/Archives/edgar/data/320193/000032019324000006/0000320193-24-000006-index.htm"
   }
  },
  {
   "share_class": "common",
   "as_of": "2024-04-19",
   "shares": 15334082000,
   "ratio_to_previous": 0.993,
   "form": "10-Q",
   "filing_date": "2024-05-03",
   "accession_number": "0000320193-24-000069",
   "source": {
    "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000069/0000320193-24-000069-index.htm",
    "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-24-000069",
    "citation": "Apple Inc., Form 10-Q, filed 2024-05-03, https://www.sec.gov/Archives/edgar/data/320193/000032019324000069/0000320193-24-000069-index.htm"
   }
  }
 ],
 "share_count_tagging_corrections": [],
 "splits": []
}
```

### GET /holdings/{cik}

A 13F manager's positions. The 13F-HR information table on or before period: issuer, CUSIP, value, shares, discretion, voting, and the issuer's CIK and SIC when known. Values in the filer's unit. cik is the institution.

Parameters:

- cik (path, string, required): The 13F filer's CIK.
- period (query, string, optional): As of this date (YYYY-MM-DD): the latest 13F filed on or before it.
- limit (query, integer, optional, default 500): Results per call (1-5000, default 500).
- offset (query, integer, optional, default 0): Pagination offset.

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/holdings/0001067983"
```

Example response (application/json, arrays cut to two items):

```
{
 "accession_number": "0001193125-26-352200",
 "cik": "0001067983",
 "company_name": "BERKSHIRE HATHAWAY INC",
 "count": 2,
 "filing_date": "2026-08-14T00:00:00Z",
 "form": "13F-HR",
 "format": "xml",
 "holdings": [
  {
   "name_of_issuer": "ALLY FINL INC",
   "title_of_class": "COM",
   "cusip": "02005N100",
   "value": 577211815,
   "shares": 12561737,
   "share_type": "SH",
   "investment_discretion": "DFND",
   "voting_sole": 12561737,
   "voting_shared": 0,
   "voting_none": 0,
   "issuer_cik": "0000040729",
   "sic": "6022",
   "sic_description": "STATE COMMERCIAL BANKS"
  },
  {
   "name_of_issuer": "ALLY FINL INC",
   "title_of_class": "COM",
   "cusip": "02005N100",
   "value": 128838056,
   "shares": 2803875,
   "share_type": "SH",
   "investment_discretion": "DFND",
   "voting_sole": 2803875,
   "voting_shared": 0,
   "voting_none": 0,
   "issuer_cik": "0000040729",
   "sic": "6022",
   "sic_description": "STATE COMMERCIAL BANKS"
  }
 ],
 "limit": 2,
 "offset": 0,
 "source": {
  "sec_url": "https://www.sec.gov/Archives/edgar/data/1067983/000119312526352200/56757.xml",
  "filing_index_url": "https://www.sec.gov/Archives/edgar/data/1067983/000119312526352200/0001193125-26-352200-index.htm",
  "beatandraise_url": "https://beatandraise.com/cik/0001067983/accessionNumber/0001193125-26-352200/56757.xml",
  "citation": "BERKSHIRE HATHAWAY INC, Form 13F-HR, filed 2026-08-14, https://www.sec.gov/Archives/edgar/data/1067983/000119312526352200/56757.xml"
 },
 "total_holdings": 89,
 "total_value": 299253556246,
 "with_sic": 2
}
```

### GET /institutional-holders/{company}

Who holds a company (13F). Per complete quarter, newest first: % of each share class held by 13F filers (never summed across classes), holders, new and exited holders, top holders, biggest buyers and sellers, 5%+ holders (13D/G). holder= follows one institution across quarters.

Parameters:

- company (path, string, required): Ticker or CIK of the company held.
- quarters (query, integer, optional, default 4): Complete quarters (1-12, default 4).
- holder (query, string, optional): A 13F filer to follow: name fragment or CIK.
- limit (query, integer, optional, default 25): Results per call (1-100, default 25).
- detail (query, string, optional, one of lean, full): lean or full (default full, lean with holder).

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/institutional-holders/AAPL"
```

Example response (application/json, arrays cut to two items):

```
{
 "detail": "full",
 "company": {
  "cik": "0000320193",
  "name": "Apple Inc.",
  "tickers": [
   "AAPL"
  ]
 },
 "quarters": [
  {
   "period": "2026-06-30",
   "complete": true,
   "filers_reporting": 8954,
   "share_classes": [
    {
     "class": "",
     "listed": true,
     "symbol": "AAPL",
     "exchange": "NASDAQ",
     "shares_outstanding": 14594180000,
     "shares_as_of": "2026-07-17",
     "held_by_13f": 9700948249,
     "pct_of_class": 66.47,
     "holders": 6154,
     "cusips": [
      "037833100"
     ]
    }
   ],
   "unmatched_cusips": [],
   "holders": 6154,
   "new_holders": 201,
   "exited_holders": 182,
   "shares_held": 9700948249,
   "value_usd": 2802660541339,
   "holders_url": "https://beatandraise.com/cik/0000320193/holders?period=2026-06-30",
   "share_count_source": {
    "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000020/aapl-20260627.htm",
    "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000020/0000320193-26-000020-index.htm",
    "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-26-000020/aapl-20260627.htm"
   },
   "share_count_form": "10-Q"
  }
 ],
 "in_progress_quarter": {
  "period": "2026-09-30",
  "filings": 1582,
  "complete": false
 },
 "top_holders": [
  {
   "filer_cik": "0002012383",
   "filer_name": "BlackRock, Inc.",
   "shares": 1162996939,
   "prev_shares": 1144695425,
   "change_shares": 18301514,
   "value_usd": 336524794350,
   "pct_of_class": 7.97
  },
  {
   "filer_cik": "0002100119",
   "filer_name": "VANGUARD CAPITAL MANAGEMENT LLC",
   "shares": 959107911,
   "prev_shares": 953847648,
   "change_shares": 5260263,
   "value_usd": 277527465127,
   "pct_of_class": 6.57
  }
 ],
 "biggest_buyers": [
  {
   "filer_cik": "0000038777",
   "filer_name": "FRANKLIN RESOURCES INC",
   "shares": 69201134,
   "prev_shares": 48602133,
   "change_shares": 20599001,
   "pct_of_class": 0.47
  },
  {
   "filer_cik": "0002012383",
   "filer_name": "BlackRock, Inc.",
   "shares": 1162996939,
   "prev_shares": 1144695425,
   "change_shares": 18301514,
   "pct_of_class": 7.97
  }
 ],
 "biggest_sellers": [
  {
   "filer_cik": "0000080255",
   "filer_name": "PRICE T ROWE ASSOCIATES INC /MD/",
   "shares": 159811362,
   "prev_shares": 200426620,
   "change_shares": -40615258,
   "pct_of_class": 1.1
  },
  {
   "filer_cik": "0001731124",
   "filer_name": "DIAMANT ASSET MANAGEMENT, INC.",
   "shares": 102419,
   "prev_shares": 26
…
```

### GET /company/search

Find a company by name or ticker. Matching companies and filers with CIK, names, tickers and SIC. succession_filing marks a company that succeeded an earlier registrant in the last five years (its history may be under that CIK).

Parameters:

- q (query, string, required): Name or ticker.
- limit (query, integer, optional, default 10): Results per call (1-50, default 10).

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/company/search?q=apple"
```

Example response (application/json, arrays cut to two items):

```
{
 "count": 2,
 "results": [
  {
   "cik": "0000320193",
   "files_13f": false,
   "id": "0000320193",
   "names": [
    "Apple Inc.",
    "APPLE COMPUTER INC"
   ],
   "sic": "3571",
   "sic_description": "ELECTRONIC COMPUTERS",
   "tickers": [
    "AAPL"
   ]
  },
  {
   "cik": "0001418121",
   "files_13f": false,
   "id": "0001418121",
   "names": [
    "Apple Hospitality REIT, Inc.",
    "Apple REIT Nine, Inc."
   ],
   "sic": "6798",
   "sic_description": "REAL ESTATE INVESTMENT TRUSTS",
   "tickers": [
    "APLE"
   ]
  }
 ]
}
```

### GET /company/{cik}

A company: names, tickers, industry. Names (newest first), tickers, SIC code and title, fiscal year end (MMDD), state of incorporation, succession_filing.

Parameters:

- cik (path, string, required): Company or filer CIK, 10 digits with leading zeros ("0000320193") or without ("320193").

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/company/0000320193"
```

Example response (application/json, arrays cut to two items):

```
{
 "cik": "0000320193",
 "fiscal_year_end": "0926",
 "name": "Apple Inc.",
 "names": [
  "Apple Inc.",
  "APPLE COMPUTER INC"
 ],
 "sic": "3571",
 "sic_description": "ELECTRONIC COMPUTERS",
 "sic_url": "https://beatandraise.com/sic/3571",
 "state_of_incorporation": "CA",
 "ticker": "AAPL",
 "tickers": [
  "AAPL"
 ]
}
```

### GET /sic

SIC industry codes and their companies. find=<word>: matching SIC codes with company counts. code=<SIC>: that code's companies, 100 per page, listed companies first. Neither: every code.

Parameters:

- find (query, string, optional): A word from the industry title.
- code (query, string, optional): A 3-4 digit SIC code.
- q (query, string, optional): With code: name or ticker contains this.
- page (query, integer, optional, default 1): With code: page from 1.
- listed (query, string, optional, one of 1): With code: 1 for companies with a ticker only.

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/sic?find=software"
```

Example response (application/json, arrays cut to two items):

```
{
 "codes": [
  {
   "sic": "7372",
   "description": "SERVICES-PREPACKAGED SOFTWARE",
   "office": "Office of Technology",
   "companies": 1789,
   "listed": 289
  },
  {
   "sic": "5045",
   "description": "WHOLESALE-COMPUTERS & PERIPHERAL EQUIPMENT & SOFTWARE",
   "office": "Office of Trade & Services",
   "companies": 98,
   "listed": 9
  }
 ]
}
```

## Checking figures and quotes

### GET /document/verify/{cik}/{accession}/{filename}

Is this sentence or figure in the document? Finds the quote (words and numbers exact; spacing, table-cell breaks, $ and quotes flexible) and returns each occurrence with context and a highlight_url marking that exact span. found=false: numbers_elsewhere says where its figures do appear.

Parameters:

- cik (path, string, required): Company or filer CIK, 10 digits with leading zeros ("0000320193") or without ("320193").
- accession (path, string, required): SEC accession number, as 0000320193-25-000079.
- filename (path, string, required): A file of the filing, as its content_object or /files lists it.
- quote (query, string, required): The exact text (max 1,000 characters).

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/document/verify/0000320193/0000320193-25-000079/aapl-20250927.htm?quote=Total%20net%20sales"
```

Example response (application/json, arrays cut to two items):

```
{
 "found": true,
 "match_count": 16,
 "matches": [
  {
   "text": "total net sales",
   "context": "…certain of its services. During 2025, the Company’s net sales through its direct and indirect distribution channels accounted for 40% and 60%, respectively, of [total net sales] .CompetitionThe markets for the Company’s products and services are highly competitive and are characterized by aggressive price competition, downward pressure…",
   "highlight_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/aapl-20250927.htm?hl=26473,15&src=mcp#br-hl-0",
   "sec_fragment_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm#:~:text=total%20net%20sales"
  },
  {
   "text": "total net sales",
   "context": "…f operations, financial condition and stock price.The Company has international operations with sales outside the U.S. representing a majority of the Company’s [total net sales] . In addition, the Company’s global supply chain is large and complex and a majority of the Company’s supplier facilities, including manufacturing and assembly…",
   "highlight_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/aapl-20250927.htm?hl=39359,15&src=mcp#br-hl-0",
   "sec_fragment_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm#:~:text=total%20net%20sales"
  }
 ],
 "note": "The quote occurs more than once; cite the match whose context fits the claim, or quote more of the surrounding text (e.g. the row label) to pin one.",
 "quote": "Total net sales",
 "source": {
  "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm",
  "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
  "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/aapl-20250927.htm"
 }
}
```

### GET /document/verify-figure/{cik}/{accession}

Is this number in the filing, however written? Compares digits only, allowing scale and rounding: "$416.2 billion" matches 416,161 (in millions). Searches every document of the filing. Up to 10 matches, each with label, context, ref and highlight_url.

Parameters:

- cik (path, string, required): Company or filer CIK, 10 digits with leading zeros ("0000320193") or without ("320193").
- accession (path, string, required): SEC accession number, as 0000320193-25-000079.
- value (query, string, required): The figure as you would state it.
- label (query, string, optional): What it is, for ranking.

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/document/verify-figure/0000320193/0000320193-25-000079?value=%24416.2%20billion&label=total%20net%20sales"
```

Example response (application/json, arrays cut to two items):

```
{
 "digits": "4162",
 "documents_searched": [
  "aapl-20250927.htm",
  "a10-kexhibit4109272025.htm"
 ],
 "found": true,
 "label": "total net sales",
 "match_count": 6,
 "matches": [
  {
   "ref": "0000320193-25-000079/aapl-20250927.htm@122209+7",
   "document": "aapl-20250927.htm",
   "text": "416,161",
   "digits": "416161",
   "label": "Total net sales",
   "context": "…(4)%66,952 (8)%72,559 Japan28,703 15 %25,052 3 %24,257 Rest of Asia Pacific33,696 10 %30,658 4 %29,615 Total net sales$ [416,161] 6 %$391,035 2 %$383,285 AmericasAmericas net sales increase…",
   "highlight_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/aapl-20250927.htm?hl=122209,7&src=mcp#br-hl-0"
  },
  {
   "ref": "0000320193-25-000079/aapl-20250927.htm@123498+7",
   "document": "aapl-20250927.htm",
   "text": "416,161",
   "digits": "416161",
   "label": "Total net sales",
   "context": "…0 Wearables, Home and Accessories35,686 (4)%37,005 (7)%39,845 Services (1)109,158 14 %96,169 13 %85,200 Total net sales$ [416,161] 6 %$391,035 2 %$383,285 (1)Services net sales include amort…",
   "highlight_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/aapl-20250927.htm?hl=123498,7&src=mcp#br-hl-0"
  }
 ],
 "note": "Matching is by digits only: confirm each candidate's label, period and scale from its context before citing it.",
 "source": {
  "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
  "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079"
 },
 "value": "$416.2 billion"
}
```

### GET /document/verify-figure/{cik}/{accession}/{filename}

As above, in one document. verify-figure limited to one document.

Parameters:

- cik (path, string, required): Company or filer CIK, 10 digits with leading zeros ("0000320193") or without ("320193").
- accession (path, string, required): SEC accession number, as 0000320193-25-000079.
- filename (path, string, required): A file of the filing, as its content_object or /files lists it.
- value (query, string, required): The figure.
- label (query, string, optional): What it is.

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/document/verify-figure/0000320193/0000320193-25-000079/aapl-20250927.htm?value=%24416.2%20billion"
```

Example response (application/json, arrays cut to two items):

```
{
 "digits": "4162",
 "documents_searched": [
  "aapl-20250927.htm",
  "a10-kexhibit4109272025.htm"
 ],
 "found": true,
 "label": "total net sales",
 "match_count": 6,
 "matches": [
  {
   "ref": "0000320193-25-000079/aapl-20250927.htm@122209+7",
   "document": "aapl-20250927.htm",
   "text": "416,161",
   "digits": "416161",
   "label": "Total net sales",
   "context": "…(4)%66,952 (8)%72,559 Japan28,703 15 %25,052 3 %24,257 Rest of Asia Pacific33,696 10 %30,658 4 %29,615 Total net sales$ [416,161] 6 %$391,035 2 %$383,285 AmericasAmericas net sales increase…",
   "highlight_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/aapl-20250927.htm?hl=122209,7&src=mcp#br-hl-0"
  },
  {
   "ref": "0000320193-25-000079/aapl-20250927.htm@123498+7",
   "document": "aapl-20250927.htm",
   "text": "416,161",
   "digits": "416161",
   "label": "Total net sales",
   "context": "…0 Wearables, Home and Accessories35,686 (4)%37,005 (7)%39,845 Services (1)109,158 14 %96,169 13 %85,200 Total net sales$ [416,161] 6 %$391,035 2 %$383,285 (1)Services net sales include amort…",
   "highlight_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/aapl-20250927.htm?hl=123498,7&src=mcp#br-hl-0"
  }
 ],
 "note": "Matching is by digits only: confirm each candidate's label, period and scale from its context before citing it.",
 "source": {
  "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
  "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079"
 },
 "value": "$416.2 billion"
}
```

### GET /document/figures/{cik}/{accession}/{filename}

Every number in a document, with its label. Each figure as {ref, digits, text, label, hl}. A figure you state must be one of these digit strings times a power of ten. Link one with highlight_base + "?hl=" + hl. A 10-K has about 2,000: filter with near.

Parameters:

- cik (path, string, required): Company or filer CIK, 10 digits with leading zeros ("0000320193") or without ("320193").
- accession (path, string, required): SEC accession number, as 0000320193-25-000079.
- filename (path, string, required): A file of the filing, as its content_object or /files lists it.
- near (query, string, optional): Only labels containing this.
- limit (query, integer, optional, default 300): Results per call (1-2000, default 300).

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/document/figures/0000320193/0000320193-25-000079/aapl-20250927.htm?near=total%20net%20sales"
```

Example response (application/json, arrays cut to two items):

```
{
 "cite_as": "write [ref:<ref>] right after a number you take from here; [calc: ref:<a>, ref:<b>] after one you compute from them",
 "count": 3,
 "document": "aapl-20250927.htm",
 "figures": [
  {
   "ref": "0000320193-25-000079/aapl-20250927.htm@122209+7",
   "digits": "416161",
   "text": "416,161",
   "label": "Total net sales",
   "hl": "122209,7"
  },
  {
   "ref": "0000320193-25-000079/aapl-20250927.htm@122218+1",
   "digits": "6",
   "text": "6",
   "label": "Total net sales",
   "percent": true,
   "hl": "122218,1"
  }
 ],
 "highlight_base": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/aapl-20250927.htm",
 "how_to_link": "highlight_base + \"?hl=\" + hl + \"&src=mcp#br-hl-0\" marks that number in the viewer",
 "near": "total net sales",
 "note": "28 figures match; showing 3. Narrow with near= (e.g. a row label).",
 "source": {
  "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm",
  "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm",
  "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/aapl-20250927.htm"
 },
 "total": 28
}
```

### POST /check-citations

Check every cited number in a draft. Write [ref:<ref>] after each figure (refs from figures or verify-figure) and [calc: ref:a, ref:b] after a computed one. Returns each citation's status (ok, rounded, mismatch, bad_ref, not_derivable), unsourced_numbers, and linked_text with footnotes to the highlighted figures. Only passing citations get a footnote.

JSON body:

- text (string): The draft (max ~200 KB).

```
curl -X POST -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"text":"Apple's net sales were $416.2 billion [ref:0000320193-25-000079/aapl-20250927.htm@122209+7]."}' "https://beatandraise.com/api/v1/check-citations"
```

Example response (application/json, arrays cut to two items):

```
{
 "all_verified": true,
 "citations": [
  {
   "kind": "ref",
   "claimed": "416.2",
   "status": "rounded",
   "detail": "416.2 is 416,161 rounded (times a power of ten)",
   "inputs": [
    {
     "ref": "0000320193-25-000079/aapl-20250927.htm@122209+7",
     "found": true,
     "text": "416,161",
     "label": "Total net sales",
     "company": "Apple Inc.",
     "form": "10-K",
     "document": "aapl-20250927.htm",
     "highlight_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/aapl-20250927.htm?hl=122209,7&src=mcp#br-hl-0",
     "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm",
     "footnote": 1
    }
   ]
  }
 ],
 "footnotes": "[1] Apple Inc. 10-K, aapl-20250927.htm: 416,161 — https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/aapl-20250927.htm?hl=122209,7&src=mcp#br-hl-0\n",
 "linked_text": "Apple's net sales were $416.2 billion [1].",
 "sources": [
  {
   "ref": "0000320193-25-000079/aapl-20250927.htm@122209+7",
   "found": true,
   "text": "416,161",
   "label": "Total net sales",
   "company": "Apple Inc.",
   "form": "10-K",
   "document": "aapl-20250927.htm",
   "highlight_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/aapl-20250927.htm?hl=122209,7&src=mcp#br-hl-0",
   "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm",
   "footnote": 1
  }
 ],
 "summary": {
  "citations": 1,
  "failed": 0,
  "ok": 1,
  "unsourced_numbers": 0
 },
 "unsourced_numbers": []
}
```

## Account

### GET /account

Your plan, limits and usage this month. Free of charge: never counts as a call.

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/account"
```

Example response (application/json, arrays cut to two items):

```
{
 "plan": "free",
 "limits": {
  "rate_per_sec": 10,
  "call_limit": 100,
  "monthly_download_bytes": 1000000000,
  "downloads_per_5min": 100
 },
 "free_calls_remaining": 42,
 "month": "2026-10",
 "download_bytes_used_this_month": 686135,
 "usage_this_month": {
  "calls": 58,
  "rejected": 0,
  "downloads": 12,
  "bytes": 686135
 }
}
```

### GET /status

Service status. Counts as a call.

```
curl -H "X-API-Key: $KEY" "https://beatandraise.com/api/v1/status"
```

Example response (application/json, arrays cut to two items):

```
{
 "status": "ok"
}
```