Content
Equity Filings
Returns filings data attached to a specific company/equity.
GET /content/filings
NOTE
- You must include one of the equity identifiers to get results (bloomberg_ticker, isin, ric, permid, or ticker)
- Only one of the equity identifiers (bloomberg_ticker, isin, ric, permid, or ticker) should be used per request. Using multiple equity identifier query parameters will end up resolving only one of them.
Parameter | Type | DataType | Description |
---|---|---|---|
form_number | query | string | Filter by form type (e.g. 10-K) |
start_date | query | datetime | Fetch filings released on or after this date (defaults to 12 weeks ago) |
end_date | query | datetime | Fetch filings released on or before this date (defaults to today) |
bloomberg_ticker | query | string | Filter events to one or more bloomberg tickers (comma-separated) |
isin | query | string | Filter events to one or more ISINs (comma-separated) |
permid | query | string | Filter events to one or more PermIDs (comma-separated) |
ric | query | string | Filter events to one or more Reuters/Refinitiv RICs (comma-separated) |
ticker | query | string | Filter events to one or more tickers (comma-separated) |
from_id | query | integer | Content ID from which to return filings (combine with size for pagination) |
from_index | query | integer | The index from which to return filings (combine with size for pagination) |
size | query | integer | The number of filings to return |
Request
https://premium.aiera.com/api/content/filings?start_date=2024-11-07&end_date=2024-11-07&bloomberg_ticker=AMZN:US
Response
[
{
"content_id": 24898982,
"title": "AMAZON COM INC - SC 13G/A",
"published_date": "2024-11-07T17:23:12",
"form_number": "SC 13G",
"filing_organization": "sec",
"is_amendment": 1,
"period_end_date": "2024-11-07T00:00:00",
"release_date": "2024-11-07T17:23:12",
"arrival_date": "2024-11-07T17:23:12",
"pulled_date": "2024-11-07T17:33:38",
"pdf_url": "https://s3.amazonaws.com/content.aiera.co/content/filing/pdf/24898982_filing_7938381.pdf",
"url": "https://dashboard.aiera.com/companies/1/activity/filings?tabs[0]=fl|24898982"
},
{
"content_id": 24898876,
"title": "AMAZON COM INC - 13F-HR",
"published_date": "2024-11-07T17:14:26",
"form_number": "13F-HR",
"filing_organization": "sec",
"is_amendment": 0,
"period_end_date": "2024-09-30T00:00:00",
"release_date": "2024-11-07T17:14:26",
"arrival_date": "2024-11-07T17:14:26",
"pulled_date": "2024-11-07T17:23:38",
"pdf_url": "https://s3.amazonaws.com/content.aiera.co/content/filing/pdf/24898876_filing_7938279.pdf",
"url": "https://dashboard.aiera.com/companies/1/activity/filings?tabs[0]=fl|24898876"
}
]
Code Samples
Bash
curl --request GET \
--url 'https://premium.aiera.com/api/content/filings?bloomerg_ticker=AMZN:US' \
--header 'X-API-Key: xxx'
Python
import requests
requests.get("https://premium.aiera.com/api/content/filings?bloomerg_ticker=AMZN:US", headers={"X-API-Key": "xxx"})