Endpoints
/v1/form-8k/material-agreements
https://secfeedapi.com/v1/form-8k/material-agreements8-K Item 1.01 feed with the item text.
| Parameter | Type | Description | Example |
|---|---|---|---|
cik | integer | Only this filer's 8-Ks. | 1673481 |
startDate | string | Earliest filing date, YYYY-MM-DD. | 2026-09-01 |
endDate | string | Latest filing date, YYYY-MM-DD. | 2026-09-30 |
text | string | true (default) adds the item text to each row; false skips extraction and responds faster. Default true. | false |
size | integer | Rows per page, maximum 100. Default 20. | 2 |
from | integer | Offset for paging. Default 0. | 20 |
- Every 8-K and 8-K/A that reports Item 1.01, newest first.
- Item history starts in mid 2024 and is being backfilled toward 2004; the filing index itself goes back to 1993.
- Text extraction reads each 8-K document, so large pages with text are slower. Use text=false for counts and lists.
/v1/form-8k
https://secfeedapi.com/v1/form-8k8-K filings classified by item, with item text on request.
| Parameter | Type | Description | Example |
|---|---|---|---|
item | string | Item number, for example 4.02. Omit to list every 8-K. | 1.01 |
cik | integer | Only this filer's 8-Ks. | 1842556 |
startDate | string | Earliest filing date, YYYY-MM-DD. | 2026-10-01 |
endDate | string | Latest filing date, YYYY-MM-DD. | 2026-10-31 |
text | string | true adds the item text (only when item is set). Default false. | true |
size | integer | Rows per page, maximum 100. Default 50. | 2 |
from | integer | Offset for paging. Default 0. | 50 |
- The general endpoint behind every item feed. Without text=true it returns the item list only, which is fast for scanning many filings.
Request examples
Every response below is real output from the API, trimmed to the first records.
Latest Item 1.01 material agreements with the item text
Each row lists every item in the 8-K. text holds the extracted item; textError explains when extraction failed.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/form-8k/material-agreements?size=2"
import os, requests
r = requests.get(
"https://secfeedapi.com/v1/form-8k/material-agreements",
params={'size': '2'},
headers={"Authorization": f"Bearer {os.environ['SECFEED_KEY']}"},
timeout=60,
)
r.raise_for_status()
print(r.json()){
"total": 37691,
"filings": [
{
"accession": "0000950103-26-015465",
"cik": 1771910,
"company": "ADC Therapeutics SA",
"form": "8-K",
"filed": "2026-10-13",
"period": "2026-10-07",
"items": [
{
"item": "1.01",
"title": "Entry into a Material Definitive Agreement"
},
{
"item": "2.02",
"title": "Results of Operations and Financial Condition"
}
],
"url": "https://www.sec.gov/Archives/edgar/data/1771910/000095010326015465/0000950103-26-015465-index.htm",
"text": "Item 1.01. Entry into a Material Definitive Agreement.\n\nPrivate Placement \n\nOn October 7, 2026, ADC Therapeutics SA (the\n“Company”) entered into securities purchase agreements for the sale of its equity securities to certain institutional\ninvestors in a $86.6 million (assuming th..."
},
{
"accession": "0000950103-26-015480",
"cik": 1830043,
"company": "Bumble Inc.",
"form": "8-K",
"filed": "2026-10-13",
"period": "2026-10-12",
"items": [
{
"item": "1.01",
"title": "Entry into a Material Definitive Agreement"
},
{
"item": "7.01",
"title": "Regulation FD Disclosure"
}
],
"url": "https://www.sec.gov/Archives/edgar/data/1830043/000095010326015480/0000950103-26-015480-index.htm",
"text": "Item 1.01 Entry into a Material Definitive Agreement. \n\nMerger Agreement \n\nOn October 12, 2026, Bumble Inc., a Delaware\ncorporation (“Bumble” or the “Company”),\nentered into an Agreement and Plan of Merger (the “Merger Agreement”) by\nand among the Company, Buzz Holdings L.P., (“O..."
}
]
}The same feed without text, for fast listing
Skips document extraction. total gives the number of matching 8-Ks.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/form-8k/material-agreements?size=5&text=false"
import os, requests
r = requests.get(
"https://secfeedapi.com/v1/form-8k/material-agreements",
params={'size': '5', 'text': 'false'},
headers={"Authorization": f"Bearer {os.environ['SECFEED_KEY']}"},
timeout=60,
)
r.raise_for_status()
print(r.json()){
"total": 37692,
"filings": [
{
"accession": "0000950103-26-015465",
"cik": 1771910,
"company": "ADC Therapeutics SA",
"form": "8-K",
"filed": "2026-10-13",
"period": "2026-10-07",
"items": [
{
"item": "1.01",
"title": "Entry into a Material Definitive Agreement"
},
{
"item": "2.02",
"title": "Results of Operations and Financial Condition"
}
],
"url": "https://www.sec.gov/Archives/edgar/data/1771910/000095010326015465/0000950103-26-015465-index.htm"
},
{
"accession": "0000950103-26-015480",
"cik": 1830043,
"company": "Bumble Inc.",
"form": "8-K",
"filed": "2026-10-13",
"period": "2026-10-12",
"items": [
{
"item": "1.01",
"title": "Entry into a Material Definitive Agreement"
},
{
"item": "7.01",
"title": "Regulation FD Disclosure"
}
],
"url": "https://www.sec.gov/Archives/edgar/data/1830043/000095010326015480/0000950103-26-015480-index.htm"
}
]
}Item 1.01 filings in one week
A date window with text=false lists the week's new agreements quickly.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/form-8k/material-agreements?startDate=2026-10-05&endDate=2026-10-09&text=false&size=5"
import os, requests
r = requests.get(
"https://secfeedapi.com/v1/form-8k/material-agreements",
params={'startDate': '2026-10-05', 'endDate': '2026-10-09', 'text': 'false', 'size': '5'},
headers={"Authorization": f"Bearer {os.environ['SECFEED_KEY']}"},
timeout=60,
)
r.raise_for_status()
print(r.json()){
"total": 234,
"filings": [
{
"accession": "0000024090-26-000045",
"cik": 24090,
"company": "CITIZENS, INC.",
"form": "8-K",
"filed": "2026-10-09",
"period": "2026-10-05",
"items": [
{
"item": "1.01",
"title": "Entry into a Material Definitive Agreement"
},
{
"item": "9.01",
"title": "Financial Statements and Exhibits"
}
],
"url": "https://www.sec.gov/Archives/edgar/data/24090/000002409026000045/0000024090-26-000045-index.htm"
},
{
"accession": "0000764180-26-000105",
"cik": 764180,
"company": "ALTRIA GROUP, INC.",
"form": "8-K",
"filed": "2026-10-09",
"period": "2026-10-07",
"items": [
{
"item": "1.01",
"title": "Entry into a Material Definitive Agreement"
},
{
"item": "9.01",
"title": "Financial Statements and Exhibits"
}
],
"url": "https://www.sec.gov/Archives/edgar/data/764180/000076418026000105/0000764180-26-000105-index.htm"
}
]
}Response fields
| Field | Type | Meaning |
|---|---|---|
total | integer | Number of 8-K filings with this item in the selected range. |
filings[].accession | string | Accession number of the 8-K or 8-K/A. |
filings[].cik | integer | Filer CIK. |
filings[].company | string | Company name from the EDGAR index. |
filings[].form | string | 8-K or 8-K/A. |
filings[].filed | string | Filing date, YYYY-MM-DD. |
filings[].period | string or null | Date of the earliest event reported (period of report), YYYY-MM-DD. |
filings[].items[] | array | Every item the 8-K reports, not only the one you filtered on. Each entry has item (for example 4.02) and title. |
filings[].url | string | URL of the filing index page on sec.gov. |
filings[].text | string or null | Text of the filtered item, extracted from the 8-K. Present on the item feeds by default; null when text=false or when extraction failed. |
filings[].textError | string | Only present when the item text could not be extracted, with the reason. |
8-K item numbers
| Item | Title |
|---|---|
| 1.01 | Entry into a Material Definitive Agreement |
| 1.02 | Termination of a Material Definitive Agreement |
| 1.03 | Bankruptcy or Receivership |
| 1.04 | Mine Safety |
| 1.05 | Material Cybersecurity Incidents |
| 2.01 | Completion of Acquisition or Disposition of Assets |
| 2.02 | Results of Operations and Financial Condition |
| 2.03 | Creation of a Direct Financial Obligation |
| 2.04 | Triggering Events That Accelerate a Financial Obligation |
| 2.05 | Costs Associated with Exit or Disposal Activities |
| 2.06 | Material Impairments |
| 3.01 | Notice of Delisting or Failure to Satisfy a Listing Rule |
| 3.02 | Unregistered Sales of Equity Securities |
| 3.03 | Material Modification to Rights of Security Holders |
| 4.01 | Changes in Registrant's Certifying Accountant |
| 4.02 | Non-Reliance on Previously Issued Financial Statements |
| 5.01 | Changes in Control of Registrant |
| 5.02 | Departure or Appointment of Directors or Officers; Compensatory Arrangements |
| 5.03 | Amendments to Articles or Bylaws |
| 5.04 | Temporary Suspension of Trading Under Employee Benefit Plans |
| 5.05 | Amendments to the Code of Ethics |
| 5.06 | Change in Shell Company Status |
| 5.07 | Submission of Matters to a Vote of Security Holders |
| 5.08 | Shareholder Director Nominations |
| 6.01 | ABS Informational and Computational Material |
| 7.01 | Regulation FD Disclosure |
| 8.01 | Other Events |
| 9.01 | Financial Statements and Exhibits |
How to
How do I get Item 1.01 material agreements for one company?
Add cik. Look up a CIK from a ticker with /v1/mapping/ticker.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/form-8k/material-agreements?cik=1842556"
How do I limit results to a date range?
Use startDate and endDate on the filing date.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/form-8k/material-agreements?startDate=2026-09-01&endDate=2026-09-30&text=false"
How do I count filings quickly?
Set text=false and size=1, then read total.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/form-8k/material-agreements?text=false&size=1"
How do I page through more than 100 results?
size is capped at 100; increase from by the page size for each request.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/form-8k/material-agreements?text=false&size=100&from=100"
Why is text null with a textError on some rows?
The extractor could not find the item heading in that 8-K's main document, for example when the item is only in an exhibit or uses unusual formatting. Open url to read the filing.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/form-8k/material-agreements?size=10"
How do I see which other items an 8-K reported?
items lists every item in the filing, so you can spot combinations such as a 9.01 exhibit list.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/form-8k/material-agreements?text=false&size=10"
Can I query several items at once?
Call /v1/form-8k once per item, or scan /v1/form-8k without item and filter on items yourself.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/form-8k?size=20"
Does the feed include amendments?
Yes. 8-K/A filings that report the item are included; check form.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/form-8k/material-agreements?text=false&size=20"
How far back does the item data go?
Item history currently starts in mid 2024 while older 8-Ks are classified. Use full-text search for older item text.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/form-8k/material-agreements?text=false&size=1"
Where is the agreement itself?
Usually in an Exhibit 10 attached to the 8-K. List the files with /v1/files using the accession number and cik.
curl -H "Authorization: Bearer $SECFEED_KEY" \ "https://secfeedapi.com/v1/form-8k/material-agreements?size=3"
Errors
- 400 when size or from is not a number.
See also the error codes every endpoint shares.
Try it with your own key
500 free calls a month.