filings
Get Filings
Retrieve SEC EDGAR filings for a company by ticker symbol.
Returns a list of filings (10-K, 10-Q, 8-K, etc.) sourced from the SEC EDGAR database. Results can be filtered by filing type and are returned in reverse chronological order.
curl example:
curl -X GET "http://localhost:8000/api/filings/AAPL?filing_type=10-K&limit=5"
Python requests example:
import requests
resp = requests.get(
"http://localhost:8000/api/filings/AAPL",
params={"filing_type": "10-K", "limit": 5},
)
data = resp.json()
print(f"{data['company_name']} (CIK {data['cik']}): {data['count']} filings")
for f in data["filings"]:
print(f" {f['filing_type']} {f['filing_date']} {f['filing_url']}")
get/api/filings/{symbol}
Request
- Base URL: https://api.halalterminal.com
- URL: https://api.halalterminal.com/api/filings/{symbol}
- Auth: API key in header X-API-Key
Path parameters
symbolstring required
Ticker symbol, e.g. AAPL.
Query parameters
filing_typestring nullable
Filter by filing type, e.g. 10-K, 10-Q, 8-K.
limitinteger
Max filings to return.
Response
List of SEC filings for the requested company
Example response
{
"cik": "0000320193",
"company_name": "Apple Inc.",
"count": 1,
"filings": [
{
"accession_number": "0000320193-23-000106",
"filing_date": "2023-11-03",
"filing_type": "10-K",
"filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/aapl-20230930.htm",
"primary_doc_description": "10-K Annual Report",
"primary_document": "aapl-20230930.htm"
}
],
"symbol": "AAPL"
}Changes
No recorded changes to this operation across all 1 revision of this API.