Find company documents

Fetch company documents by category, keyword, or supported identifiers

GET /company-docs-v1

Parameter	Type	DataType	Description
start_date	query	datetime	Fetch docs on or after this date (default 2 weeks ago)
end_date	query	datetime	Fetch docs on or before this date (default 2 weeks ahead)
bloomberg_ticker	query	string	Filter to one or more bloomberg tickers (comma-separated)
isin	query	string	Filter to one or more ISINs (comma-separated)
ric	query	string	Filter to one or more RICs (comma-separated)
permid	query	string	Filter to one or more PermIDs (comma-separated)
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
page	query	integer	The page of results to return
page_size	query	integer	The size of pages to return (default: 100, max: 100)

NOTE

Only one identifier (bloomberg_ticker, isin, permid, or ric) 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"})