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"})