{ "openapi": "3.1.0", "info": { "title": "beatandraise.com SEC Filings API", "version": "1.0.0", "description": "The SEC EDGAR archive (every filing since 1993) and structured data built on it, for programs and LLM agents.\n\n**Authentication.** Every request needs an API key, sent as `X-API-Key: bar_…` or `Authorization: Bearer bar_…` (never in the URL). Create one free at https://beatandraise.com/api-keys.\n\n**Plans.** Free: 100 successful (2xx) requests per account, 10 requests a second. Pro (€50 a month or €540 a year, plus VAT where it applies): unlimited requests, 20 a second, 10,000 file downloads a day, 50 GB a month. https://beatandraise.com/sec-filings-api#plans\n\n**Conventions.** A CIK may be sent with or without leading zeros; responses use 10 digits (\"0000320193\"). Accession numbers look like 0000320193-25-000079. Dates are YYYY-MM-DD. Form types are as filed (\"10-K\", \"4\", \"SCHEDULE 13G\"); amendments are their own types (\"10-K/A\").\n\n**Sources.** Anything drawn from a filing carries a `source` object: `sec_url`, `filing_index_url`, `beatandraise_url` and, where known, a one-line `citation`. Figures and quotes come with a `highlight_url` that opens the filing with the exact characters marked; cite those.\n\n**Errors** are JSON `{\"error\": \"\", \"message\": \"…\"}` with the HTTP status. 429 carries Retry-After. A response that is not 2xx does not use a free-plan call.\n\nFor LLMs: https://beatandraise.com/llms.txt (index) and https://beatandraise.com/llms-full.txt (every endpoint in full).", "contact": { "name": "beatandraise.com support", "email": "support@beatandraise.com", "url": "https://beatandraise.com/support" }, "termsOfService": "https://beatandraise.com/terms" }, "externalDocs": { "description": "Documentation", "url": "https://beatandraise.com/sec-filings-api/docs" }, "servers": [ { "url": "https://beatandraise.com/api/v1" } ], "security": [ { "ApiKeyHeader": [] }, { "BearerKey": [] } ], "tags": [ { "name": "Filings" }, { "name": "Documents" }, { "name": "Structured data" }, { "name": "Checking figures and quotes" }, { "name": "Account" } ], "paths": { "/filings": { "get": { "operationId": "listFilings", "tags": [ "Filings" ], "summary": "List filings by company, form and date", "description": "Filing metadata, newest first, deduplicated per accession. Each filing's content_object lists its files (filename, doc_type, sequence, url on sec.gov; sequence 1 is the primary document). A file's beatandraise.com link is beatandraise_base_url + filename (sec_base_url + filename on sec.gov); the filing's source gives the primary document's links and a citation. 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": [ { "name": "cik", "in": "query", "description": "CIK, 10 digits with or without leading zeros.", "required": false, "schema": { "type": "string" }, "example": "0000320193" }, { "name": "form", "in": "query", "description": "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.", "required": false, "schema": { "type": "string" }, "example": "10-K" }, { "name": "from", "in": "query", "description": "Earliest date, YYYY-MM-DD.", "required": false, "schema": { "type": "string" }, "example": "2024-01-01" }, { "name": "to", "in": "query", "description": "Latest date, YYYY-MM-DD.", "required": false, "schema": { "type": "string" } }, { "name": "item", "in": "query", "description": "Only 8-Ks reporting these Items, by number as the 8-K header states it (\"5.02\"), up to 10 comma-separated, matching any (\"1.01,2.01\"). Defaults form to 8-K and 8-K/A. Numbered since 2004-08-23.", "required": false, "schema": { "type": "string" }, "example": "5.02" }, { "name": "item_text", "in": "query", "description": "Items whose text each filing returns in item_texts (item, title, text, highlight_url), for any 10-K, 10-Q or 8-K: by number or name, up to 5 comma-separated (\"MD&A\", \"1A\", \"Part II Item 1A\", \"5.02\"). A filing without the Item says \"not in this filing\". At most 25 filings per call, and the page is lowered to fit 500,000 characters of text.", "required": false, "schema": { "type": "string" }, "example": "MD&A" }, { "name": "include_item_text", "in": "query", "description": "true: return the text of the Items named in item=, as item_text would.", "required": false, "schema": { "type": "boolean", "default": false } }, { "name": "item_text_chars", "in": "query", "description": "Characters of text per Item, 1000-100000 (default 10000).", "required": false, "schema": { "type": "integer", "default": 10000, "minimum": 1000, "maximum": 100000 } }, { "name": "limit", "in": "query", "description": "Results per call (1-1000, default 100; at most 25 with item text).", "required": false, "schema": { "type": "integer", "default": 100 } }, { "name": "offset", "in": "query", "description": "Pagination offset.", "required": false, "schema": { "type": "integer", "default": 0 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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", "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", "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/a10-kexhibit4109272025.htm" } ], "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" }, "sec_base_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/", "beatandraise_base_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/" }, { "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", "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm" }, { "description": "EX-4.1", "doc_type": "EX-4.1", "filename": "a10-kexhibit4109282024.htm", "markdown_exists": 1, "sequence": "2", "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/a10-kexhibit4109282024.htm" } ], "filing_date": "2024-11-01T00:00:00Z", "form": "10-K", "source": { "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm", "filing_index_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.htm", "beatandraise_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-24-000123/aapl-20240928.htm", "citation": "Apple Inc., Form 10-K, filed 2024-11-01, https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm" }, "sec_base_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/", "beatandraise_base_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-24-000123/" } ], "limit": 2, "offset": 0 } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/filing/{accession}": { "get": { "operationId": "getFiling", "tags": [ "Filings" ], "summary": "One filing: metadata and every file", "description": "The filing's metadata and content_object (every document, exhibit, XBRL page and image), with the filing's source, and sec_base_url / beatandraise_base_url (+ a filename = that file's link).", "parameters": [ { "name": "accession", "in": "path", "description": "SEC accession number, as 0000320193-25-000079.", "required": true, "schema": { "type": "string" }, "example": "0000320193-25-000079" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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", "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", "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/a10-kexhibit4109272025.htm" } ], "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" }, "sec_base_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/", "beatandraise_base_url": "https://beatandraise.com/cik/0000320193/accessionNumber/0000320193-25-000079/" } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/filing/{accession}/tables": { "get": { "operationId": "listFilingTables", "tags": [ "Filings" ], "summary": "The XBRL financial-table pages of a filing", "description": "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": [ { "name": "accession", "in": "path", "description": "SEC accession number, as 0000320193-25-000079.", "required": true, "schema": { "type": "string" }, "example": "0000320193-25-000079" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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 } ] } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/files/{accession}": { "get": { "operationId": "listFiles", "tags": [ "Filings" ], "summary": "The files a filing lists, with download links", "description": "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": [ { "name": "accession", "in": "path", "description": "SEC accession number, as 0000320193-25-000079.", "required": true, "schema": { "type": "string" }, "example": "0000320193-25-000079" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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" } ] } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/files/{accession}/{filename}": { "get": { "operationId": "downloadFile", "tags": [ "Filings" ], "summary": "Download one file exactly as stored", "description": "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": [ { "name": "accession", "in": "path", "description": "SEC accession number, as 0000320193-25-000079.", "required": true, "schema": { "type": "string" }, "example": "0000320193-25-000079" }, { "name": "filename", "in": "path", "description": "A file of the filing, as its content_object or /files lists it.", "required": true, "schema": { "type": "string" }, "example": "aapl-20250927.htm" } ], "responses": { "200": { "description": "OK", "content": { "application/octet-stream": { "schema": { "type": "string" }, "example": "" } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/search": { "get": { "operationId": "searchFilings", "tags": [ "Filings" ], "summary": "Full-text search across filings", "description": "Relevance-ranked search over filing documents since 2020 (Forms 3/4/5, 144, N-PORT, 13F and D are not indexed), with facets by form and year. With limit 10 or less (the default), each result carries an excerpt: about 400 characters of the document where the most query terms meet (none if the terms are not in its text, or its text did not arrive within a second). Every occurrence: /document/search/{cik}/{accession} (search_document). A year before 2020 finds nothing and the response carries a coverage_note saying how to read older filings (/filings, then /document).", "parameters": [ { "name": "q", "in": "query", "description": "Search words (\"cybersecurity incident\", \"supply chain risk\").", "required": true, "schema": { "type": "string" }, "example": "supply chain risk" }, { "name": "form", "in": "query", "description": "Only this form type.", "required": false, "schema": { "type": "string" }, "example": "10-K" }, { "name": "cik", "in": "query", "description": "CIK, 10 digits with or without leading zeros.", "required": false, "schema": { "type": "string" }, "example": "0000320193" }, { "name": "year", "in": "query", "description": "Only this filing year.", "required": false, "schema": { "type": "string" }, "example": "2025" }, { "name": "limit", "in": "query", "description": "Results per call (1-100, default 10). Up to 10, each result carries an excerpt; above 10, none.", "required": false, "schema": { "type": "integer", "default": 10 } }, { "name": "page", "in": "query", "description": "Page, from 0.", "required": false, "schema": { "type": "integer", "default": 0 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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" } } }, "response": { "docs": [ { "accession_number": "0000723125-25-000028", "cik": "0000723125", "company_names": [ "MICRON TECHNOLOGY INC" ], "excerpt": "…REQUIREMENTS SUBJECT TO CURE PERIOD Section 3.1 Economic and National Security Objectives . 3.1.1 [***] 3.1.2 [***] 3.1.3 Supply Chain Security . (a) Each Recipient shall implement and comply with (including through the provision of adequate resources and staffing) supply chain risk management plans, policies and procedures for each Project, which shall include, at a minimum, the following elements:…", "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" ], "excerpt": "…REQUIREMENTS SUBJECT TO CURE PERIOD Section 3.1 Economic and National Security Objectives . 3.1.1 [***] 3.1.2 [***] 3.1.3 Supply Chain Security . (a) Each Recipient shall implement and comply with (including through the provision of adequate resources and staffing) supply chain risk management plans, policies and procedures for each Project, which shall include, at a minimum, the following elements:…", "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, "start": 0 }, "responseHeader": { "QTime": 224, "params": { "bq": [ "filing_date:[NOW-1YEAR TO NOW]^10", "filing_date:[NOW-3YEAR TO NOW-1YEAR]^5" ], "defType": "edismax", "facet": "true", "facet.field": [ "form", "cik" ], "facet.limit": "20", "facet.mincount": "1", "facet.range": "filing_date", "facet.range.end": "NOW+1YEAR", "facet.range.gap": "+1YEAR", "facet.range.start": "2000-01-01T00:00:00Z", "facet.sort": "count", "fl": "id,cik,accession_number,filename,form,filing_date,company_names,ticker,score", "fq": [ "form:\"10-K\"", "filing_date:[2025-01-01T00:00:00Z TO 2025-12-31T23:59:59Z]" ], "mm": "100%", "pf": "content^3", "pf2": "content^2", "q": "supply chain risk", "qf": "content company_names^2", "rows": "2", "sort": "score desc, filing_date desc", "start": "0" }, "status": 0 } } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/document/{cik}/{accession}/{filename}": { "get": { "operationId": "getDocument", "tags": [ "Documents" ], "summary": "A document as markdown or HTML", "description": "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": [ { "name": "cik", "in": "path", "description": "Company or filer CIK, 10 digits with leading zeros (\"0000320193\") or without (\"320193\").", "required": true, "schema": { "type": "string" }, "example": "0000320193" }, { "name": "accession", "in": "path", "description": "SEC accession number, as 0000320193-25-000079.", "required": true, "schema": { "type": "string" }, "example": "0000320193-25-000079" }, { "name": "filename", "in": "path", "description": "A file of the filing, as its content_object or /files lists it.", "required": true, "schema": { "type": "string" }, "example": "aapl-20250927.htm" }, { "name": "get_markdown", "in": "query", "description": "false for the HTML as filed.", "required": false, "schema": { "type": "boolean", "default": true } } ], "responses": { "200": { "description": "OK", "content": { "text/markdown": { "schema": { "type": "string" }, "example": "xml version='1.0' encoding='ASCII'?\nXBRL Document Created with the Workiva Platform\nCopyright 2025 Workiva\nr:b93d322a-f6d3-4356-8a13-e3e1c42e12bd,g:44705cc3-5a3a-440a-975b-ed1d3694d858,d:719388195b384d85a4e238ad88eba90a\nfalse\n2025\nFY\n0000320193\nP1Y\nP1Y\nP1Y\nP1Y\nhttp://fasb.org/us-gaap/2025#LongTermDebtNoncurrent\nhttp://fasb.org/us-gaap/2025#LongTermDebtNoncurrent\nhttp://fasb.org/us-gaap/2025#OtherAssetsNoncurrent\nhttp://fasb.org/us-gaap/2025#OtherAssetsNoncurrent\nhttp://fasb.org/us-gaap/2025#PropertyPlantAndEquipmentNet\nhttp://fasb.org/us-gaap/2025#PropertyPlantAndEquipmentNet\nhttp://fasb.org/us-gaap/2025#OtherLiabilitiesCurrent\nhttp://fasb.org/us-gaap/2025#OtherLiabilitiesCurrent\nhttp://fasb.org/us-gaap/2025#OtherLiabilitiesNoncurrent\nhttp://fasb.org/us-gaap/2025#OtherLiabilitiesNoncurrent\nhttp://fasb.org/us-gaap/2025#OtherLiabilitiesCurrent\nhttp://fasb.org/us-gaap/2025#OtherLiabilitiesCurrent\nhttp://fasb.org/us-gaap/2025#OtherLiabilitiesNoncurrent\nhttp://fasb.org/us-gaap/2025#OtherLiabilitiesNoncurrent\niso4217:USD\nxbrli:shares\niso4217:USD\nxbrli:shares\nxbrli:pure\naapl:Customer\naapl:Vendor\naapl:Subsidiary\n0000320193\n2024-09-29\n2025-09-27\n0000320193\nus-gaap:CommonStockMember\n2024-09-29\n2025-09-27\n0000320193\naapl:A0.000Notesdue2025Member\n2024-09-29\n2025-09-27\n0000320193\naapl:A1.625NotesDue2026Member\n2024-09-29\n2025-09-27\n0000320193\naapl:A2.000NotesDue2027Member\n2024-09-29\n2025-09-27\n0000320193\naapl:A1.375NotesDue2029Member\n2024-09-29\n2025-09-27\n0000320193\naapl:A3.050NotesDue2029\n…" } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/items/{accession}": { "get": { "operationId": "listItems", "tags": [ "Documents" ], "summary": "The Items of a 10-K, 10-Q or 8-K", "description": "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": [ { "name": "accession", "in": "path", "description": "SEC accession number, as 0000320193-25-000079.", "required": true, "schema": { "type": "string" }, "example": "0000320193-25-000079" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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" } } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/items/{accession}/{item}": { "get": { "operationId": "getItem", "tags": [ "Documents" ], "summary": "One Item of a 10-K, 10-Q or 8-K", "description": "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": [ { "name": "accession", "in": "path", "description": "SEC accession number, as 0000320193-25-000079.", "required": true, "schema": { "type": "string" }, "example": "0000320193-25-000079" }, { "name": "item", "in": "path", "description": "A number (\"1A\", \"7\", \"2.02\") or a name (\"Risk Factors\", \"MD&A\"); URL-encode it.", "required": true, "schema": { "type": "string" }, "example": "1A" }, { "name": "part", "in": "query", "description": "10-Q only: \"I\" or \"II\" when the number is in both parts.", "required": false, "schema": { "type": "string", "enum": [ "I", "II" ] } }, { "name": "format", "in": "query", "description": "html for the HTML fragment.", "required": false, "schema": { "type": "string", "enum": [ "html" ] } } ], "responses": { "200": { "description": "OK", "content": { "text/markdown": { "schema": { "type": "string" }, "example": "Item 1A.    Risk Factors\nThe 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.\nThis 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.\nMacroeconomic and Industry Risks\nThe 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.\nThe 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 \n…" } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/document/search/{cik}/{accession}": { "get": { "operationId": "searchFiling", "tags": [ "Documents" ], "summary": "Search inside a filing", "description": "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": [ { "name": "cik", "in": "path", "description": "Company or filer CIK, 10 digits with leading zeros (\"0000320193\") or without (\"320193\").", "required": true, "schema": { "type": "string" }, "example": "0000320193" }, { "name": "accession", "in": "path", "description": "SEC accession number, as 0000320193-25-000079.", "required": true, "schema": { "type": "string" }, "example": "0000320193-25-000079" }, { "name": "q", "in": "query", "description": "Terms, comma-separated.", "required": true, "schema": { "type": "string" }, "example": "iPhone net sales" }, { "name": "context", "in": "query", "description": "Lines of context around each match (0-50, default 10).", "required": false, "schema": { "type": "integer", "default": 10 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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 } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/document/search/{cik}/{accession}/{filename}": { "get": { "operationId": "searchDocument", "tags": [ "Documents" ], "summary": "Search inside one document", "description": "As above, in one document.", "parameters": [ { "name": "cik", "in": "path", "description": "Company or filer CIK, 10 digits with leading zeros (\"0000320193\") or without (\"320193\").", "required": true, "schema": { "type": "string" }, "example": "0000320193" }, { "name": "accession", "in": "path", "description": "SEC accession number, as 0000320193-25-000079.", "required": true, "schema": { "type": "string" }, "example": "0000320193-25-000079" }, { "name": "filename", "in": "path", "description": "A file of the filing, as its content_object or /files lists it.", "required": true, "schema": { "type": "string" }, "example": "aapl-20250927.htm" }, { "name": "q", "in": "query", "description": "Terms, comma-separated.", "required": true, "schema": { "type": "string" }, "example": "iPhone net sales" }, { "name": "context", "in": "query", "description": "Lines of context (0-50, default 10).", "required": false, "schema": { "type": "integer", "default": 10 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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 } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/form-data": { "get": { "operationId": "getFormData", "tags": [ "Structured data" ], "summary": "Every filing of an XML form, every field", "description": "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": [ { "name": "cik", "in": "query", "description": "CIK, 10 digits with or without leading zeros.", "required": true, "schema": { "type": "string" }, "example": "0000320193" }, { "name": "form", "in": "query", "description": "Form type as filed: \"4\", \"144\", \"SCHEDULE 13G\", \"D\"…", "required": true, "schema": { "type": "string" }, "example": "4" }, { "name": "from", "in": "query", "description": "Earliest date, YYYY-MM-DD.", "required": false, "schema": { "type": "string" }, "example": "2024-01-01" }, { "name": "to", "in": "query", "description": "Latest date, YYYY-MM-DD.", "required": false, "schema": { "type": "string" } }, { "name": "format", "in": "query", "description": "json or xml.", "required": false, "schema": { "type": "string", "enum": [ "json", "xml" ], "default": "json" } }, { "name": "compact", "in": "query", "description": "Drop \"#order\".", "required": false, "schema": { "type": "boolean", "default": false } }, { "name": "amendments", "in": "query", "description": "Include /A filings.", "required": false, "schema": { "type": "boolean", "default": true } }, { "name": "limit", "in": "query", "description": "Filings per call (json 1-100, xml 1-50, default 20).", "required": false, "schema": { "type": "integer", "default": 20 } }, { "name": "cursor", "in": "query", "description": "next_cursor from the previous call.", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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/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" } } ], "format": "json", "forms": [ "4", "4/A" ], "next_cursor": "2026-10-15_0001140361-26-039785" } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/statements/{cik}/{accession}": { "get": { "operationId": "getStatements", "tags": [ "Structured data" ], "summary": "Financial statements of one 10-K or 10-Q", "description": "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": [ { "name": "cik", "in": "path", "description": "Company or filer CIK, 10 digits with leading zeros (\"0000320193\") or without (\"320193\").", "required": true, "schema": { "type": "string" }, "example": "0000320193" }, { "name": "accession", "in": "path", "description": "SEC accession number, as 0000320193-25-000079.", "required": true, "schema": { "type": "string" }, "example": "0000320193-25-000079" }, { "name": "include_tags", "in": "query", "description": "Add tagged lines (about 5x larger).", "required": false, "schema": { "type": "boolean", "default": false } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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/0000320193/accessionNumber/0000320193-25-000079/R8.htm" } } ] } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/financial-history": { "get": { "operationId": "getFinancialHistory", "tags": [ "Structured data" ], "summary": "Statements from a company's last several reports", "description": "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": [ { "name": "cik", "in": "query", "description": "CIK, 10 digits with or without leading zeros.", "required": true, "schema": { "type": "string" }, "example": "0000320193" }, { "name": "period", "in": "query", "description": "annual or quarterly.", "required": false, "schema": { "type": "string", "enum": [ "annual", "quarterly" ], "default": "annual" } }, { "name": "statements", "in": "query", "description": "Comma-separated subset: income_statement, balance_sheet, cash_flow, equity, comprehensive_income.", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Number of filings.", "required": false, "schema": { "type": "integer" } }, { "name": "before", "in": "query", "description": "Only filings filed on or before this date (YYYY-MM-DD).", "required": false, "schema": { "type": "string" } }, { "name": "fiscal_year", "in": "query", "description": "Fiscal year as the company states it.", "required": false, "schema": { "type": "integer" } }, { "name": "fiscal_period", "in": "query", "description": "Q1, Q2, Q3 or FY (no Q4: it is in the annual report).", "required": false, "schema": { "type": "string", "enum": [ "Q1", "Q2", "Q3", "FY" ] } }, { "name": "include_tags", "in": "query", "description": "Add tagged lines.", "required": false, "schema": { "type": "boolean", "default": false } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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…" } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/get-statements": { "get": { "operationId": "getStatementsByPeriod", "tags": [ "Structured data" ], "summary": "Experimental: a statement period by period", "description": "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": [ { "name": "cik", "in": "query", "description": "CIK or ticker.", "required": true, "schema": { "type": "string" }, "example": "AAPL" }, { "name": "statement", "in": "query", "description": "Which statement.", "required": true, "schema": { "type": "string", "enum": [ "income", "cash_flow", "balance_sheet" ] }, "example": "income" }, { "name": "period", "in": "query", "description": "quarterly or annual.", "required": true, "schema": { "type": "string", "enum": [ "quarterly", "annual" ] }, "example": "annual" }, { "name": "from", "in": "query", "description": "Earliest date, YYYY-MM-DD.", "required": false, "schema": { "type": "string" }, "example": "2024-01-01" }, { "name": "to", "in": "query", "description": "Latest date, YYYY-MM-DD.", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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" } ] } ] } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/insider-transactions": { "get": { "operationId": "getInsiderTransactions", "tags": [ "Structured data" ], "summary": "Form 4 insider transactions", "description": "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. Every row has plan_10b5_1, the filing's Rule 10b5-1 checkbox as filed (null before the box existed in 2023; filers sometimes name a plan only in a footnote); include_footnotes=true adds each line's footnotes. cik is the issuer, not the insider.", "parameters": [ { "name": "cik", "in": "query", "description": "CIK, 10 digits with or without leading zeros.", "required": true, "schema": { "type": "string" }, "example": "0000320193" }, { "name": "from", "in": "query", "description": "Earliest date, YYYY-MM-DD.", "required": false, "schema": { "type": "string" }, "example": "2024-01-01" }, { "name": "to", "in": "query", "description": "Latest date, YYYY-MM-DD.", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Results per call (1-100, default 20).", "required": false, "schema": { "type": "integer", "default": 20 } }, { "name": "offset", "in": "query", "description": "Pagination offset.", "required": false, "schema": { "type": "integer", "default": 0 } }, { "name": "include_table_ii", "in": "query", "description": "Add Table II lines.", "required": false, "schema": { "type": "boolean", "default": false } }, { "name": "include_footnotes", "in": "query", "description": "Add to each line the footnotes it points to ({id, text}, as filed). Filings from 2024 on.", "required": false, "schema": { "type": "boolean", "default": false } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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", "plan_10b5_1": true, "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", "plan_10b5_1": true, "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" } } ] } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/insiders": { "get": { "operationId": "getInsiderTotals", "tags": [ "Structured data" ], "summary": "In development: insider trading totals", "description": "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": [ { "name": "cik", "in": "query", "description": "CIK, 10 digits with or without leading zeros.", "required": false, "schema": { "type": "string" }, "example": "0000320193" }, { "name": "owner", "in": "query", "description": "An insider's CIK, instead of cik.", "required": false, "schema": { "type": "string" } }, { "name": "months", "in": "query", "description": "Look-back in months.", "required": false, "schema": { "type": "integer" }, "example": 6 } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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", "source": { "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", "citation": "Apple Inc., Form 4, filed 2026-10-15, https://www.sec.gov/Archives/edgar/data/320193/000114036126039785/0001140361-26-039785-index.htm" } } ], "events_total": 61 } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/shares-outstanding": { "get": { "operationId": "getSharesOutstanding", "tags": [ "Structured data" ], "summary": "Shares outstanding over time, and splits", "description": "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": [ { "name": "cik", "in": "query", "description": "CIK, 10 digits with or without leading zeros.", "required": true, "schema": { "type": "string" }, "example": "0000320193" }, { "name": "share_class", "in": "query", "description": "Only this class, as returned in share_class.", "required": false, "schema": { "type": "string" } }, { "name": "from", "in": "query", "description": "Earliest date, YYYY-MM-DD.", "required": false, "schema": { "type": "string" }, "example": "2024-01-01" }, { "name": "to", "in": "query", "description": "Latest date, YYYY-MM-DD.", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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": [] } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/holdings/{cik}": { "get": { "operationId": "getHoldings", "tags": [ "Structured data" ], "summary": "A 13F manager's positions", "description": "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": [ { "name": "cik", "in": "path", "description": "The 13F filer's CIK.", "required": true, "schema": { "type": "string" }, "example": "0001067983" }, { "name": "period", "in": "query", "description": "As of this date (YYYY-MM-DD): the latest 13F filed on or before it.", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Results per call (1-5000, default 500).", "required": false, "schema": { "type": "integer", "default": 500 } }, { "name": "offset", "in": "query", "description": "Pagination offset.", "required": false, "schema": { "type": "integer", "default": 0 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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 } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/institutional-holders/{company}": { "get": { "operationId": "getInstitutionalHolders", "tags": [ "Structured data" ], "summary": "Who holds a company (13F)", "description": "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": [ { "name": "company", "in": "path", "description": "Ticker or CIK of the company held.", "required": true, "schema": { "type": "string" }, "example": "AAPL" }, { "name": "quarters", "in": "query", "description": "Complete quarters (1-12, default 4).", "required": false, "schema": { "type": "integer", "default": 4 } }, { "name": "holder", "in": "query", "description": "A 13F filer to follow: name fragment or CIK.", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Results per call (1-100, default 25).", "required": false, "schema": { "type": "integer", "default": 25 } }, { "name": "detail", "in": "query", "description": "lean or full (default full, lean with holder).", "required": false, "schema": { "type": "string", "enum": [ "lean", "full" ] } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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": 26614323, "change_shares": -26511904, "pct_of_class": 0 } ], "largest_new_positions": [ { "filer_cik": "0001374170", "filer_name": "NORGES BANK", "shares": 190726866, "prev_shares": null, "change_shares": 190726866, "pct_of_class": 1.31 }, { "filer_cik": "0002146052", "filer_name": "Jupiter Topco LLC", "shares": 18591210, "prev_shares": null, "change_shares": 18591210, "pct_of_class": 0.13 } ], "largest_exits": [ { "filer_cik": "0001274173", "filer_name": "JANUS HENDERSON GROUP PLC", "shares": 0, "prev_shares": 26916594, "change_shares": -26916594, "pct_of_class": 0 }, { "filer_cik": "0001103804", "filer_name": "VIKING GLOBAL INVESTORS LP", "shares": 0, "prev_shares": 3593057, "change_shares": -3593057, "pct_of_class": 0 } ], "large_holders_5pct": [ { "reporting_person": "Vanguard Capital Management", "form": "SCHEDULE 13G", "filing_date": "2026-04-29", "event_date": "2026-03-31", "shares": 1099168953, "class_percent": 7.48, "accession_number": "0002100119-26-000139" }, { "reporting_person": "The Vanguard Group", "form": "SCHEDULE 13G/A", "filing_date": "2026-03-26", "event_date": "2026-03-13", "shares": 0, "class_percent": 0, "accession_number": "0000102909-26-000630" } ], "source": { "filing_index_url": "", "beatandraise_url": "https://beatandraise.com/cik/0000320193/holders" }, "notes": [ "13F positions are reported as filed by each manager, one row per legal filer; they are not deduplicated (one firm can file as several entities) and exclude options.", "Each share class is compared with its own shares outstanding; classes are never added together. An unlisted class (e.g. founder shares) cannot be held by 13F filers." ] } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/company/search": { "get": { "operationId": "searchCompanies", "tags": [ "Structured data" ], "summary": "Find a company by name or ticker", "description": "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": [ { "name": "q", "in": "query", "description": "Name or ticker.", "required": true, "schema": { "type": "string" }, "example": "apple" }, { "name": "limit", "in": "query", "description": "Results per call (1-50, default 10).", "required": false, "schema": { "type": "integer", "default": 10 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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" ] } ] } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/company/{cik}": { "get": { "operationId": "getCompany", "tags": [ "Structured data" ], "summary": "A company: names, tickers, industry", "description": "Names (newest first), tickers, SIC code and title, fiscal year end (MMDD), state of incorporation, succession_filing.", "parameters": [ { "name": "cik", "in": "path", "description": "Company or filer CIK, 10 digits with leading zeros (\"0000320193\") or without (\"320193\").", "required": true, "schema": { "type": "string" }, "example": "0000320193" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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" ] } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/fiscal-calendar": { "get": { "operationId": "getFiscalCalendar", "tags": [ "Structured data" ], "summary": "A company's fiscal calendar: every quarter it reported", "description": "Every quarter of a company's 10-K/10-Q reports, oldest first, with the company's own dates: period_start (the day after the previous quarter's end), period_end (the report's), fiscal_year and fiscal_quarter by position (Q4 = the annual report), the cover page's own fy/fp as filed, months, and the report's accession number (its page: beatandraise_base_url + accession_number). Irregular quarters are flagged, never corrected. Apple's quarters end on a Saturday and move each year; ask by fiscal_year rather than guessing dates.", "parameters": [ { "name": "cik", "in": "query", "description": "CIK, 10 digits with or without leading zeros.", "required": true, "schema": { "type": "string" }, "example": "0000320193" }, { "name": "fiscal_year", "in": "query", "description": "Only this fiscal year (by position: the quarters closed by that year's annual report).", "required": false, "schema": { "type": "integer" }, "example": 2024 }, { "name": "from", "in": "query", "description": "Earliest period end, YYYY-MM-DD.", "required": false, "schema": { "type": "string" } }, { "name": "to", "in": "query", "description": "Latest period end, YYYY-MM-DD.", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "The newest N quarters in the window, returned oldest first (1-400, default 40).", "required": false, "schema": { "type": "integer", "default": 40 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "beatandraise_base_url": "https://beatandraise.com/cik/0000320193/accessionNumber/", "cik": "0000320193", "company": "Apple Inc.", "count": 3, "latest_fiscal_year_end": "2025-09-27", "note": "Each quarter is the company's own: from the day after the previous quarter's period end to its report's period end (10-Q, or the 10-K for Q4), in the order the company reported. Typed column start dates are not used. fiscal_year and fiscal_quarter are by position after the previous annual report; co…", "quarters": [ { "fiscal_year": 2026, "fiscal_quarter": 1, "period_start": "2025-09-28", "period_end": "2025-12-27", "months": 3, "form": "10-Q", "filing_date": "2026-01-30", "accession_number": "0000320193-26-000006", "cover_fiscal_year": 2026, "cover_fiscal_period": "Q1" }, { "fiscal_year": 2026, "fiscal_quarter": 2, "period_start": "2025-12-28", "period_end": "2026-03-28", "months": 3, "form": "10-Q", "filing_date": "2026-05-01", "accession_number": "0000320193-26-000013", "cover_fiscal_year": 2026, "cover_fiscal_period": "Q2" }, { "fiscal_year": 2026, "fiscal_quarter": 3, "period_start": "2026-03-29", "period_end": "2026-06-27", "months": 3, "form": "10-Q", "filing_date": "2026-07-31", "accession_number": "0000320193-26-000020", "cover_fiscal_year": 2026, "cover_fiscal_period": "Q3" } ] } } } }, "400": { "description": "Bad cik, fiscal_year, date or limit", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or missing API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/identifiers": { "get": { "operationId": "getIdentifiers", "tags": [ "Structured data" ], "summary": "CIK, ticker or CUSIP: given one, the others, with former tickers", "description": "Give exactly one of cik, ticker or cusip. Returns, per company: tickers, its tickers in the SEC's ticker lists today; former_tickers, tickers those lists had for it and no longer do (kept since 2026-10-20); filed_symbols, every trading symbol its own 10-K/10-Q cover pages state (required since June 2019), as filed, with the first and last filing and a source; and securities, its CUSIPs, each tied to the issuer by a 13D/G cover page, N-PORT holdings or the CUSIP issuer number (issuer_link). reported_tickers is what N-PORT filers report for a CUSIP, counted by fund series, as filed; ticker is set only when at least two thirds of them give one of the issuer's SEC tickers and no other CUSIP of the issuer is reported under it more often, so a share class gets its own ticker (GOOGL, GOOG, BRK-A, BRK-B) and a bond, which funds report under its issuer's ticker, gets none. Tickers are reused: ticker= returns the company that has it in the SEC's lists today first, then every company that had it before (FB: a ProShares fund, then Meta, whose cover pages state FB until April 2022), each with matched_by. A ticker found nowhere is a 404: find the company by name with /company/search. About 80% of exchange-listed companies have at least one CUSIP here.", "parameters": [ { "name": "ticker", "in": "query", "description": "A ticker, e.g. GOOGL. BRK.B and BRK/B are read as BRK-B, the SEC's spelling.", "required": false, "schema": { "type": "string" }, "example": "BRK.B" }, { "name": "cik", "in": "query", "description": "CIK, 1-10 digits with or without leading zeros.", "required": false, "schema": { "type": "string" } }, { "name": "cusip", "in": "query", "description": "A 9-character CUSIP with a valid check digit (an 8-digit one is read as having lost its leading zero).", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "Tickers and securities per company, 1-500 (default 50). tickers_total and securities_total say how many there are.", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "note": "tickers: the SEC's ticker lists today; former_tickers: what they listed before (kept since 2026-10-20); filed_symbols: every trading symbol the company's own 10-K/10-Q cover pages state (2019 on), as filed, with the filings. securities: CUSIPs tied to the issuer by a 13D/G cover page, N-PORT holdings or the CUSIP issuer number. reported_tickers: what N-PORT filers report for the CUSIP, by fund series, as filed; ticker is set only when most of them give one of the issuer's SEC tickers and no other of its CUSIPs is reported under it more often.", "query": { "cik": "", "cusip": "", "ticker": "BRK-B" }, "results": [ { "cik": "0001067983", "name": "BERKSHIRE HATHAWAY INC", "matched_by": "ticker (SEC ticker list)", "tickers": [ { "ticker": "BRK-A", "exchange": "NYSE", "kind": "exchange" }, { "ticker": "BRK-B", "exchange": "NYSE", "kind": "exchange" } ], "former_tickers": [], "filed_symbols": [ { "symbol": "BRK.A", "title": "Class A Common Stock", "exchange": "NYSE", "first_filed": "2019-11-04", "last_filed": "2026-08-10", "in_latest_filing": true, "first_accession_number": "0000950123-19-009995", "source": { "filing_index_url": "https://www.sec.gov/Archives/edgar/data/1067983/000119312526341032/0001193125-26-341032-index.htm", "beatandraise_url": "https://beatandraise.com/cik/0001067983/accessionNumber/0001193125-26-341032", "citation": "BERKSHIRE HATHAWAY INC, Form 10-Q, filed 2026-08-10, https://www.sec.gov/Archives/edgar/data/1067983/000119312526341032/0001193125-26-341032-index.htm" } }, { "symbol": "BRK.B", "title": "Class B Common Stock", "exchange": "NYSE", "first_filed": "2019-11-04", "last_filed": "2026-08-10", "in_latest_filing": true, "first_accession_number": "0000950123-19-009995", "source": { "filing_index_url": "https://www.sec.gov/Archives/edgar/data/1067983/000119312526341032/0001193125-26-341032-index.htm", "beatandraise_url": "https://beatandraise.com/cik/0001067983/accessionNumber/0001193125-26-341032", "citation": "BERKSHIRE HATHAWAY INC, Form 10-Q, filed 2026-08-10, https://www.sec.gov/Archives/edgar/data/1067983/000119312526341032/0001193125-26-341032-index.htm" } }, { "symbol": "BRK27", "title": "1.125% Senior Notes due 2027", "exchange": "NYSE", "first_filed": "2019-11-04", "last_filed": "2026-08-10", "in_latest_filing": true, "first_accession_number": "0000950123-19-009995", "source": { "filing_index_url": "https://www.sec.gov/Archives/edgar/data/1067983/000119312526341032/0001193125-26-341032-index.htm", "beatandraise_url": "https://beatandraise.com/cik/0001067983/accessionNumber/0001193125-26-341032", "citation": "BERKSHIRE HATHAWAY INC, Form 10-Q, filed 2026-08-10, https://www.sec.gov/Archives/edgar/data/1067983/000119312526341032/0001193125-26-341032-index.htm" } } ], "tickers_total": 2, "securities_total": 5, "securities": [ { "cusip": "084670702", "issuer_cik": "0001067983", "ticker": "BRK-B", "title_of_class": "CL B NEW", "issuer_link": "13D/G cover page", "evidence_from": "2026-03-26", "evidence_to": "2026-04-29", "reported_tickers": [ { "ticker": "BRK-B", "fund_series": 425 }, { "ticker": "BRK-B-US", "fund_series": 9 }, { "ticker": "BRKB", "fund_series": 1 } ] }, { "cusip": "084670108", "issuer_cik": "0001067983", "ticker": "BRK-A", "title_of_class": "CL A", "issuer_link": "13D/G cover page", "evidence_from": "2025-06-30", "evidence_to": "2026-07-15", "reported_tickers": [ { "ticker": "BRK-A", "fund_series": 27 }, { "ticker": "BRK-A-US", "fund_series": 1 } ] }, { "cusip": "084670BS6", "issuer_cik": "0001067983", "title_of_class": "BCO", "issuer_link": "CUSIP issuer number", "reported_tickers": [ { "ticker": "BRK", "fund_series": 1 } ] } ], "beatandraise_url": "https://beatandraise.com/cik/0001067983" } ] } } } }, "400": { "description": "Not exactly one of cik, ticker or cusip, or a malformed one (a CUSIP whose check digit fails).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Ticker not in the SEC's lists, a CUSIP no filing ties to an issuer, or an unknown CIK.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/sic": { "get": { "operationId": "listSic", "tags": [ "Structured data" ], "summary": "SIC industry codes and their companies", "description": "find=: matching SIC codes with company counts. code=: that code's companies, 100 per page, listed companies first. Neither: every code.", "parameters": [ { "name": "find", "in": "query", "description": "A word from the industry title.", "required": false, "schema": { "type": "string" }, "example": "software" }, { "name": "code", "in": "query", "description": "A 3-4 digit SIC code.", "required": false, "schema": { "type": "string" } }, { "name": "q", "in": "query", "description": "With code: name or ticker contains this.", "required": false, "schema": { "type": "string" } }, { "name": "page", "in": "query", "description": "With code: page from 1.", "required": false, "schema": { "type": "integer", "default": 1 } }, { "name": "listed", "in": "query", "description": "With code: 1 for companies with a ticker only.", "required": false, "schema": { "type": "string", "enum": [ "1" ] } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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 } ] } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/document/verify/{cik}/{accession}/{filename}": { "get": { "operationId": "verifyQuote", "tags": [ "Checking figures and quotes" ], "summary": "Is this sentence or figure in the document?", "description": "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": [ { "name": "cik", "in": "path", "description": "Company or filer CIK, 10 digits with leading zeros (\"0000320193\") or without (\"320193\").", "required": true, "schema": { "type": "string" }, "example": "0000320193" }, { "name": "accession", "in": "path", "description": "SEC accession number, as 0000320193-25-000079.", "required": true, "schema": { "type": "string" }, "example": "0000320193-25-000079" }, { "name": "filename", "in": "path", "description": "A file of the filing, as its content_object or /files lists it.", "required": true, "schema": { "type": "string" }, "example": "aapl-20250927.htm" }, { "name": "quote", "in": "query", "description": "The exact text (max 1,000 characters).", "required": true, "schema": { "type": "string" }, "example": "Total net sales" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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" } } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/document/verify-figure/{cik}/{accession}": { "get": { "operationId": "verifyFigure", "tags": [ "Checking figures and quotes" ], "summary": "Is this number in the filing, however written?", "description": "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": [ { "name": "cik", "in": "path", "description": "Company or filer CIK, 10 digits with leading zeros (\"0000320193\") or without (\"320193\").", "required": true, "schema": { "type": "string" }, "example": "0000320193" }, { "name": "accession", "in": "path", "description": "SEC accession number, as 0000320193-25-000079.", "required": true, "schema": { "type": "string" }, "example": "0000320193-25-000079" }, { "name": "value", "in": "query", "description": "The figure as you would state it.", "required": true, "schema": { "type": "string" }, "example": "$416.2 billion" }, { "name": "label", "in": "query", "description": "What it is, for ranking.", "required": false, "schema": { "type": "string" }, "example": "total net sales" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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" } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/document/verify-figure/{cik}/{accession}/{filename}": { "get": { "operationId": "verifyFigureInDocument", "tags": [ "Checking figures and quotes" ], "summary": "As above, in one document", "description": "verify-figure limited to one document.", "parameters": [ { "name": "cik", "in": "path", "description": "Company or filer CIK, 10 digits with leading zeros (\"0000320193\") or without (\"320193\").", "required": true, "schema": { "type": "string" }, "example": "0000320193" }, { "name": "accession", "in": "path", "description": "SEC accession number, as 0000320193-25-000079.", "required": true, "schema": { "type": "string" }, "example": "0000320193-25-000079" }, { "name": "filename", "in": "path", "description": "A file of the filing, as its content_object or /files lists it.", "required": true, "schema": { "type": "string" }, "example": "aapl-20250927.htm" }, { "name": "value", "in": "query", "description": "The figure.", "required": true, "schema": { "type": "string" }, "example": "$416.2 billion" }, { "name": "label", "in": "query", "description": "What it is.", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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" } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/document/figures/{cik}/{accession}/{filename}": { "get": { "operationId": "listFigures", "tags": [ "Checking figures and quotes" ], "summary": "Every number in a document, with its label", "description": "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": [ { "name": "cik", "in": "path", "description": "Company or filer CIK, 10 digits with leading zeros (\"0000320193\") or without (\"320193\").", "required": true, "schema": { "type": "string" }, "example": "0000320193" }, { "name": "accession", "in": "path", "description": "SEC accession number, as 0000320193-25-000079.", "required": true, "schema": { "type": "string" }, "example": "0000320193-25-000079" }, { "name": "filename", "in": "path", "description": "A file of the filing, as its content_object or /files lists it.", "required": true, "schema": { "type": "string" }, "example": "aapl-20250927.htm" }, { "name": "near", "in": "query", "description": "Only labels containing this.", "required": false, "schema": { "type": "string" }, "example": "total net sales" }, { "name": "limit", "in": "query", "description": "Results per call (1-2000, default 300).", "required": false, "schema": { "type": "integer", "default": 300 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "cite_as": "write [ref:] right after a number you take from here; [calc: ref:, ref:] 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 } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/check-citations": { "post": { "operationId": "checkCitations", "tags": [ "Checking figures and quotes" ], "summary": "Check every cited number in a draft", "description": "Write [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.", "parameters": [], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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": [] } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "text" ], "properties": { "text": { "type": "string", "description": "The draft (max ~200 KB)." } } }, "example": { "text": "Apple's net sales were $416.2 billion [ref:0000320193-25-000079/aapl-20250927.htm@122209+7]." } } } } } }, "/account": { "get": { "operationId": "getAccount", "tags": [ "Account" ], "summary": "Your plan, limits and usage this month", "description": "Free of charge: never counts as a call.", "parameters": [], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "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 } } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" } } } }, "/status": { "get": { "operationId": "getStatus", "tags": [ "Account" ], "summary": "Service status", "description": "Counts as a call.", "parameters": [], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object" }, "example": { "status": "ok" } } } }, "401": { "$ref": "#/components/responses/E401" }, "402": { "$ref": "#/components/responses/E402" }, "429": { "$ref": "#/components/responses/E429" }, "404": { "description": "Not found (no such filing, document or company).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } } }, "components": { "securitySchemes": { "ApiKeyHeader": { "type": "apiKey", "in": "header", "name": "X-API-Key", "description": "Your key from https://beatandraise.com/api-keys" }, "BearerKey": { "type": "http", "scheme": "bearer", "description": "The same key as a bearer token." } }, "schemas": { "Error": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" }, "create_key_url": { "type": "string" } } } }, "responses": { "E401": { "description": "No key, or an unknown, revoked or expired one (error: api_key_required, invalid_api_key). create_key_url says where to get one.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "api_key_required", "message": "An API key is required. Create one (free) at https://beatandraise.com/api-keys and send it in the X-API-Key header.", "create_key_url": "https://beatandraise.com/api-keys" } } } }, "E402": { "description": "The free plan's 100 successful calls are used (error: free_calls_used).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "E429": { "description": "Over a rate or download limit (rate_limited, download_rate_limited, daily_download_limit, monthly_download_quota). Wait Retry-After seconds.", "headers": { "Retry-After": { "schema": { "type": "integer" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }