invinite-data-api 0.1.0__tar.gz → 0.2.0__tar.gz

{invinite_data_api-0.1.0 → invinite_data_api-0.2.0}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: invinite_data_api
-Version: 0.1.0
-Summary: Invinite API
+Version: 0.2.0
+Summary: Typed Python client for the Invinite Data API
 Home-page: 
 Author: OpenAPI Generator community
 Author-email: OpenAPI Generator Community <team@openapitools.org>
 Project-URL: Homepage, https://data.invinite.com
 Project-URL: Documentation, https://data.invinite.com/docs/sdks
-Project-URL: Repository, https://github.com/outraday-org/invinite
+Project-URL: Repository, https://github.com/outraday-org/invinite-data-api
 Keywords: OpenAPI,OpenAPI-Generator,Invinite API
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown

{invinite_data_api-0.1.0 → invinite_data_api-0.2.0}/invinite_data_api/api/earnings_calls_api.py

@@ -1491,11 +1491,16 @@ class EarningsCallsApi:
     def earnings_calls_company_documents(
         self,
         identifier: Annotated[StrictStr, Field(description="Company ticker symbol or CIK (US companies only)")],
-        section: Annotated[Optional[List[StrictStr]], Field(description="Only these IR site sections, comma-separated or repeated: quarterly_results, events_archive, presentations_archive, annual_reports, proxy, sec_filings, press_releases, esg, governance, faq, other")] = None,
-        kind: Annotated[Optional[List[StrictStr]], Field(description="Only these document kinds, comma-separated or repeated: annual_report, ceo_letter, proxy_statement, proxy_supplement, esg_report, conference_presentation, investor_day_deck, earnings_deck, fact_sheet, financial_data, shareholder_letter, company_transcript, cfo_commentary, governance, press_release, infographic, webcast, other, prepared_remarks")] = None,
-        year: Annotated[Optional[Annotated[int, Field(le=2100, strict=True, ge=1990)]], Field(description="Year the document belongs to")] = None,
-        period: Annotated[Optional[StrictStr], Field(description="Period within the year")] = None,
-        event_id: Annotated[Optional[UUID], Field(description="Only documents of this event (an investor day, a conference, a shareholder meeting)")] = None,
+        section: Annotated[Optional[List[StrictStr]], Field(description="Only these IR site sections, comma-separated or repeated: quarterly_results, events_archive, presentations_archive, annual_reports, proxy, sec_filings, press_releases, esg, governance, faq, other. IR-library rows only: with include=calls a section filter leaves the call documents out")] = None,
+        kind: Annotated[Optional[List[StrictStr]], Field(description="Only these document kinds, comma-separated or repeated: annual_report, ceo_letter, proxy_statement, proxy_supplement, esg_report, conference_presentation, investor_day_deck, earnings_deck, fact_sheet, financial_data, shareholder_letter, company_transcript, cfo_commentary, governance, press_release, infographic, webcast, other, prepared_remarks, sec_filing")] = None,
+        year: Annotated[Optional[Annotated[int, Field(le=2100, strict=True, ge=1990)]], Field(description="Year the document belongs to (a call document: the call's fiscal year)")] = None,
+        period: Annotated[Optional[StrictStr], Field(description="Period within the year (a call document: its call's fiscal quarter, Q1-Q4)")] = None,
+        event_id: Annotated[Optional[UUID], Field(description="Only documents of this event (an investor day, a conference, a shareholder meeting; with include=calls also an earnings call)")] = None,
+        category: Annotated[Optional[List[StrictStr]], Field(description="Only these tree categories, comma-separated or repeated: earnings, events, reports, presentations, governance, esg, shareholder, other")] = None,
+        group: Annotated[Optional[StrictStr], Field(description="Only this folder of the document tree and everything below it (prefix match), e.g. earnings/fy2027 or earnings/fy2027/q2 or reports")] = None,
+        fiscal_year: Annotated[Optional[Annotated[int, Field(le=2100, strict=True, ge=1990)]], Field(description="Only documents of this fiscal year's earnings folders (earnings/fy<YYYY>/…)")] = None,
+        fiscal_quarter: Annotated[Optional[Annotated[int, Field(le=4, strict=True, ge=1)]], Field(description="Only documents of this fiscal quarter's earnings folder (earnings/fy…/q<N>); combine with fiscal_year")] = None,
+        include: Annotated[Optional[List[StrictStr]], Field(description="Extra rows: `calls` = the documents of every earnings call of the company (each call's folder, as `/v1/earnings-calls/documents` serves it) in the same list, `source: call`")] = None,
         limit: Annotated[Optional[Annotated[int, Field(le=100, strict=True, ge=1)]], Field(description="Maximum number of documents to return")] = None,
         offset: Annotated[Optional[Annotated[int, Field(strict=True, ge=0)]], Field(description="Number of documents to skip for pagination")] = None,
         _request_timeout: Union[
@@ -1513,20 +1518,30 @@ class EarningsCallsApi:
     ) -> EarningsCallsCompanyDocuments200Response:
         """Company documents
 
-        A company's investor-relations documents outside its earnings calls' folders, newest year first: annual reports, proxy statements, ESG / governance documents, investor-day and conference decks, shareholder letters, fact sheets, and link-only webcast replay pages.  Filter by IR section, kind, year, period or event. Documents of one earnings call are on `/v1/earnings-calls/documents`.  ### What you get  - Company-published material: displayed as published, not verified facts.  - Stored files come as signed URLs; `pages_url` is the per-page text (JSON). A link-only row (webcast) has `url` null and `link_status`.  - Files are served as short-lived signed URLs (see `expires_at`), never proxied; request a fresh response after expiry.  ### Errors  - `503 media_unavailable` while media signing is not configured.  ### Freshness and coverage  - Data is replicated from the capture pipeline with a lag of about a minute.  - Only US earnings calls captured by Invinite are served.  Minimum tier for display: FREE.
+        A company's investor-relations documents, newest year first: annual reports, proxy statements, ESG / governance documents, investor-day and conference decks, shareholder letters, fact sheets, and link-only webcast replay pages. By default the IR library outside its earnings calls' folders; `include=calls` adds the documents of every earnings call (CFO commentary, data sheets, letters, the company's own transcript, prepared remarks, 10-Q / 10-K links) to the same list, marked `source: call` with the call's `event_id`, so one paged list holds the company's whole document tree.  Filter by IR section, kind, year, period or event, or by the document tree: `category`, `group` (a folder and everything below it) and `fiscal_year` / `fiscal_quarter` (the earnings folder `earnings/fy<YYYY>/q<N>`). On a call document `year` / `period` are the call's fiscal year / quarter; a `section` filter matches IR-library rows only. Documents of one earnings call alone are on `/v1/earnings-calls/documents`; a call's press release and slide deck are on `/v1/earnings-calls/press-release` and `/v1/earnings-calls/slides`.  ### Order and paging  - Without `include`: newest year first, then IR section, kind and title. With `include=calls`: newest year first, then folder (`group`), kind, title and id, one total order over both sources, so `offset` pages never skip or repeat a document.  ### The document tree  Every stored document sits in one folder of the company's document tree: `group` (its path) under one of eight `category` spine folders, in this order: `earnings` (`earnings/fy2027/q2` = one fiscal quarter's call: release, deck, CFO commentary, data sheets, transcript; `earnings/cy2026/08-26` = a call without a fiscal period), `events` (`events/2026/09-10-<event>` = a conference, investor day or shareholder meeting), `reports` (`reports/2025`: annual reports, proxy statements, annual letters), `presentations` (`presentations/2024`), `governance`, `esg` (`esg/2025`), `shareholder` (`shareholder/tax`, `shareholder/dividends`, `shareholder/stock`) and `other` (`other/faq`, `other/fact-sheets`, `other/financial-data[/2025]`, `other/web-pages`, `other/documents`). `…/undated` = no date could be read. `group` and `category` are null while a document has not been placed yet.  ### What you get  - Company-published material: displayed as published, not verified facts.  - Stored files come as signed URLs; `pages_url` is the per-page text (JSON). A link-only row (webcast) has `url` null and `link_status`.  - Files are served as short-lived signed URLs (see `expires_at`), never proxied; request a fresh response after expiry.  ### Errors  - `503 media_unavailable` while media signing is not configured.  ### Freshness and coverage  - Data is replicated from the capture pipeline with a lag of about a minute.  - Only US earnings calls captured by Invinite are served.  Minimum tier for display: FREE.
 
         :param identifier: Company ticker symbol or CIK (US companies only) (required)
         :type identifier: str
-        :param section: Only these IR site sections, comma-separated or repeated: quarterly_results, events_archive, presentations_archive, annual_reports, proxy, sec_filings, press_releases, esg, governance, faq, other
+        :param section: Only these IR site sections, comma-separated or repeated: quarterly_results, events_archive, presentations_archive, annual_reports, proxy, sec_filings, press_releases, esg, governance, faq, other. IR-library rows only: with include=calls a section filter leaves the call documents out
         :type section: List[str]
-        :param kind: Only these document kinds, comma-separated or repeated: annual_report, ceo_letter, proxy_statement, proxy_supplement, esg_report, conference_presentation, investor_day_deck, earnings_deck, fact_sheet, financial_data, shareholder_letter, company_transcript, cfo_commentary, governance, press_release, infographic, webcast, other, prepared_remarks
+        :param kind: Only these document kinds, comma-separated or repeated: annual_report, ceo_letter, proxy_statement, proxy_supplement, esg_report, conference_presentation, investor_day_deck, earnings_deck, fact_sheet, financial_data, shareholder_letter, company_transcript, cfo_commentary, governance, press_release, infographic, webcast, other, prepared_remarks, sec_filing
         :type kind: List[str]
-        :param year: Year the document belongs to
+        :param year: Year the document belongs to (a call document: the call's fiscal year)
         :type year: int
-        :param period: Period within the year
+        :param period: Period within the year (a call document: its call's fiscal quarter, Q1-Q4)
         :type period: str
-        :param event_id: Only documents of this event (an investor day, a conference, a shareholder meeting)
+        :param event_id: Only documents of this event (an investor day, a conference, a shareholder meeting; with include=calls also an earnings call)
         :type event_id: UUID
+        :param category: Only these tree categories, comma-separated or repeated: earnings, events, reports, presentations, governance, esg, shareholder, other
+        :type category: List[str]
+        :param group: Only this folder of the document tree and everything below it (prefix match), e.g. earnings/fy2027 or earnings/fy2027/q2 or reports
+        :type group: str
+        :param fiscal_year: Only documents of this fiscal year's earnings folders (earnings/fy<YYYY>/…)
+        :type fiscal_year: int
+        :param fiscal_quarter: Only documents of this fiscal quarter's earnings folder (earnings/fy…/q<N>); combine with fiscal_year
+        :type fiscal_quarter: int
+        :param include: Extra rows: `calls` = the documents of every earnings call of the company (each call's folder, as `/v1/earnings-calls/documents` serves it) in the same list, `source: call`
+        :type include: List[str]
         :param limit: Maximum number of documents to return
         :type limit: int
         :param offset: Number of documents to skip for pagination
@@ -1560,6 +1575,11 @@ class EarningsCallsApi:
             year=year,
             period=period,
             event_id=event_id,
+            category=category,
+            group=group,
+            fiscal_year=fiscal_year,
+            fiscal_quarter=fiscal_quarter,
+            include=include,
             limit=limit,
             offset=offset,
             _request_auth=_request_auth,
@@ -1591,11 +1611,16 @@ class EarningsCallsApi:
     def earnings_calls_company_documents_with_http_info(
         self,
         identifier: Annotated[StrictStr, Field(description="Company ticker symbol or CIK (US companies only)")],
-        section: Annotated[Optional[List[StrictStr]], Field(description="Only these IR site sections, comma-separated or repeated: quarterly_results, events_archive, presentations_archive, annual_reports, proxy, sec_filings, press_releases, esg, governance, faq, other")] = None,
-        kind: Annotated[Optional[List[StrictStr]], Field(description="Only these document kinds, comma-separated or repeated: annual_report, ceo_letter, proxy_statement, proxy_supplement, esg_report, conference_presentation, investor_day_deck, earnings_deck, fact_sheet, financial_data, shareholder_letter, company_transcript, cfo_commentary, governance, press_release, infographic, webcast, other, prepared_remarks")] = None,
-        year: Annotated[Optional[Annotated[int, Field(le=2100, strict=True, ge=1990)]], Field(description="Year the document belongs to")] = None,
-        period: Annotated[Optional[StrictStr], Field(description="Period within the year")] = None,
-        event_id: Annotated[Optional[UUID], Field(description="Only documents of this event (an investor day, a conference, a shareholder meeting)")] = None,
+        section: Annotated[Optional[List[StrictStr]], Field(description="Only these IR site sections, comma-separated or repeated: quarterly_results, events_archive, presentations_archive, annual_reports, proxy, sec_filings, press_releases, esg, governance, faq, other. IR-library rows only: with include=calls a section filter leaves the call documents out")] = None,
+        kind: Annotated[Optional[List[StrictStr]], Field(description="Only these document kinds, comma-separated or repeated: annual_report, ceo_letter, proxy_statement, proxy_supplement, esg_report, conference_presentation, investor_day_deck, earnings_deck, fact_sheet, financial_data, shareholder_letter, company_transcript, cfo_commentary, governance, press_release, infographic, webcast, other, prepared_remarks, sec_filing")] = None,
+        year: Annotated[Optional[Annotated[int, Field(le=2100, strict=True, ge=1990)]], Field(description="Year the document belongs to (a call document: the call's fiscal year)")] = None,
+        period: Annotated[Optional[StrictStr], Field(description="Period within the year (a call document: its call's fiscal quarter, Q1-Q4)")] = None,
+        event_id: Annotated[Optional[UUID], Field(description="Only documents of this event (an investor day, a conference, a shareholder meeting; with include=calls also an earnings call)")] = None,
+        category: Annotated[Optional[List[StrictStr]], Field(description="Only these tree categories, comma-separated or repeated: earnings, events, reports, presentations, governance, esg, shareholder, other")] = None,
+        group: Annotated[Optional[StrictStr], Field(description="Only this folder of the document tree and everything below it (prefix match), e.g. earnings/fy2027 or earnings/fy2027/q2 or reports")] = None,
+        fiscal_year: Annotated[Optional[Annotated[int, Field(le=2100, strict=True, ge=1990)]], Field(description="Only documents of this fiscal year's earnings folders (earnings/fy<YYYY>/…)")] = None,
+        fiscal_quarter: Annotated[Optional[Annotated[int, Field(le=4, strict=True, ge=1)]], Field(description="Only documents of this fiscal quarter's earnings folder (earnings/fy…/q<N>); combine with fiscal_year")] = None,
+        include: Annotated[Optional[List[StrictStr]], Field(description="Extra rows: `calls` = the documents of every earnings call of the company (each call's folder, as `/v1/earnings-calls/documents` serves it) in the same list, `source: call`")] = None,
         limit: Annotated[Optional[Annotated[int, Field(le=100, strict=True, ge=1)]], Field(description="Maximum number of documents to return")] = None,
         offset: Annotated[Optional[Annotated[int, Field(strict=True, ge=0)]], Field(description="Number of documents to skip for pagination")] = None,
         _request_timeout: Union[
@@ -1613,20 +1638,30 @@ class EarningsCallsApi:
     ) -> ApiResponse[EarningsCallsCompanyDocuments200Response]:
         """Company documents
 
-        A company's investor-relations documents outside its earnings calls' folders, newest year first: annual reports, proxy statements, ESG / governance documents, investor-day and conference decks, shareholder letters, fact sheets, and link-only webcast replay pages.  Filter by IR section, kind, year, period or event. Documents of one earnings call are on `/v1/earnings-calls/documents`.  ### What you get  - Company-published material: displayed as published, not verified facts.  - Stored files come as signed URLs; `pages_url` is the per-page text (JSON). A link-only row (webcast) has `url` null and `link_status`.  - Files are served as short-lived signed URLs (see `expires_at`), never proxied; request a fresh response after expiry.  ### Errors  - `503 media_unavailable` while media signing is not configured.  ### Freshness and coverage  - Data is replicated from the capture pipeline with a lag of about a minute.  - Only US earnings calls captured by Invinite are served.  Minimum tier for display: FREE.
+        A company's investor-relations documents, newest year first: annual reports, proxy statements, ESG / governance documents, investor-day and conference decks, shareholder letters, fact sheets, and link-only webcast replay pages. By default the IR library outside its earnings calls' folders; `include=calls` adds the documents of every earnings call (CFO commentary, data sheets, letters, the company's own transcript, prepared remarks, 10-Q / 10-K links) to the same list, marked `source: call` with the call's `event_id`, so one paged list holds the company's whole document tree.  Filter by IR section, kind, year, period or event, or by the document tree: `category`, `group` (a folder and everything below it) and `fiscal_year` / `fiscal_quarter` (the earnings folder `earnings/fy<YYYY>/q<N>`). On a call document `year` / `period` are the call's fiscal year / quarter; a `section` filter matches IR-library rows only. Documents of one earnings call alone are on `/v1/earnings-calls/documents`; a call's press release and slide deck are on `/v1/earnings-calls/press-release` and `/v1/earnings-calls/slides`.  ### Order and paging  - Without `include`: newest year first, then IR section, kind and title. With `include=calls`: newest year first, then folder (`group`), kind, title and id, one total order over both sources, so `offset` pages never skip or repeat a document.  ### The document tree  Every stored document sits in one folder of the company's document tree: `group` (its path) under one of eight `category` spine folders, in this order: `earnings` (`earnings/fy2027/q2` = one fiscal quarter's call: release, deck, CFO commentary, data sheets, transcript; `earnings/cy2026/08-26` = a call without a fiscal period), `events` (`events/2026/09-10-<event>` = a conference, investor day or shareholder meeting), `reports` (`reports/2025`: annual reports, proxy statements, annual letters), `presentations` (`presentations/2024`), `governance`, `esg` (`esg/2025`), `shareholder` (`shareholder/tax`, `shareholder/dividends`, `shareholder/stock`) and `other` (`other/faq`, `other/fact-sheets`, `other/financial-data[/2025]`, `other/web-pages`, `other/documents`). `…/undated` = no date could be read. `group` and `category` are null while a document has not been placed yet.  ### What you get  - Company-published material: displayed as published, not verified facts.  - Stored files come as signed URLs; `pages_url` is the per-page text (JSON). A link-only row (webcast) has `url` null and `link_status`.  - Files are served as short-lived signed URLs (see `expires_at`), never proxied; request a fresh response after expiry.  ### Errors  - `503 media_unavailable` while media signing is not configured.  ### Freshness and coverage  - Data is replicated from the capture pipeline with a lag of about a minute.  - Only US earnings calls captured by Invinite are served.  Minimum tier for display: FREE.
 
         :param identifier: Company ticker symbol or CIK (US companies only) (required)
         :type identifier: str
-        :param section: Only these IR site sections, comma-separated or repeated: quarterly_results, events_archive, presentations_archive, annual_reports, proxy, sec_filings, press_releases, esg, governance, faq, other
+        :param section: Only these IR site sections, comma-separated or repeated: quarterly_results, events_archive, presentations_archive, annual_reports, proxy, sec_filings, press_releases, esg, governance, faq, other. IR-library rows only: with include=calls a section filter leaves the call documents out
         :type section: List[str]
-        :param kind: Only these document kinds, comma-separated or repeated: annual_report, ceo_letter, proxy_statement, proxy_supplement, esg_report, conference_presentation, investor_day_deck, earnings_deck, fact_sheet, financial_data, shareholder_letter, company_transcript, cfo_commentary, governance, press_release, infographic, webcast, other, prepared_remarks
+        :param kind: Only these document kinds, comma-separated or repeated: annual_report, ceo_letter, proxy_statement, proxy_supplement, esg_report, conference_presentation, investor_day_deck, earnings_deck, fact_sheet, financial_data, shareholder_letter, company_transcript, cfo_commentary, governance, press_release, infographic, webcast, other, prepared_remarks, sec_filing
         :type kind: List[str]
-        :param year: Year the document belongs to
+        :param year: Year the document belongs to (a call document: the call's fiscal year)
         :type year: int
-        :param period: Period within the year
+        :param period: Period within the year (a call document: its call's fiscal quarter, Q1-Q4)
         :type period: str
-        :param event_id: Only documents of this event (an investor day, a conference, a shareholder meeting)
+        :param event_id: Only documents of this event (an investor day, a conference, a shareholder meeting; with include=calls also an earnings call)
         :type event_id: UUID
+        :param category: Only these tree categories, comma-separated or repeated: earnings, events, reports, presentations, governance, esg, shareholder, other
+        :type category: List[str]
+        :param group: Only this folder of the document tree and everything below it (prefix match), e.g. earnings/fy2027 or earnings/fy2027/q2 or reports
+        :type group: str
+        :param fiscal_year: Only documents of this fiscal year's earnings folders (earnings/fy<YYYY>/…)
+        :type fiscal_year: int
+        :param fiscal_quarter: Only documents of this fiscal quarter's earnings folder (earnings/fy…/q<N>); combine with fiscal_year
+        :type fiscal_quarter: int
+        :param include: Extra rows: `calls` = the documents of every earnings call of the company (each call's folder, as `/v1/earnings-calls/documents` serves it) in the same list, `source: call`
+        :type include: List[str]
         :param limit: Maximum number of documents to return
         :type limit: int
         :param offset: Number of documents to skip for pagination
@@ -1660,6 +1695,11 @@ class EarningsCallsApi:
             year=year,
             period=period,
             event_id=event_id,
+            category=category,
+            group=group,
+            fiscal_year=fiscal_year,
+            fiscal_quarter=fiscal_quarter,
+            include=include,
             limit=limit,
             offset=offset,
             _request_auth=_request_auth,
@@ -1691,11 +1731,16 @@ class EarningsCallsApi:
     def earnings_calls_company_documents_without_preload_content(
         self,
         identifier: Annotated[StrictStr, Field(description="Company ticker symbol or CIK (US companies only)")],
-        section: Annotated[Optional[List[StrictStr]], Field(description="Only these IR site sections, comma-separated or repeated: quarterly_results, events_archive, presentations_archive, annual_reports, proxy, sec_filings, press_releases, esg, governance, faq, other")] = None,
-        kind: Annotated[Optional[List[StrictStr]], Field(description="Only these document kinds, comma-separated or repeated: annual_report, ceo_letter, proxy_statement, proxy_supplement, esg_report, conference_presentation, investor_day_deck, earnings_deck, fact_sheet, financial_data, shareholder_letter, company_transcript, cfo_commentary, governance, press_release, infographic, webcast, other, prepared_remarks")] = None,
-        year: Annotated[Optional[Annotated[int, Field(le=2100, strict=True, ge=1990)]], Field(description="Year the document belongs to")] = None,
-        period: Annotated[Optional[StrictStr], Field(description="Period within the year")] = None,
-        event_id: Annotated[Optional[UUID], Field(description="Only documents of this event (an investor day, a conference, a shareholder meeting)")] = None,
+        section: Annotated[Optional[List[StrictStr]], Field(description="Only these IR site sections, comma-separated or repeated: quarterly_results, events_archive, presentations_archive, annual_reports, proxy, sec_filings, press_releases, esg, governance, faq, other. IR-library rows only: with include=calls a section filter leaves the call documents out")] = None,
+        kind: Annotated[Optional[List[StrictStr]], Field(description="Only these document kinds, comma-separated or repeated: annual_report, ceo_letter, proxy_statement, proxy_supplement, esg_report, conference_presentation, investor_day_deck, earnings_deck, fact_sheet, financial_data, shareholder_letter, company_transcript, cfo_commentary, governance, press_release, infographic, webcast, other, prepared_remarks, sec_filing")] = None,
+        year: Annotated[Optional[Annotated[int, Field(le=2100, strict=True, ge=1990)]], Field(description="Year the document belongs to (a call document: the call's fiscal year)")] = None,
+        period: Annotated[Optional[StrictStr], Field(description="Period within the year (a call document: its call's fiscal quarter, Q1-Q4)")] = None,
+        event_id: Annotated[Optional[UUID], Field(description="Only documents of this event (an investor day, a conference, a shareholder meeting; with include=calls also an earnings call)")] = None,
+        category: Annotated[Optional[List[StrictStr]], Field(description="Only these tree categories, comma-separated or repeated: earnings, events, reports, presentations, governance, esg, shareholder, other")] = None,
+        group: Annotated[Optional[StrictStr], Field(description="Only this folder of the document tree and everything below it (prefix match), e.g. earnings/fy2027 or earnings/fy2027/q2 or reports")] = None,
+        fiscal_year: Annotated[Optional[Annotated[int, Field(le=2100, strict=True, ge=1990)]], Field(description="Only documents of this fiscal year's earnings folders (earnings/fy<YYYY>/…)")] = None,
+        fiscal_quarter: Annotated[Optional[Annotated[int, Field(le=4, strict=True, ge=1)]], Field(description="Only documents of this fiscal quarter's earnings folder (earnings/fy…/q<N>); combine with fiscal_year")] = None,
+        include: Annotated[Optional[List[StrictStr]], Field(description="Extra rows: `calls` = the documents of every earnings call of the company (each call's folder, as `/v1/earnings-calls/documents` serves it) in the same list, `source: call`")] = None,
         limit: Annotated[Optional[Annotated[int, Field(le=100, strict=True, ge=1)]], Field(description="Maximum number of documents to return")] = None,
         offset: Annotated[Optional[Annotated[int, Field(strict=True, ge=0)]], Field(description="Number of documents to skip for pagination")] = None,
         _request_timeout: Union[
@@ -1713,20 +1758,30 @@ class EarningsCallsApi:
     ) -> RESTResponseType:
         """Company documents
 
-        A company's investor-relations documents outside its earnings calls' folders, newest year first: annual reports, proxy statements, ESG / governance documents, investor-day and conference decks, shareholder letters, fact sheets, and link-only webcast replay pages.  Filter by IR section, kind, year, period or event. Documents of one earnings call are on `/v1/earnings-calls/documents`.  ### What you get  - Company-published material: displayed as published, not verified facts.  - Stored files come as signed URLs; `pages_url` is the per-page text (JSON). A link-only row (webcast) has `url` null and `link_status`.  - Files are served as short-lived signed URLs (see `expires_at`), never proxied; request a fresh response after expiry.  ### Errors  - `503 media_unavailable` while media signing is not configured.  ### Freshness and coverage  - Data is replicated from the capture pipeline with a lag of about a minute.  - Only US earnings calls captured by Invinite are served.  Minimum tier for display: FREE.
+        A company's investor-relations documents, newest year first: annual reports, proxy statements, ESG / governance documents, investor-day and conference decks, shareholder letters, fact sheets, and link-only webcast replay pages. By default the IR library outside its earnings calls' folders; `include=calls` adds the documents of every earnings call (CFO commentary, data sheets, letters, the company's own transcript, prepared remarks, 10-Q / 10-K links) to the same list, marked `source: call` with the call's `event_id`, so one paged list holds the company's whole document tree.  Filter by IR section, kind, year, period or event, or by the document tree: `category`, `group` (a folder and everything below it) and `fiscal_year` / `fiscal_quarter` (the earnings folder `earnings/fy<YYYY>/q<N>`). On a call document `year` / `period` are the call's fiscal year / quarter; a `section` filter matches IR-library rows only. Documents of one earnings call alone are on `/v1/earnings-calls/documents`; a call's press release and slide deck are on `/v1/earnings-calls/press-release` and `/v1/earnings-calls/slides`.  ### Order and paging  - Without `include`: newest year first, then IR section, kind and title. With `include=calls`: newest year first, then folder (`group`), kind, title and id, one total order over both sources, so `offset` pages never skip or repeat a document.  ### The document tree  Every stored document sits in one folder of the company's document tree: `group` (its path) under one of eight `category` spine folders, in this order: `earnings` (`earnings/fy2027/q2` = one fiscal quarter's call: release, deck, CFO commentary, data sheets, transcript; `earnings/cy2026/08-26` = a call without a fiscal period), `events` (`events/2026/09-10-<event>` = a conference, investor day or shareholder meeting), `reports` (`reports/2025`: annual reports, proxy statements, annual letters), `presentations` (`presentations/2024`), `governance`, `esg` (`esg/2025`), `shareholder` (`shareholder/tax`, `shareholder/dividends`, `shareholder/stock`) and `other` (`other/faq`, `other/fact-sheets`, `other/financial-data[/2025]`, `other/web-pages`, `other/documents`). `…/undated` = no date could be read. `group` and `category` are null while a document has not been placed yet.  ### What you get  - Company-published material: displayed as published, not verified facts.  - Stored files come as signed URLs; `pages_url` is the per-page text (JSON). A link-only row (webcast) has `url` null and `link_status`.  - Files are served as short-lived signed URLs (see `expires_at`), never proxied; request a fresh response after expiry.  ### Errors  - `503 media_unavailable` while media signing is not configured.  ### Freshness and coverage  - Data is replicated from the capture pipeline with a lag of about a minute.  - Only US earnings calls captured by Invinite are served.  Minimum tier for display: FREE.
 
         :param identifier: Company ticker symbol or CIK (US companies only) (required)
         :type identifier: str
-        :param section: Only these IR site sections, comma-separated or repeated: quarterly_results, events_archive, presentations_archive, annual_reports, proxy, sec_filings, press_releases, esg, governance, faq, other
+        :param section: Only these IR site sections, comma-separated or repeated: quarterly_results, events_archive, presentations_archive, annual_reports, proxy, sec_filings, press_releases, esg, governance, faq, other. IR-library rows only: with include=calls a section filter leaves the call documents out
         :type section: List[str]
-        :param kind: Only these document kinds, comma-separated or repeated: annual_report, ceo_letter, proxy_statement, proxy_supplement, esg_report, conference_presentation, investor_day_deck, earnings_deck, fact_sheet, financial_data, shareholder_letter, company_transcript, cfo_commentary, governance, press_release, infographic, webcast, other, prepared_remarks
+        :param kind: Only these document kinds, comma-separated or repeated: annual_report, ceo_letter, proxy_statement, proxy_supplement, esg_report, conference_presentation, investor_day_deck, earnings_deck, fact_sheet, financial_data, shareholder_letter, company_transcript, cfo_commentary, governance, press_release, infographic, webcast, other, prepared_remarks, sec_filing
         :type kind: List[str]
-        :param year: Year the document belongs to
+        :param year: Year the document belongs to (a call document: the call's fiscal year)
         :type year: int
-        :param period: Period within the year
+        :param period: Period within the year (a call document: its call's fiscal quarter, Q1-Q4)
         :type period: str
-        :param event_id: Only documents of this event (an investor day, a conference, a shareholder meeting)
+        :param event_id: Only documents of this event (an investor day, a conference, a shareholder meeting; with include=calls also an earnings call)
         :type event_id: UUID
+        :param category: Only these tree categories, comma-separated or repeated: earnings, events, reports, presentations, governance, esg, shareholder, other
+        :type category: List[str]
+        :param group: Only this folder of the document tree and everything below it (prefix match), e.g. earnings/fy2027 or earnings/fy2027/q2 or reports
+        :type group: str
+        :param fiscal_year: Only documents of this fiscal year's earnings folders (earnings/fy<YYYY>/…)
+        :type fiscal_year: int
+        :param fiscal_quarter: Only documents of this fiscal quarter's earnings folder (earnings/fy…/q<N>); combine with fiscal_year
+        :type fiscal_quarter: int
+        :param include: Extra rows: `calls` = the documents of every earnings call of the company (each call's folder, as `/v1/earnings-calls/documents` serves it) in the same list, `source: call`
+        :type include: List[str]
         :param limit: Maximum number of documents to return
         :type limit: int
         :param offset: Number of documents to skip for pagination
@@ -1760,6 +1815,11 @@ class EarningsCallsApi:
             year=year,
             period=period,
             event_id=event_id,
+            category=category,
+            group=group,
+            fiscal_year=fiscal_year,
+            fiscal_quarter=fiscal_quarter,
+            include=include,
             limit=limit,
             offset=offset,
             _request_auth=_request_auth,
@@ -1791,6 +1851,11 @@ class EarningsCallsApi:
         year,
         period,
         event_id,
+        category,
+        group,
+        fiscal_year,
+        fiscal_quarter,
+        include,
         limit,
         offset,
         _request_auth,
@@ -1804,6 +1869,8 @@ class EarningsCallsApi:
         _collection_formats: Dict[str, str] = {
             'section': 'multi',
             'kind': 'multi',
+            'category': 'multi',
+            'include': 'multi',
         }
 
         _path_params: Dict[str, str] = {}
@@ -1841,6 +1908,26 @@ class EarningsCallsApi:
             
             _query_params.append(('event_id', event_id))
             
+        if category is not None:
+            
+            _query_params.append(('category', category))
+            
+        if group is not None:
+            
+            _query_params.append(('group', group))
+            
+        if fiscal_year is not None:
+            
+            _query_params.append(('fiscal_year', fiscal_year))
+            
+        if fiscal_quarter is not None:
+            
+            _query_params.append(('fiscal_quarter', fiscal_quarter))
+            
+        if include is not None:
+            
+            _query_params.append(('include', include))
+            
         if limit is not None:
             
             _query_params.append(('limit', limit))
@@ -2297,7 +2384,7 @@ class EarningsCallsApi:
     ) -> EarningsCallsDocumentSearch200Response:
         """Search investor documents
 
-        Semantic search over the page text of investor documents: the documents of earnings calls (CFO commentary, shareholder letters, data sheets, the company's own transcripts) and companies' IR libraries (annual reports, proxy statements, ESG reports, investor-day decks).  ### What you get  - Up to 20 passages from company-published documents, with page numbers — not verified facts — and a signed URL of the file (open it at `#page=<page>`).  - Filter by company (`identifier`), kind, IR section, year or table.  ### Errors  - `429 upstream_rate_limited` and `503 search_unavailable` carry `Retry-After`.  - `503 search_disabled` while search is switched off.  ### Freshness and coverage  - Data is replicated from the capture pipeline with a lag of about a minute.  - Only US earnings calls captured by Invinite are served.  Minimum tier for display: FREE.
+        Semantic search over the page text of investor documents: the documents of earnings calls (CFO commentary, shareholder letters, data sheets, the company's own transcripts) and companies' IR libraries (annual reports, proxy statements, ESG reports, investor-day decks).  ### What you get  - Up to 20 passages from company-published documents, with page numbers — not verified facts — and a signed URL of the file (open it at `#page=<page>`).  - Filter by company (`identifier`), kind, IR section, year or table.  - Each hit names the document's folder of the company's document tree (`group`, e.g. `earnings/fy2027/q2`, `group_label`, `category`).  ### Errors  - `429 upstream_rate_limited` and `503 search_unavailable` carry `Retry-After`.  - `503 search_disabled` while search is switched off.  ### Freshness and coverage  - Data is replicated from the capture pipeline with a lag of about a minute.  - Only US earnings calls captured by Invinite are served.  Minimum tier for display: FREE.
 
         :param q: The question or phrase to search for (required)
         :type q: str
@@ -2394,7 +2481,7 @@ class EarningsCallsApi:
     ) -> ApiResponse[EarningsCallsDocumentSearch200Response]:
         """Search investor documents
 
-        Semantic search over the page text of investor documents: the documents of earnings calls (CFO commentary, shareholder letters, data sheets, the company's own transcripts) and companies' IR libraries (annual reports, proxy statements, ESG reports, investor-day decks).  ### What you get  - Up to 20 passages from company-published documents, with page numbers — not verified facts — and a signed URL of the file (open it at `#page=<page>`).  - Filter by company (`identifier`), kind, IR section, year or table.  ### Errors  - `429 upstream_rate_limited` and `503 search_unavailable` carry `Retry-After`.  - `503 search_disabled` while search is switched off.  ### Freshness and coverage  - Data is replicated from the capture pipeline with a lag of about a minute.  - Only US earnings calls captured by Invinite are served.  Minimum tier for display: FREE.
+        Semantic search over the page text of investor documents: the documents of earnings calls (CFO commentary, shareholder letters, data sheets, the company's own transcripts) and companies' IR libraries (annual reports, proxy statements, ESG reports, investor-day decks).  ### What you get  - Up to 20 passages from company-published documents, with page numbers — not verified facts — and a signed URL of the file (open it at `#page=<page>`).  - Filter by company (`identifier`), kind, IR section, year or table.  - Each hit names the document's folder of the company's document tree (`group`, e.g. `earnings/fy2027/q2`, `group_label`, `category`).  ### Errors  - `429 upstream_rate_limited` and `503 search_unavailable` carry `Retry-After`.  - `503 search_disabled` while search is switched off.  ### Freshness and coverage  - Data is replicated from the capture pipeline with a lag of about a minute.  - Only US earnings calls captured by Invinite are served.  Minimum tier for display: FREE.
 
         :param q: The question or phrase to search for (required)
         :type q: str
@@ -2491,7 +2578,7 @@ class EarningsCallsApi:
     ) -> RESTResponseType:
         """Search investor documents
 
-        Semantic search over the page text of investor documents: the documents of earnings calls (CFO commentary, shareholder letters, data sheets, the company's own transcripts) and companies' IR libraries (annual reports, proxy statements, ESG reports, investor-day decks).  ### What you get  - Up to 20 passages from company-published documents, with page numbers — not verified facts — and a signed URL of the file (open it at `#page=<page>`).  - Filter by company (`identifier`), kind, IR section, year or table.  ### Errors  - `429 upstream_rate_limited` and `503 search_unavailable` carry `Retry-After`.  - `503 search_disabled` while search is switched off.  ### Freshness and coverage  - Data is replicated from the capture pipeline with a lag of about a minute.  - Only US earnings calls captured by Invinite are served.  Minimum tier for display: FREE.
+        Semantic search over the page text of investor documents: the documents of earnings calls (CFO commentary, shareholder letters, data sheets, the company's own transcripts) and companies' IR libraries (annual reports, proxy statements, ESG reports, investor-day decks).  ### What you get  - Up to 20 passages from company-published documents, with page numbers — not verified facts — and a signed URL of the file (open it at `#page=<page>`).  - Filter by company (`identifier`), kind, IR section, year or table.  - Each hit names the document's folder of the company's document tree (`group`, e.g. `earnings/fy2027/q2`, `group_label`, `category`).  ### Errors  - `429 upstream_rate_limited` and `503 search_unavailable` carry `Retry-After`.  - `503 search_disabled` while search is switched off.  ### Freshness and coverage  - Data is replicated from the capture pipeline with a lag of about a minute.  - Only US earnings calls captured by Invinite are served.  Minimum tier for display: FREE.
 
         :param q: The question or phrase to search for (required)
         :type q: str
@@ -2667,6 +2754,8 @@ class EarningsCallsApi:
         var_date: Annotated[Optional[date], Field(description="Day of the call (YYYY-MM-DD): a calendar day in New York time (America/New_York); a call without a confirmed time is listed on its announced date")] = None,
         event_type: Annotated[Optional[StrictStr], Field(description="Event type the date selector matches (default earnings_call): investor_day, conference, agm or other address a non-earnings event by its date; year+quarter select earnings calls only")] = None,
         kind: Annotated[Optional[List[StrictStr]], Field(description="Only these kinds, comma-separated or repeated: cfo_commentary, financial_data, shareholder_letter, fact_sheet, company_transcript, prepared_remarks, sec_filing, infographic, other")] = None,
+        category: Annotated[Optional[List[StrictStr]], Field(description="Only these tree categories, comma-separated or repeated: earnings, events, reports, presentations, governance, esg, shareholder, other")] = None,
+        group: Annotated[Optional[StrictStr], Field(description="Only this folder of the document tree and everything below it (prefix match), e.g. earnings/fy2027 or earnings/fy2027/q2 or reports")] = None,
         include: Annotated[Optional[List[StrictStr]], Field(description="Extra data, comma-separated or repeated: `body` = the extracted text")] = None,
         limit: Annotated[Optional[Annotated[int, Field(le=100, strict=True, ge=1)]], Field(description="Maximum number of documents to return")] = None,
         offset: Annotated[Optional[Annotated[int, Field(strict=True, ge=0)]], Field(description="Number of documents to skip for pagination")] = None,
@@ -2685,7 +2774,7 @@ class EarningsCallsApi:
     ) -> EarningsCallsDocuments200Response:
         """Earnings call documents
 
-        Further investor documents of one earnings call, ordered by kind: CFO commentary, financial data sheets, shareholder letters, fact sheets, the company's own transcript, its prepared remarks / call script, 10-Q / 10-K links. Infographics are stored as fact sheets.  ### What you get  - Stored files come as signed URLs; link-only rows (`sec_filing`) have `url` null and point to EDGAR through `source_url`.  - Files are served as short-lived signed URLs (see `expires_at`), never proxied; request a fresh response after expiry.  - Each document carries its `trust_tier`.  - `documents` is `[]` for a call without further documents (`has_documents` tells ahead).  ### Errors  - `503 media_unavailable` while media signing is not configured.  ### Choose the call  - By `event_id`, or  - by `identifier` with `year` + `quarter` (fiscal), or  - by `identifier` with `date` (a calendar day in New York time (America/New_York); a call without a confirmed time is listed on its announced date). With `date`, `event_type` (default `earnings_call`) also addresses an investor day, conference or shareholder meeting.  ### Freshness and coverage  - Data is replicated from the capture pipeline with a lag of about a minute.  - Only US earnings calls captured by Invinite are served.  Minimum tier for display: FREE.
+        Further investor documents of one earnings call, ordered by kind: CFO commentary, financial data sheets, shareholder letters, fact sheets, the company's own transcript, its prepared remarks / call script, 10-Q / 10-K links. Infographics are stored as fact sheets.  ### What you get  - Stored files come as signed URLs; link-only rows (`sec_filing`) have `url` null and point to EDGAR through `source_url`.  - Files are served as short-lived signed URLs (see `expires_at`), never proxied; request a fresh response after expiry.  - Each document carries its `trust_tier` and its folder of the company's document tree (`group`, `group_label`, `category`; filter with `category` / `group`). A call's own files sit in its earnings folder, e.g. `earnings/fy2027/q2`.  ### The document tree  Every stored document sits in one folder of the company's document tree: `group` (its path) under one of eight `category` spine folders, in this order: `earnings` (`earnings/fy2027/q2` = one fiscal quarter's call: release, deck, CFO commentary, data sheets, transcript; `earnings/cy2026/08-26` = a call without a fiscal period), `events` (`events/2026/09-10-<event>` = a conference, investor day or shareholder meeting), `reports` (`reports/2025`: annual reports, proxy statements, annual letters), `presentations` (`presentations/2024`), `governance`, `esg` (`esg/2025`), `shareholder` (`shareholder/tax`, `shareholder/dividends`, `shareholder/stock`) and `other` (`other/faq`, `other/fact-sheets`, `other/financial-data[/2025]`, `other/web-pages`, `other/documents`). `…/undated` = no date could be read. `group` and `category` are null while a document has not been placed yet.  - `documents` is `[]` for a call without further documents (`has_documents` tells ahead).  ### Errors  - `503 media_unavailable` while media signing is not configured.  ### Choose the call  - By `event_id`, or  - by `identifier` with `year` + `quarter` (fiscal), or  - by `identifier` with `date` (a calendar day in New York time (America/New_York); a call without a confirmed time is listed on its announced date). With `date`, `event_type` (default `earnings_call`) also addresses an investor day, conference or shareholder meeting.  ### Freshness and coverage  - Data is replicated from the capture pipeline with a lag of about a minute.  - Only US earnings calls captured by Invinite are served.  Minimum tier for display: FREE.
 
         :param event_id: Event identifier (event_id of any earnings-calls response); wins over the other selectors
         :type event_id: UUID
@@ -2701,6 +2790,10 @@ class EarningsCallsApi:
         :type event_type: str
         :param kind: Only these kinds, comma-separated or repeated: cfo_commentary, financial_data, shareholder_letter, fact_sheet, company_transcript, prepared_remarks, sec_filing, infographic, other
         :type kind: List[str]
+        :param category: Only these tree categories, comma-separated or repeated: earnings, events, reports, presentations, governance, esg, shareholder, other
+        :type category: List[str]
+        :param group: Only this folder of the document tree and everything below it (prefix match), e.g. earnings/fy2027 or earnings/fy2027/q2 or reports
+        :type group: str
         :param include: Extra data, comma-separated or repeated: `body` = the extracted text
         :type include: List[str]
         :param limit: Maximum number of documents to return
@@ -2737,6 +2830,8 @@ class EarningsCallsApi:
             var_date=var_date,
             event_type=event_type,
             kind=kind,
+            category=category,
+            group=group,
             include=include,
             limit=limit,
             offset=offset,
@@ -2775,6 +2870,8 @@ class EarningsCallsApi:
         var_date: Annotated[Optional[date], Field(description="Day of the call (YYYY-MM-DD): a calendar day in New York time (America/New_York); a call without a confirmed time is listed on its announced date")] = None,
         event_type: Annotated[Optional[StrictStr], Field(description="Event type the date selector matches (default earnings_call): investor_day, conference, agm or other address a non-earnings event by its date; year+quarter select earnings calls only")] = None,
         kind: Annotated[Optional[List[StrictStr]], Field(description="Only these kinds, comma-separated or repeated: cfo_commentary, financial_data, shareholder_letter, fact_sheet, company_transcript, prepared_remarks, sec_filing, infographic, other")] = None,
+        category: Annotated[Optional[List[StrictStr]], Field(description="Only these tree categories, comma-separated or repeated: earnings, events, reports, presentations, governance, esg, shareholder, other")] = None,
+        group: Annotated[Optional[StrictStr], Field(description="Only this folder of the document tree and everything below it (prefix match), e.g. earnings/fy2027 or earnings/fy2027/q2 or reports")] = None,
         include: Annotated[Optional[List[StrictStr]], Field(description="Extra data, comma-separated or repeated: `body` = the extracted text")] = None,
         limit: Annotated[Optional[Annotated[int, Field(le=100, strict=True, ge=1)]], Field(description="Maximum number of documents to return")] = None,
         offset: Annotated[Optional[Annotated[int, Field(strict=True, ge=0)]], Field(description="Number of documents to skip for pagination")] = None,
@@ -2793,7 +2890,7 @@ class EarningsCallsApi:
     ) -> ApiResponse[EarningsCallsDocuments200Response]:
         """Earnings call documents
 
-        Further investor documents of one earnings call, ordered by kind: CFO commentary, financial data sheets, shareholder letters, fact sheets, the company's own transcript, its prepared remarks / call script, 10-Q / 10-K links. Infographics are stored as fact sheets.  ### What you get  - Stored files come as signed URLs; link-only rows (`sec_filing`) have `url` null and point to EDGAR through `source_url`.  - Files are served as short-lived signed URLs (see `expires_at`), never proxied; request a fresh response after expiry.  - Each document carries its `trust_tier`.  - `documents` is `[]` for a call without further documents (`has_documents` tells ahead).  ### Errors  - `503 media_unavailable` while media signing is not configured.  ### Choose the call  - By `event_id`, or  - by `identifier` with `year` + `quarter` (fiscal), or  - by `identifier` with `date` (a calendar day in New York time (America/New_York); a call without a confirmed time is listed on its announced date). With `date`, `event_type` (default `earnings_call`) also addresses an investor day, conference or shareholder meeting.  ### Freshness and coverage  - Data is replicated from the capture pipeline with a lag of about a minute.  - Only US earnings calls captured by Invinite are served.  Minimum tier for display: FREE.
+        Further investor documents of one earnings call, ordered by kind: CFO commentary, financial data sheets, shareholder letters, fact sheets, the company's own transcript, its prepared remarks / call script, 10-Q / 10-K links. Infographics are stored as fact sheets.  ### What you get  - Stored files come as signed URLs; link-only rows (`sec_filing`) have `url` null and point to EDGAR through `source_url`.  - Files are served as short-lived signed URLs (see `expires_at`), never proxied; request a fresh response after expiry.  - Each document carries its `trust_tier` and its folder of the company's document tree (`group`, `group_label`, `category`; filter with `category` / `group`). A call's own files sit in its earnings folder, e.g. `earnings/fy2027/q2`.  ### The document tree  Every stored document sits in one folder of the company's document tree: `group` (its path) under one of eight `category` spine folders, in this order: `earnings` (`earnings/fy2027/q2` = one fiscal quarter's call: release, deck, CFO commentary, data sheets, transcript; `earnings/cy2026/08-26` = a call without a fiscal period), `events` (`events/2026/09-10-<event>` = a conference, investor day or shareholder meeting), `reports` (`reports/2025`: annual reports, proxy statements, annual letters), `presentations` (`presentations/2024`), `governance`, `esg` (`esg/2025`), `shareholder` (`shareholder/tax`, `shareholder/dividends`, `shareholder/stock`) and `other` (`other/faq`, `other/fact-sheets`, `other/financial-data[/2025]`, `other/web-pages`, `other/documents`). `…/undated` = no date could be read. `group` and `category` are null while a document has not been placed yet.  - `documents` is `[]` for a call without further documents (`has_documents` tells ahead).  ### Errors  - `503 media_unavailable` while media signing is not configured.  ### Choose the call  - By `event_id`, or  - by `identifier` with `year` + `quarter` (fiscal), or  - by `identifier` with `date` (a calendar day in New York time (America/New_York); a call without a confirmed time is listed on its announced date). With `date`, `event_type` (default `earnings_call`) also addresses an investor day, conference or shareholder meeting.  ### Freshness and coverage  - Data is replicated from the capture pipeline with a lag of about a minute.  - Only US earnings calls captured by Invinite are served.  Minimum tier for display: FREE.
 
         :param event_id: Event identifier (event_id of any earnings-calls response); wins over the other selectors
         :type event_id: UUID
@@ -2809,6 +2906,10 @@ class EarningsCallsApi:
         :type event_type: str
         :param kind: Only these kinds, comma-separated or repeated: cfo_commentary, financial_data, shareholder_letter, fact_sheet, company_transcript, prepared_remarks, sec_filing, infographic, other
         :type kind: List[str]
+        :param category: Only these tree categories, comma-separated or repeated: earnings, events, reports, presentations, governance, esg, shareholder, other
+        :type category: List[str]
+        :param group: Only this folder of the document tree and everything below it (prefix match), e.g. earnings/fy2027 or earnings/fy2027/q2 or reports
+        :type group: str
         :param include: Extra data, comma-separated or repeated: `body` = the extracted text
         :type include: List[str]
         :param limit: Maximum number of documents to return
@@ -2845,6 +2946,8 @@ class EarningsCallsApi:
             var_date=var_date,
             event_type=event_type,
             kind=kind,
+            category=category,
+            group=group,
             include=include,
             limit=limit,
             offset=offset,
@@ -2883,6 +2986,8 @@ class EarningsCallsApi:
         var_date: Annotated[Optional[date], Field(description="Day of the call (YYYY-MM-DD): a calendar day in New York time (America/New_York); a call without a confirmed time is listed on its announced date")] = None,
         event_type: Annotated[Optional[StrictStr], Field(description="Event type the date selector matches (default earnings_call): investor_day, conference, agm or other address a non-earnings event by its date; year+quarter select earnings calls only")] = None,
         kind: Annotated[Optional[List[StrictStr]], Field(description="Only these kinds, comma-separated or repeated: cfo_commentary, financial_data, shareholder_letter, fact_sheet, company_transcript, prepared_remarks, sec_filing, infographic, other")] = None,
+        category: Annotated[Optional[List[StrictStr]], Field(description="Only these tree categories, comma-separated or repeated: earnings, events, reports, presentations, governance, esg, shareholder, other")] = None,
+        group: Annotated[Optional[StrictStr], Field(description="Only this folder of the document tree and everything below it (prefix match), e.g. earnings/fy2027 or earnings/fy2027/q2 or reports")] = None,
         include: Annotated[Optional[List[StrictStr]], Field(description="Extra data, comma-separated or repeated: `body` = the extracted text")] = None,
         limit: Annotated[Optional[Annotated[int, Field(le=100, strict=True, ge=1)]], Field(description="Maximum number of documents to return")] = None,
         offset: Annotated[Optional[Annotated[int, Field(strict=True, ge=0)]], Field(description="Number of documents to skip for pagination")] = None,
@@ -2901,7 +3006,7 @@ class EarningsCallsApi:
     ) -> RESTResponseType:
         """Earnings call documents
 
-        Further investor documents of one earnings call, ordered by kind: CFO commentary, financial data sheets, shareholder letters, fact sheets, the company's own transcript, its prepared remarks / call script, 10-Q / 10-K links. Infographics are stored as fact sheets.  ### What you get  - Stored files come as signed URLs; link-only rows (`sec_filing`) have `url` null and point to EDGAR through `source_url`.  - Files are served as short-lived signed URLs (see `expires_at`), never proxied; request a fresh response after expiry.  - Each document carries its `trust_tier`.  - `documents` is `[]` for a call without further documents (`has_documents` tells ahead).  ### Errors  - `503 media_unavailable` while media signing is not configured.  ### Choose the call  - By `event_id`, or  - by `identifier` with `year` + `quarter` (fiscal), or  - by `identifier` with `date` (a calendar day in New York time (America/New_York); a call without a confirmed time is listed on its announced date). With `date`, `event_type` (default `earnings_call`) also addresses an investor day, conference or shareholder meeting.  ### Freshness and coverage  - Data is replicated from the capture pipeline with a lag of about a minute.  - Only US earnings calls captured by Invinite are served.  Minimum tier for display: FREE.
+        Further investor documents of one earnings call, ordered by kind: CFO commentary, financial data sheets, shareholder letters, fact sheets, the company's own transcript, its prepared remarks / call script, 10-Q / 10-K links. Infographics are stored as fact sheets.  ### What you get  - Stored files come as signed URLs; link-only rows (`sec_filing`) have `url` null and point to EDGAR through `source_url`.  - Files are served as short-lived signed URLs (see `expires_at`), never proxied; request a fresh response after expiry.  - Each document carries its `trust_tier` and its folder of the company's document tree (`group`, `group_label`, `category`; filter with `category` / `group`). A call's own files sit in its earnings folder, e.g. `earnings/fy2027/q2`.  ### The document tree  Every stored document sits in one folder of the company's document tree: `group` (its path) under one of eight `category` spine folders, in this order: `earnings` (`earnings/fy2027/q2` = one fiscal quarter's call: release, deck, CFO commentary, data sheets, transcript; `earnings/cy2026/08-26` = a call without a fiscal period), `events` (`events/2026/09-10-<event>` = a conference, investor day or shareholder meeting), `reports` (`reports/2025`: annual reports, proxy statements, annual letters), `presentations` (`presentations/2024`), `governance`, `esg` (`esg/2025`), `shareholder` (`shareholder/tax`, `shareholder/dividends`, `shareholder/stock`) and `other` (`other/faq`, `other/fact-sheets`, `other/financial-data[/2025]`, `other/web-pages`, `other/documents`). `…/undated` = no date could be read. `group` and `category` are null while a document has not been placed yet.  - `documents` is `[]` for a call without further documents (`has_documents` tells ahead).  ### Errors  - `503 media_unavailable` while media signing is not configured.  ### Choose the call  - By `event_id`, or  - by `identifier` with `year` + `quarter` (fiscal), or  - by `identifier` with `date` (a calendar day in New York time (America/New_York); a call without a confirmed time is listed on its announced date). With `date`, `event_type` (default `earnings_call`) also addresses an investor day, conference or shareholder meeting.  ### Freshness and coverage  - Data is replicated from the capture pipeline with a lag of about a minute.  - Only US earnings calls captured by Invinite are served.  Minimum tier for display: FREE.
 
         :param event_id: Event identifier (event_id of any earnings-calls response); wins over the other selectors
         :type event_id: UUID
@@ -2917,6 +3022,10 @@ class EarningsCallsApi:
         :type event_type: str
         :param kind: Only these kinds, comma-separated or repeated: cfo_commentary, financial_data, shareholder_letter, fact_sheet, company_transcript, prepared_remarks, sec_filing, infographic, other
         :type kind: List[str]
+        :param category: Only these tree categories, comma-separated or repeated: earnings, events, reports, presentations, governance, esg, shareholder, other
+        :type category: List[str]
+        :param group: Only this folder of the document tree and everything below it (prefix match), e.g. earnings/fy2027 or earnings/fy2027/q2 or reports
+        :type group: str
         :param include: Extra data, comma-separated or repeated: `body` = the extracted text
         :type include: List[str]
         :param limit: Maximum number of documents to return
@@ -2953,6 +3062,8 @@ class EarningsCallsApi:
             var_date=var_date,
             event_type=event_type,
             kind=kind,
+            category=category,
+            group=group,
             include=include,
             limit=limit,
             offset=offset,
@@ -2986,6 +3097,8 @@ class EarningsCallsApi:
         var_date,
         event_type,
         kind,
+        category,
+        group,
         include,
         limit,
         offset,
@@ -2999,6 +3112,7 @@ class EarningsCallsApi:
 
         _collection_formats: Dict[str, str] = {
             'kind': 'multi',
+            'category': 'multi',
             'include': 'multi',
         }
 
@@ -3050,6 +3164,14 @@ class EarningsCallsApi:
             
             _query_params.append(('kind', kind))
             
+        if category is not None:
+            
+            _query_params.append(('category', category))
+            
+        if group is not None:
+            
+            _query_params.append(('group', group))
+            
         if include is not None:
             
             _query_params.append(('include', include))