filings
Get Events
Retrieve the parsed 8-K event feed for a company by ticker symbol.
Each 8-K (current report) filed by the company is parsed into structured events: SEC item codes resolved to human-readable labels, each flagged for whether it can move a Shariah-compliance verdict. Pass compliance_relevant=true for the compliance-watch feed — debt raises, acquisitions, bankruptcies, restatements and the like.
curl example:
curl -X GET "http://localhost:8000/api/filings/AAPL/events?compliance_relevant=true&limit=10"
Python requests example:
import requests
resp = requests.get(
"http://localhost:8000/api/filings/AAPL/events",
params={"compliance_relevant": True, "limit": 10},
)
for event in resp.json()["events"]:
codes = ", ".join(i["code"] for i in event["items"])
print(f"{event['filing_date']} 8-K items {codes}")
get/api/filings/{symbol}/events
Request
- Base URL: https://api.halalterminal.com
- URL: https://api.halalterminal.com/api/filings/{symbol}/events
- Auth: API key in header X-API-Key
Path parameters
symbolstring required
Ticker symbol, e.g. AAPL.
Query parameters
compliance_relevantboolean
Return only events with at least one item that can move a Shariah-compliance verdict.
limitinteger
Max events to return.
Response
Parsed 8-K event feed for the requested company
Example response
{
"cik": "0000320193",
"company_name": "Apple Inc.",
"count": 1,
"events": [
{
"accession_number": "0000320193-26-000012",
"compliance_relevant": true,
"filing_date": "2026-02-01",
"filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000012/ex.htm",
"items": [
{
"code": "2.03",
"compliance_relevant": true,
"label": "Creation of a Direct Financial Obligation"
},
{
"code": "9.01",
"compliance_relevant": false,
"label": "Financial Statements and Exhibits"
}
]
}
],
"symbol": "AAPL"
}Changes
No recorded changes to this operation across all 1 revision of this API.