Created by potrace 1.16, written by Peter Selinger 2001-2019
Get a free key
GET/filings

List filings by company, form and date

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

Parameters

query · string · optional

CIK, 10 digits with or without leading zeros.

query · string · optional

Form type as filed ("10-K", "8-K", "4", "13F-HR", "S-1"), or up to 20 comma-separated ("10-K,10-K/A"). Amendments are their own form types.

query · string · optional

Earliest date, YYYY-MM-DD.

query · string · optional

Latest date, YYYY-MM-DD.

query · integer · optional

Results per call (1-1000, default 100).

query · integer · optional

Pagination offset.

A real call: counts against your plan if it succeeds.

Request

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

Example response

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

A real response from the API, with arrays cut to two items.