Find company documents

Fetch company documents by category, keyword, or supported identifiers

GET /company-docs-v1

Parameter	Type	DataType	Description
search	query	string	Search term for document title or category
start_date	query	datetime	Fetch docs on or after this date (default: now - 4 weeks)
end_date	query	datetime	Fetch docs on or before this date (default: now)
bloomberg_ticker	query	string	Filter to one or more bloomberg tickers (comma-separated)
isin	query	string	Filter to one or more ISINs (comma-separated)
cusip	query	string	Filter to one or more CUSIPs (comma-separated)
ric	query	string	Filter to one or more RICs (comma-separated)
permid	query	string	Filter to one or more PermIDs (comma-separated)
watchlist_id	query	integer	Filter by watchlist ID
index_id	query	integer	Filter by market index ID
sector_id	query	integer	Filter by GICS sector ID
subsector_id	query	integer	Filter by GICS subsector ID
categories	query	string	Comma-separated list of categories
exclude_categories	query	string	Comma-separated list of categories to exclude
keywords	query	string	Comma-separated list of keywords
exclude_keywords	query	string	Comma-separated list of keywords to exclude
include_delisted	query	boolean	Whether to include delisted equities (default: true)
company_rollup	query	boolean	Whether to rollup to all company equities (default: true)
page	query	integer	The page of results to return
page_size	query	integer	The size of pages to return (default: 100, min: 10, max: 100)

NOTE

Only one identifier (bloomberg_ticker, isin, cusip, ric, ticker, or permid) should be used per request. Providing multiple identifiers will end up resolving only one of them.

Request

https://premium.aiera.com/api/company-docs-v1?bloomberg_ticker=AMZN:US&start_date=2024-01-01&end_date=2024-03-31

Response

{
  "params": {
    "start_date": "2024-01-01T00:00:00",
    "end_date": "2024-03-31T23:59:59.999999",
    "bloomberg_ticker": "AMZN:US",
    "page_size": 100,
    "from_index": 0
  },
  "pagination": {
    "total_count": 8,
    "current_page": 1,
    "total_pages": 1,
    "page_size": 8
  },
  "data": [
    {
      "doc_id": 14354,
      "company": {
        "company_id": 1,
        "common_name": "Amazon",
        "legal_name": "Amazon.com Inc",
        "incorporated_country_code": "US",
        "domiciled_country_code": "US"
      },
      "publish_date": "2024-02-01",
      "category": "sec_filing",
      "title": "Amazon.com, Inc. Annual Report on Form 10-K for the Fiscal Year Ended December 31, 2023",
      "source_url": "https://s2.q4cdn.com/299287126/files/doc_financials/2023/q4/c7c14359-36fa-40c3-b3ca-5bf7f3fa0b96.pdf",
      "summary": [
        "The document is the annual report filed with the SEC on Form 10-K for the fiscal year ended December 31, 2023. It includes financial statements, management's discussion and analysis, and disclosures pertaining to Amazon's operations, financial condition, and risk factors.",
        "The report details Amazon's business segments: North America, International, and Amazon Web Services (AWS) and provides insights into financial performance, including net sales, operating income, and cash flow data.",
        "Management discusses the effects of currency fluctuations, competition, technological investments, and market risks. The report also includes compliance and regulatory information, legal proceedings, and internal controls over financial reporting.",
        "The document is signed by key Amazon executives, including President and CEO Andrew R. Jassy, with certifications pursuant to the Sarbanes-Oxley Act regarding the accuracy of financial reporting."
      ],
      "keywords": [
        "Annual report",
        "Form 10-K",
        "Financial statements",
        "Net sales",
        "Operating income",
        "Cash flow",
        "AWS",
        "Risk factors",
        "Currency fluctuations",
        "Competition",
        "Technological investments",
        "Regulatory information",
        "Legal proceedings",
        "Internal controls",
        "Sarbanes-Oxley Act"
      ],
      "processed": "2025-09-09T21:24:33",
      "created": "2025-09-03T18:50:06",
      "modified": "2025-09-17T00:42:18"
    },
    {
      "doc_id": 14403,
      "company": {
        "company_id": 1,
        "common_name": "Amazon",
        "legal_name": "Amazon.com Inc",
        "incorporated_country_code": "US",
        "domiciled_country_code": "US"
      },
      "publish_date": "2024-02-01",
      "category": "slide_presentation",
      "title": "Q4 2023 Financial Results Conference Call Slides",
      "source_url": "https://s2.q4cdn.com/299287126/files/doc_financials/2023/q4/Webslides_Q423_Final.pdf",
      "summary": [
        "The document is a slide presentation of Amazon's financial results for Q4 2023. It includes net sales data and highlights a year-over-year increase in various business segments, including North America, International, and AWS.",
        "It discusses operating income, showing a significant increase from the previous year. The presentation also covers net income, free cash flow, and provides a detailed view of financial changes across segments and geographies.",
        "Forward-looking statements are included, emphasizing potential risks such as economic fluctuations, competition, and regulatory changes. Financial metrics and graphs illustrate the company's performance over the last few quarters."
      ],
      "keywords": [
        "financial results",
        "net sales",
        "operating income",
        "net income",
        "free cash flow",
        "AWS",
        "North America",
        "International",
        "valuation loss",
        "segment results",
        "economic conditions",
        "cloud services"
      ],
      "processed": "2025-09-09T22:13:45",
      "created": "2025-09-03T18:50:45",
      "modified": "2025-09-18T16:33:00"
    },
    ...
  ]
}

Code Samples

Bash

curl --request GET \
  --url 'https://premium.aiera.com/api/company-docs-v1' \
  --header 'X-API-Key: xxx'

Python

import requests
requests.request("GET", "https://premium.aiera.com/api/company-docs-v1", headers={"X-API-Key": "xxx"})