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.
ParameterTypeDataTypeDescription
form_numberquerystringFilter by form type (e.g. 10-K)
start_datequerydatetimeFetch filings released on or after this date (defaults to 12 weeks ago)
end_datequerydatetimeFetch filings released on or before this date (defaults to today)
bloomberg_tickerquerystringFilter events to one or more bloomberg tickers (comma-separated)
isinquerystringFilter events to one or more ISINs (comma-separated)
permidquerystringFilter events to one or more PermIDs (comma-separated)
ricquerystringFilter events to one or more Reuters/Refinitiv RICs (comma-separated)
tickerquerystringFilter events to one or more tickers (comma-separated)
from_idqueryintegerContent ID from which to return filings (combine with size for pagination)
from_indexqueryintegerThe index from which to return filings (combine with size for pagination)
sizequeryintegerThe 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"})
Previous
Equity News