Content
Equity Filings
Returns filings data attached to a specific company/equity.
GET /content/filings
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 1+ bloomberg tickers (comma-separated) |
isin | query | string | Filter events to 1+ ISINs (comma-separated) |
permid | query | string | Filter events to 1+ PermIDs (comma-separated) |
ric | query | string | Filter events to 1+ Reuters/Refinitiv RICs (comma-separated) |
ticker | query | string | Filter events to 1+ 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 |
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.
Response
[
{
"content_id": 4757510,
"title": "Amazon Inc. - 10-K",
"published_date": "2021-02-03T06:08:27",
"form_number": "10-K",
"filing_organization": "sec",
"is_amendment": 0,
"period_end_date": "2020-12-31T00:00:00",
"release_date": "2021-02-03T00:00:00",
"arrival_date": "2021-02-03T06:08:27",
"pulled_date": "2021-02-04T04:01:27",
"url": "https://dashboard.aiera.com/companies/1/activity/filings?tabs[0]=fl|4757510"
},
{
"content_id": 3902726,
"title": "Amazon Inc. - 10-K",
"published_date": "2020-01-31T06:07:01",
"form_number": "10-K",
"filing_organization": "sec",
"is_amendment": 0,
"period_end_date": "2019-12-31T00:00:00",
"release_date": "2020-01-31T00:00:00",
"arrival_date": "2020-01-31T06:07:01",
"pulled_date": "2020-06-04T11:22:56",
"url": "https://dashboard.aiera.com/companies/1/activity/filings?tabs[0]=fl|3902726"
}
]
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"})