invinite-data-api 0.4.0__tar.gz → 0.6.0__tar.gz

{invinite_data_api-0.4.0 → invinite_data_api-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: invinite_data_api
-Version: 0.4.0
+Version: 0.6.0
 Summary: Typed Python client for the Invinite Data API
 Home-page: 
 Author: OpenAPI Generator community

{invinite_data_api-0.4.0 → invinite_data_api-0.6.0}/invinite_data_api/__init__.py

@@ -14,7 +14,7 @@
 """  # noqa: E501
 
 
-__version__ = "0.4.0"
+__version__ = "0.6.0"
 
 # Define package exports
 __all__ = [
@@ -190,6 +190,11 @@ __all__ = [
     "InternalServerError",
     "IposList200Response",
     "IposList200ResponseIposInner",
+    "IposList200ResponseIposInnerRegistration",
+    "IposRegistrationsList200Response",
+    "IposRegistrationsList200ResponseRegistrationsInner",
+    "IposRegistrationsList200ResponseRegistrationsInnerFilingsInner",
+    "IposRegistrationsList200ResponseRegistrationsInnerMassive",
     "MarketHolidays200Response",
     "MarketHolidays200ResponseHolidaysInner",
     "MatchSpan",
@@ -200,6 +205,7 @@ __all__ = [
     "MetadataAvailableSectionIds200ResponseFormTypesInnerSectionsInner",
     "NotFoundError",
     "PresentationFact",
+    "ProposedSymbol",
     "SearchCoverage",
     "SearchCoverageLeg",
     "SecFilingsAvailableFormTypes200Response",
@@ -455,6 +461,11 @@ from invinite_data_api.models.institutional_ownership_transactions200_response_t
 from invinite_data_api.models.internal_server_error import InternalServerError as InternalServerError
 from invinite_data_api.models.ipos_list200_response import IposList200Response as IposList200Response
 from invinite_data_api.models.ipos_list200_response_ipos_inner import IposList200ResponseIposInner as IposList200ResponseIposInner
+from invinite_data_api.models.ipos_list200_response_ipos_inner_registration import IposList200ResponseIposInnerRegistration as IposList200ResponseIposInnerRegistration
+from invinite_data_api.models.ipos_registrations_list200_response import IposRegistrationsList200Response as IposRegistrationsList200Response
+from invinite_data_api.models.ipos_registrations_list200_response_registrations_inner import IposRegistrationsList200ResponseRegistrationsInner as IposRegistrationsList200ResponseRegistrationsInner
+from invinite_data_api.models.ipos_registrations_list200_response_registrations_inner_filings_inner import IposRegistrationsList200ResponseRegistrationsInnerFilingsInner as IposRegistrationsList200ResponseRegistrationsInnerFilingsInner
+from invinite_data_api.models.ipos_registrations_list200_response_registrations_inner_massive import IposRegistrationsList200ResponseRegistrationsInnerMassive as IposRegistrationsList200ResponseRegistrationsInnerMassive
 from invinite_data_api.models.market_holidays200_response import MarketHolidays200Response as MarketHolidays200Response
 from invinite_data_api.models.market_holidays200_response_holidays_inner import MarketHolidays200ResponseHolidaysInner as MarketHolidays200ResponseHolidaysInner
 from invinite_data_api.models.match_span import MatchSpan as MatchSpan
@@ -465,6 +476,7 @@ from invinite_data_api.models.metadata_available_section_ids200_response_form_ty
 from invinite_data_api.models.metadata_available_section_ids200_response_form_types_inner_sections_inner import MetadataAvailableSectionIds200ResponseFormTypesInnerSectionsInner as MetadataAvailableSectionIds200ResponseFormTypesInnerSectionsInner
 from invinite_data_api.models.not_found_error import NotFoundError as NotFoundError
 from invinite_data_api.models.presentation_fact import PresentationFact as PresentationFact
+from invinite_data_api.models.proposed_symbol import ProposedSymbol as ProposedSymbol
 from invinite_data_api.models.search_coverage import SearchCoverage as SearchCoverage
 from invinite_data_api.models.search_coverage_leg import SearchCoverageLeg as SearchCoverageLeg
 from invinite_data_api.models.sec_filings_available_form_types200_response import SecFilingsAvailableFormTypes200Response as SecFilingsAvailableFormTypes200Response

{invinite_data_api-0.4.0 → invinite_data_api-0.6.0}/invinite_data_api/api/earnings_calls_api.py

@@ -2353,8 +2353,8 @@ class EarningsCallsApi:
     @validate_call
     def earnings_calls_document_search(
         self,
-        q: Annotated[str, Field(min_length=2, strict=True, max_length=500, description="The keywords, exact text (mode=literal) or question (semantic / hybrid) to search for")],
-        mode: Annotated[Optional[StrictStr], Field(description="lexical (keywords, default), literal (exact characters), semantic (meaning) or hybrid (lexical + semantic, fused)")] = None,
+        q: Annotated[str, Field(min_length=2, strict=True, max_length=500, description="The keywords or phrases (mode=lexical) or exact text (mode=literal) to search for")],
+        mode: Annotated[Optional[StrictStr], Field(description="lexical (keywords and phrases, default) or literal (exact characters)")] = None,
         case_sensitive: Annotated[Optional[StrictStr], Field(description="mode=literal only: \"false\" matches regardless of case (default \"true\": case-sensitive)")] = None,
         identifier: Annotated[Optional[StrictStr], Field(description="Search one company's documents (ticker or CIK, US only)")] = 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,
@@ -2377,11 +2377,11 @@ class EarningsCallsApi:
     ) -> EarningsCallsDocumentSearch200Response:
         """Search investor documents
 
-        Search the page text of investor documents by keywords (default `mode=lexical`), exact text (`literal`), meaning (`semantic`) or both (`hybrid`): 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`), how it matched (`match`); the response says how much of the searched documents is indexed (`coverage`).  ### Search modes  - `lexical` (default): keyword search — English full text with stemming; quoted phrases, `OR` and `-word` work (`websearch_to_tsquery`); ranked by `ts_rank_cd`. Finance tokens such as `FY2027`, `10-K`, `Q3` or `EBITDA` match as written.  - `literal`: the exact characters of the passage — no stemming, no fuzzy matching, `%` / `_` / `\\` match themselves; case-sensitive unless `case_sensitive=false` (only allowed with `mode=literal`; default `true`). A pattern under 3 characters needs `identifier`. Newest first; `score` is 0.  - `semantic`: meaning-based search (multilingual sentence embeddings); `score` is the cosine similarity.  - `hybrid`: `lexical` and `semantic` fused by reciprocal rank (`score = Σ 1 / (60 + rank)`, equal weights, ties by passage); `match.lexical_rank` / `match.semantic_rank` give each leg's rank. Best for natural-language questions.  - `match.spans` mark the matched characters in `text` (zero-based, end-exclusive Unicode code-point offsets); `text` is cut around the first match (`text_truncated`). Semantic matches carry no spans. An exact mode never expands into semantic or fuzzy results. Every mode costs the same.  ### Coverage  - `coverage.completeness` = `complete` (every searched passage is indexed: no hits is a genuine no-result), `partial` (some passages are still being indexed or failed, or a hybrid leg was unavailable) or `unknown` (a mode's index is not built for the searched scope, e.g. `semantic_index_missing`) — read it before treating an empty list as \"not found\".  - `coverage.lexical` / `coverage.semantic` count the searched transcripts or documents per index (`indexed`, `pending`, `failed`); null for a leg the mode did not use. `reasons` lists why the answer may be incomplete. The counts come from the indexing ledger: a transcript or document whose current version the index has not confirmed counts as `pending`; when they cannot be read, the hits are still returned with `completeness: unknown`, both legs null and `coverage_unavailable`.  ### Changelog  - 2026-10: modes added and the default mode changed from semantic to `lexical`; pass `mode=semantic` for the previous behaviour (or `mode=hybrid` for natural-language questions).  ### Errors  - `400` for a `mode=lexical` query of stopwords only (no searchable words), for `case_sensitive` with any mode but `literal`, and for a `mode=literal` pattern under 3 characters without a scope (see Search modes).  - `429 upstream_rate_limited` and `503 search_unavailable` carry `Retry-After` (`503` also when a keyword search runs over its time limit — never an empty answer).  - `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.
+        Search the page text of investor documents by keywords (default `mode=lexical`) or exact text (`literal`): 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`), how it matched (`match`); the response says how much of the searched documents is indexed (`coverage`).  ### Search modes  - `lexical` (default): keyword search — English full text with stemming; quoted phrases, `OR` and `-word` work; every word must match; ranked by `ts_rank_cd` (`websearch_to_tsquery`). Finance tokens such as `FY2027`, `10-K`, `Q3` or `EBITDA` match as written.  - `literal`: the exact characters of the passage — no stemming, no fuzzy matching, `%` / `_` / `\\` match themselves; case-sensitive unless `case_sensitive=false` (only allowed with `mode=literal`; default `true`). A pattern under 3 characters needs `identifier`. Newest first; `score` is 0.  - `match.spans` mark the matched characters in `text` (zero-based, end-exclusive Unicode code-point offsets); `text` is cut around the first match (`text_truncated`); `match.lexical_rank` is the hit's 1-based rank. Neither mode expands into fuzzy results. Both modes cost the same.  ### Coverage  - `coverage.completeness` = `complete` (every searched passage is indexed: no hits is a genuine no-result), `partial` (some passages are still being indexed or failed) or `unknown` (nothing of the searched scope is indexed yet, or the counts could not be read) — read it before treating an empty list as \"not found\".  - `coverage.lexical` counts the searched transcripts or documents in the text index (`indexed`, `pending`, `failed`). `reasons` lists why the answer may be incomplete. The counts come from the indexing ledger: a transcript or document whose current version the index has not confirmed counts as `pending`; when they cannot be read, the hits are still returned with `completeness: unknown`, `lexical` null and `coverage_unavailable`.  ### Changelog  - 2026-10: modes added and the default mode changed from semantic to `lexical`.  - 2026-11: modes `semantic` and `hybrid` removed; vector search is gone, pass `mode=lexical` (default) or `literal`.  ### Errors  - `400` for a `mode=lexical` query of stopwords only (no searchable words), for `case_sensitive` with any mode but `literal`, and for a `mode=literal` pattern under 3 characters without a scope (see Search modes).  - `503 search_unavailable` (a search over its time limit — never an empty answer) carries `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 keywords, exact text (mode=literal) or question (semantic / hybrid) to search for (required)
+        :param q: The keywords or phrases (mode=lexical) or exact text (mode=literal) to search for (required)
         :type q: str
-        :param mode: lexical (keywords, default), literal (exact characters), semantic (meaning) or hybrid (lexical + semantic, fused)
+        :param mode: lexical (keywords and phrases, default) or literal (exact characters)
         :type mode: str
         :param case_sensitive: mode=literal only: \"false\" matches regardless of case (default \"true\": case-sensitive)
         :type case_sensitive: str
@@ -2440,7 +2440,6 @@ class EarningsCallsApi:
             '400': "CompanyAvailableCompanies401Response",
             '401': "CompanyAvailableCompanies401Response",
             '404': "CompanyAvailableCompanies401Response",
-            '429': "CompanyAvailableCompanies401Response",
             '500': "CompanyAvailableCompanies401Response",
             '503': "CompanyAvailableCompanies401Response",
         }
@@ -2458,8 +2457,8 @@ class EarningsCallsApi:
     @validate_call
     def earnings_calls_document_search_with_http_info(
         self,
-        q: Annotated[str, Field(min_length=2, strict=True, max_length=500, description="The keywords, exact text (mode=literal) or question (semantic / hybrid) to search for")],
-        mode: Annotated[Optional[StrictStr], Field(description="lexical (keywords, default), literal (exact characters), semantic (meaning) or hybrid (lexical + semantic, fused)")] = None,
+        q: Annotated[str, Field(min_length=2, strict=True, max_length=500, description="The keywords or phrases (mode=lexical) or exact text (mode=literal) to search for")],
+        mode: Annotated[Optional[StrictStr], Field(description="lexical (keywords and phrases, default) or literal (exact characters)")] = None,
         case_sensitive: Annotated[Optional[StrictStr], Field(description="mode=literal only: \"false\" matches regardless of case (default \"true\": case-sensitive)")] = None,
         identifier: Annotated[Optional[StrictStr], Field(description="Search one company's documents (ticker or CIK, US only)")] = 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,
@@ -2482,11 +2481,11 @@ class EarningsCallsApi:
     ) -> ApiResponse[EarningsCallsDocumentSearch200Response]:
         """Search investor documents
 
-        Search the page text of investor documents by keywords (default `mode=lexical`), exact text (`literal`), meaning (`semantic`) or both (`hybrid`): 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`), how it matched (`match`); the response says how much of the searched documents is indexed (`coverage`).  ### Search modes  - `lexical` (default): keyword search — English full text with stemming; quoted phrases, `OR` and `-word` work (`websearch_to_tsquery`); ranked by `ts_rank_cd`. Finance tokens such as `FY2027`, `10-K`, `Q3` or `EBITDA` match as written.  - `literal`: the exact characters of the passage — no stemming, no fuzzy matching, `%` / `_` / `\\` match themselves; case-sensitive unless `case_sensitive=false` (only allowed with `mode=literal`; default `true`). A pattern under 3 characters needs `identifier`. Newest first; `score` is 0.  - `semantic`: meaning-based search (multilingual sentence embeddings); `score` is the cosine similarity.  - `hybrid`: `lexical` and `semantic` fused by reciprocal rank (`score = Σ 1 / (60 + rank)`, equal weights, ties by passage); `match.lexical_rank` / `match.semantic_rank` give each leg's rank. Best for natural-language questions.  - `match.spans` mark the matched characters in `text` (zero-based, end-exclusive Unicode code-point offsets); `text` is cut around the first match (`text_truncated`). Semantic matches carry no spans. An exact mode never expands into semantic or fuzzy results. Every mode costs the same.  ### Coverage  - `coverage.completeness` = `complete` (every searched passage is indexed: no hits is a genuine no-result), `partial` (some passages are still being indexed or failed, or a hybrid leg was unavailable) or `unknown` (a mode's index is not built for the searched scope, e.g. `semantic_index_missing`) — read it before treating an empty list as \"not found\".  - `coverage.lexical` / `coverage.semantic` count the searched transcripts or documents per index (`indexed`, `pending`, `failed`); null for a leg the mode did not use. `reasons` lists why the answer may be incomplete. The counts come from the indexing ledger: a transcript or document whose current version the index has not confirmed counts as `pending`; when they cannot be read, the hits are still returned with `completeness: unknown`, both legs null and `coverage_unavailable`.  ### Changelog  - 2026-10: modes added and the default mode changed from semantic to `lexical`; pass `mode=semantic` for the previous behaviour (or `mode=hybrid` for natural-language questions).  ### Errors  - `400` for a `mode=lexical` query of stopwords only (no searchable words), for `case_sensitive` with any mode but `literal`, and for a `mode=literal` pattern under 3 characters without a scope (see Search modes).  - `429 upstream_rate_limited` and `503 search_unavailable` carry `Retry-After` (`503` also when a keyword search runs over its time limit — never an empty answer).  - `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.
+        Search the page text of investor documents by keywords (default `mode=lexical`) or exact text (`literal`): 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`), how it matched (`match`); the response says how much of the searched documents is indexed (`coverage`).  ### Search modes  - `lexical` (default): keyword search — English full text with stemming; quoted phrases, `OR` and `-word` work; every word must match; ranked by `ts_rank_cd` (`websearch_to_tsquery`). Finance tokens such as `FY2027`, `10-K`, `Q3` or `EBITDA` match as written.  - `literal`: the exact characters of the passage — no stemming, no fuzzy matching, `%` / `_` / `\\` match themselves; case-sensitive unless `case_sensitive=false` (only allowed with `mode=literal`; default `true`). A pattern under 3 characters needs `identifier`. Newest first; `score` is 0.  - `match.spans` mark the matched characters in `text` (zero-based, end-exclusive Unicode code-point offsets); `text` is cut around the first match (`text_truncated`); `match.lexical_rank` is the hit's 1-based rank. Neither mode expands into fuzzy results. Both modes cost the same.  ### Coverage  - `coverage.completeness` = `complete` (every searched passage is indexed: no hits is a genuine no-result), `partial` (some passages are still being indexed or failed) or `unknown` (nothing of the searched scope is indexed yet, or the counts could not be read) — read it before treating an empty list as \"not found\".  - `coverage.lexical` counts the searched transcripts or documents in the text index (`indexed`, `pending`, `failed`). `reasons` lists why the answer may be incomplete. The counts come from the indexing ledger: a transcript or document whose current version the index has not confirmed counts as `pending`; when they cannot be read, the hits are still returned with `completeness: unknown`, `lexical` null and `coverage_unavailable`.  ### Changelog  - 2026-10: modes added and the default mode changed from semantic to `lexical`.  - 2026-11: modes `semantic` and `hybrid` removed; vector search is gone, pass `mode=lexical` (default) or `literal`.  ### Errors  - `400` for a `mode=lexical` query of stopwords only (no searchable words), for `case_sensitive` with any mode but `literal`, and for a `mode=literal` pattern under 3 characters without a scope (see Search modes).  - `503 search_unavailable` (a search over its time limit — never an empty answer) carries `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 keywords, exact text (mode=literal) or question (semantic / hybrid) to search for (required)
+        :param q: The keywords or phrases (mode=lexical) or exact text (mode=literal) to search for (required)
         :type q: str
-        :param mode: lexical (keywords, default), literal (exact characters), semantic (meaning) or hybrid (lexical + semantic, fused)
+        :param mode: lexical (keywords and phrases, default) or literal (exact characters)
         :type mode: str
         :param case_sensitive: mode=literal only: \"false\" matches regardless of case (default \"true\": case-sensitive)
         :type case_sensitive: str
@@ -2545,7 +2544,6 @@ class EarningsCallsApi:
             '400': "CompanyAvailableCompanies401Response",
             '401': "CompanyAvailableCompanies401Response",
             '404': "CompanyAvailableCompanies401Response",
-            '429': "CompanyAvailableCompanies401Response",
             '500': "CompanyAvailableCompanies401Response",
             '503': "CompanyAvailableCompanies401Response",
         }
@@ -2563,8 +2561,8 @@ class EarningsCallsApi:
     @validate_call
     def earnings_calls_document_search_without_preload_content(
         self,
-        q: Annotated[str, Field(min_length=2, strict=True, max_length=500, description="The keywords, exact text (mode=literal) or question (semantic / hybrid) to search for")],
-        mode: Annotated[Optional[StrictStr], Field(description="lexical (keywords, default), literal (exact characters), semantic (meaning) or hybrid (lexical + semantic, fused)")] = None,
+        q: Annotated[str, Field(min_length=2, strict=True, max_length=500, description="The keywords or phrases (mode=lexical) or exact text (mode=literal) to search for")],
+        mode: Annotated[Optional[StrictStr], Field(description="lexical (keywords and phrases, default) or literal (exact characters)")] = None,
         case_sensitive: Annotated[Optional[StrictStr], Field(description="mode=literal only: \"false\" matches regardless of case (default \"true\": case-sensitive)")] = None,
         identifier: Annotated[Optional[StrictStr], Field(description="Search one company's documents (ticker or CIK, US only)")] = 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,
@@ -2587,11 +2585,11 @@ class EarningsCallsApi:
     ) -> RESTResponseType:
         """Search investor documents
 
-        Search the page text of investor documents by keywords (default `mode=lexical`), exact text (`literal`), meaning (`semantic`) or both (`hybrid`): 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`), how it matched (`match`); the response says how much of the searched documents is indexed (`coverage`).  ### Search modes  - `lexical` (default): keyword search — English full text with stemming; quoted phrases, `OR` and `-word` work (`websearch_to_tsquery`); ranked by `ts_rank_cd`. Finance tokens such as `FY2027`, `10-K`, `Q3` or `EBITDA` match as written.  - `literal`: the exact characters of the passage — no stemming, no fuzzy matching, `%` / `_` / `\\` match themselves; case-sensitive unless `case_sensitive=false` (only allowed with `mode=literal`; default `true`). A pattern under 3 characters needs `identifier`. Newest first; `score` is 0.  - `semantic`: meaning-based search (multilingual sentence embeddings); `score` is the cosine similarity.  - `hybrid`: `lexical` and `semantic` fused by reciprocal rank (`score = Σ 1 / (60 + rank)`, equal weights, ties by passage); `match.lexical_rank` / `match.semantic_rank` give each leg's rank. Best for natural-language questions.  - `match.spans` mark the matched characters in `text` (zero-based, end-exclusive Unicode code-point offsets); `text` is cut around the first match (`text_truncated`). Semantic matches carry no spans. An exact mode never expands into semantic or fuzzy results. Every mode costs the same.  ### Coverage  - `coverage.completeness` = `complete` (every searched passage is indexed: no hits is a genuine no-result), `partial` (some passages are still being indexed or failed, or a hybrid leg was unavailable) or `unknown` (a mode's index is not built for the searched scope, e.g. `semantic_index_missing`) — read it before treating an empty list as \"not found\".  - `coverage.lexical` / `coverage.semantic` count the searched transcripts or documents per index (`indexed`, `pending`, `failed`); null for a leg the mode did not use. `reasons` lists why the answer may be incomplete. The counts come from the indexing ledger: a transcript or document whose current version the index has not confirmed counts as `pending`; when they cannot be read, the hits are still returned with `completeness: unknown`, both legs null and `coverage_unavailable`.  ### Changelog  - 2026-10: modes added and the default mode changed from semantic to `lexical`; pass `mode=semantic` for the previous behaviour (or `mode=hybrid` for natural-language questions).  ### Errors  - `400` for a `mode=lexical` query of stopwords only (no searchable words), for `case_sensitive` with any mode but `literal`, and for a `mode=literal` pattern under 3 characters without a scope (see Search modes).  - `429 upstream_rate_limited` and `503 search_unavailable` carry `Retry-After` (`503` also when a keyword search runs over its time limit — never an empty answer).  - `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.
+        Search the page text of investor documents by keywords (default `mode=lexical`) or exact text (`literal`): 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`), how it matched (`match`); the response says how much of the searched documents is indexed (`coverage`).  ### Search modes  - `lexical` (default): keyword search — English full text with stemming; quoted phrases, `OR` and `-word` work; every word must match; ranked by `ts_rank_cd` (`websearch_to_tsquery`). Finance tokens such as `FY2027`, `10-K`, `Q3` or `EBITDA` match as written.  - `literal`: the exact characters of the passage — no stemming, no fuzzy matching, `%` / `_` / `\\` match themselves; case-sensitive unless `case_sensitive=false` (only allowed with `mode=literal`; default `true`). A pattern under 3 characters needs `identifier`. Newest first; `score` is 0.  - `match.spans` mark the matched characters in `text` (zero-based, end-exclusive Unicode code-point offsets); `text` is cut around the first match (`text_truncated`); `match.lexical_rank` is the hit's 1-based rank. Neither mode expands into fuzzy results. Both modes cost the same.  ### Coverage  - `coverage.completeness` = `complete` (every searched passage is indexed: no hits is a genuine no-result), `partial` (some passages are still being indexed or failed) or `unknown` (nothing of the searched scope is indexed yet, or the counts could not be read) — read it before treating an empty list as \"not found\".  - `coverage.lexical` counts the searched transcripts or documents in the text index (`indexed`, `pending`, `failed`). `reasons` lists why the answer may be incomplete. The counts come from the indexing ledger: a transcript or document whose current version the index has not confirmed counts as `pending`; when they cannot be read, the hits are still returned with `completeness: unknown`, `lexical` null and `coverage_unavailable`.  ### Changelog  - 2026-10: modes added and the default mode changed from semantic to `lexical`.  - 2026-11: modes `semantic` and `hybrid` removed; vector search is gone, pass `mode=lexical` (default) or `literal`.  ### Errors  - `400` for a `mode=lexical` query of stopwords only (no searchable words), for `case_sensitive` with any mode but `literal`, and for a `mode=literal` pattern under 3 characters without a scope (see Search modes).  - `503 search_unavailable` (a search over its time limit — never an empty answer) carries `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 keywords, exact text (mode=literal) or question (semantic / hybrid) to search for (required)
+        :param q: The keywords or phrases (mode=lexical) or exact text (mode=literal) to search for (required)
         :type q: str
-        :param mode: lexical (keywords, default), literal (exact characters), semantic (meaning) or hybrid (lexical + semantic, fused)
+        :param mode: lexical (keywords and phrases, default) or literal (exact characters)
         :type mode: str
         :param case_sensitive: mode=literal only: \"false\" matches regardless of case (default \"true\": case-sensitive)
         :type case_sensitive: str
@@ -2650,7 +2648,6 @@ class EarningsCallsApi:
             '400': "CompanyAvailableCompanies401Response",
             '401': "CompanyAvailableCompanies401Response",
             '404': "CompanyAvailableCompanies401Response",
-            '429': "CompanyAvailableCompanies401Response",
             '500': "CompanyAvailableCompanies401Response",
             '503': "CompanyAvailableCompanies401Response",
         }
@@ -7991,8 +7988,8 @@ class EarningsCallsApi:
     @validate_call
     def earnings_calls_search(
         self,
-        q: Annotated[str, Field(min_length=2, strict=True, max_length=500, description="The keywords, exact text (mode=literal) or question (semantic / hybrid) to search for")],
-        mode: Annotated[Optional[StrictStr], Field(description="lexical (keywords, default), literal (exact characters), semantic (meaning) or hybrid (lexical + semantic, fused)")] = None,
+        q: Annotated[str, Field(min_length=2, strict=True, max_length=500, description="The keywords or phrases (mode=lexical) or exact text (mode=literal) to search for")],
+        mode: Annotated[Optional[StrictStr], Field(description="lexical (keywords and phrases, default) or literal (exact characters)")] = None,
         case_sensitive: Annotated[Optional[StrictStr], Field(description="mode=literal only: \"false\" matches regardless of case (default \"true\": case-sensitive)")] = None,
         event_id: Annotated[Optional[UUID], Field(description="Search one call")] = None,
         identifier: Annotated[Optional[StrictStr], Field(description="Search one company's calls (ticker or CIK, US only)")] = None,
@@ -8016,11 +8013,11 @@ class EarningsCallsApi:
     ) -> EarningsCallsSearch200Response:
         """Search earnings calls
 
-        \"Ask this call\": search earnings-call transcripts and slide text by keywords (default `mode=lexical`), exact text (`literal`), meaning (`semantic`) or both (`hybrid`) — one call (`event_id`), one company (`identifier`) or every call (default: the last 365 days).  ### What you get  - Up to 8 passages with speaker and `start_ms`, how each matched (`match`) and the index coverage of the search (`coverage`). Cite `event_id` and `start_ms`.  - On plans that include the audio and slides routes (PRO): `audio_url` opens the recording's permanent URL at the passage (`#t=<seconds>`; null while no recording is available) and `slide.image_url` (a signed URL) shows the slide.  ### Event types  - `event_type` (default `earnings_call`; `all` = every type) selects investor days, conferences or shareholder meetings too.  ### Search modes  - `lexical` (default): keyword search — English full text with stemming; quoted phrases, `OR` and `-word` work (`websearch_to_tsquery`); ranked by `ts_rank_cd`. Finance tokens such as `FY2027`, `10-K`, `Q3` or `EBITDA` match as written.  - `literal`: the exact characters of the passage — no stemming, no fuzzy matching, `%` / `_` / `\\` match themselves; case-sensitive unless `case_sensitive=false` (only allowed with `mode=literal`; default `true`). A pattern under 3 characters needs `identifier` or `event_id`. Newest first; `score` is 0.  - `semantic`: meaning-based search (multilingual sentence embeddings); `score` is the cosine similarity.  - `hybrid`: `lexical` and `semantic` fused by reciprocal rank (`score = Σ 1 / (60 + rank)`, equal weights, ties by passage); `match.lexical_rank` / `match.semantic_rank` give each leg's rank. Best for natural-language questions.  - `match.spans` mark the matched characters in `text` (zero-based, end-exclusive Unicode code-point offsets); `text` is cut around the first match (`text_truncated`). Semantic matches carry no spans. An exact mode never expands into semantic or fuzzy results. Every mode costs the same.  ### Coverage  - `coverage.completeness` = `complete` (every searched passage is indexed: no hits is a genuine no-result), `partial` (some passages are still being indexed or failed, or a hybrid leg was unavailable) or `unknown` (a mode's index is not built for the searched scope, e.g. `semantic_index_missing`) — read it before treating an empty list as \"not found\".  - `coverage.lexical` / `coverage.semantic` count the searched transcripts or documents per index (`indexed`, `pending`, `failed`); null for a leg the mode did not use. `reasons` lists why the answer may be incomplete. The counts come from the indexing ledger: a transcript or document whose current version the index has not confirmed counts as `pending`; when they cannot be read, the hits are still returned with `completeness: unknown`, both legs null and `coverage_unavailable`.  ### Changelog  - 2026-10: modes added and the default mode changed from semantic to `lexical`; pass `mode=semantic` for the previous behaviour (or `mode=hybrid` for natural-language questions).  ### Errors  - `400` for a `mode=lexical` query of stopwords only (no searchable words), for `case_sensitive` with any mode but `literal`, and for a `mode=literal` pattern under 3 characters without a scope (see Search modes).  - `429 upstream_rate_limited` and `503 search_unavailable` carry `Retry-After` (`503` also when a keyword search runs over its time limit — never an empty answer).  - `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 rag: STANDARD.
+        \"Ask this call\": search earnings-call transcripts and slide text by keywords (default `mode=lexical`) or exact text (`literal`) — one call (`event_id`), one company (`identifier`) or every call (default: the last 365 days).  ### What you get  - Up to 8 passages with speaker and `start_ms`, how each matched (`match`) and the index coverage of the search (`coverage`). Cite `event_id` and `start_ms`.  - On plans that include the audio and slides routes (PRO): `audio_url` opens the recording's permanent URL at the passage (`#t=<seconds>`; null while no recording is available) and `slide.image_url` (a signed URL) shows the slide.  ### Event types  - `event_type` (default `earnings_call`; `all` = every type) selects investor days, conferences or shareholder meetings too.  ### Search modes  - `lexical` (default): keyword search — English full text with stemming; quoted phrases, `OR` and `-word` work; scoped by `identifier` or `event_id`, a passage needs any of the words, ranked by BM25 (rarer words weigh more), and the answer to a matching analyst question follows right after it (its `match.spans` may be empty); without a scope every word must match, ranked by `ts_rank_cd`. Finance tokens such as `FY2027`, `10-K`, `Q3` or `EBITDA` match as written.  - `literal`: the exact characters of the passage — no stemming, no fuzzy matching, `%` / `_` / `\\` match themselves; case-sensitive unless `case_sensitive=false` (only allowed with `mode=literal`; default `true`). A pattern under 3 characters needs `identifier` or `event_id`. Newest first; `score` is 0.  - `match.spans` mark the matched characters in `text` (zero-based, end-exclusive Unicode code-point offsets); `text` is cut around the first match (`text_truncated`); `match.lexical_rank` is the hit's 1-based rank. Neither mode expands into fuzzy results. Both modes cost the same.  ### Coverage  - `coverage.completeness` = `complete` (every searched passage is indexed: no hits is a genuine no-result), `partial` (some passages are still being indexed or failed) or `unknown` (nothing of the searched scope is indexed yet, or the counts could not be read) — read it before treating an empty list as \"not found\".  - `coverage.lexical` counts the searched transcripts or documents in the text index (`indexed`, `pending`, `failed`). `reasons` lists why the answer may be incomplete. The counts come from the indexing ledger: a transcript or document whose current version the index has not confirmed counts as `pending`; when they cannot be read, the hits are still returned with `completeness: unknown`, `lexical` null and `coverage_unavailable`.  ### Changelog  - 2026-10: modes added and the default mode changed from semantic to `lexical`.  - 2026-11: modes `semantic` and `hybrid` removed; vector search is gone, pass `mode=lexical` (default) or `literal`.  ### Errors  - `400` for a `mode=lexical` query of stopwords only (no searchable words), for `case_sensitive` with any mode but `literal`, and for a `mode=literal` pattern under 3 characters without a scope (see Search modes).  - `503 search_unavailable` (a search over its time limit — never an empty answer) carries `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 rag: STANDARD.
 
-        :param q: The keywords, exact text (mode=literal) or question (semantic / hybrid) to search for (required)
+        :param q: The keywords or phrases (mode=lexical) or exact text (mode=literal) to search for (required)
         :type q: str
-        :param mode: lexical (keywords, default), literal (exact characters), semantic (meaning) or hybrid (lexical + semantic, fused)
+        :param mode: lexical (keywords and phrases, default) or literal (exact characters)
         :type mode: str
         :param case_sensitive: mode=literal only: \"false\" matches regardless of case (default \"true\": case-sensitive)
         :type case_sensitive: str
@@ -8082,7 +8079,6 @@ class EarningsCallsApi:
             '400': "CompanyAvailableCompanies401Response",
             '401': "CompanyAvailableCompanies401Response",
             '404': "CompanyAvailableCompanies401Response",
-            '429': "CompanyAvailableCompanies401Response",
             '500': "CompanyAvailableCompanies401Response",
             '503': "CompanyAvailableCompanies401Response",
         }
@@ -8100,8 +8096,8 @@ class EarningsCallsApi:
     @validate_call
     def earnings_calls_search_with_http_info(
         self,
-        q: Annotated[str, Field(min_length=2, strict=True, max_length=500, description="The keywords, exact text (mode=literal) or question (semantic / hybrid) to search for")],
-        mode: Annotated[Optional[StrictStr], Field(description="lexical (keywords, default), literal (exact characters), semantic (meaning) or hybrid (lexical + semantic, fused)")] = None,
+        q: Annotated[str, Field(min_length=2, strict=True, max_length=500, description="The keywords or phrases (mode=lexical) or exact text (mode=literal) to search for")],
+        mode: Annotated[Optional[StrictStr], Field(description="lexical (keywords and phrases, default) or literal (exact characters)")] = None,
         case_sensitive: Annotated[Optional[StrictStr], Field(description="mode=literal only: \"false\" matches regardless of case (default \"true\": case-sensitive)")] = None,
         event_id: Annotated[Optional[UUID], Field(description="Search one call")] = None,
         identifier: Annotated[Optional[StrictStr], Field(description="Search one company's calls (ticker or CIK, US only)")] = None,
@@ -8125,11 +8121,11 @@ class EarningsCallsApi:
     ) -> ApiResponse[EarningsCallsSearch200Response]:
         """Search earnings calls
 
-        \"Ask this call\": search earnings-call transcripts and slide text by keywords (default `mode=lexical`), exact text (`literal`), meaning (`semantic`) or both (`hybrid`) — one call (`event_id`), one company (`identifier`) or every call (default: the last 365 days).  ### What you get  - Up to 8 passages with speaker and `start_ms`, how each matched (`match`) and the index coverage of the search (`coverage`). Cite `event_id` and `start_ms`.  - On plans that include the audio and slides routes (PRO): `audio_url` opens the recording's permanent URL at the passage (`#t=<seconds>`; null while no recording is available) and `slide.image_url` (a signed URL) shows the slide.  ### Event types  - `event_type` (default `earnings_call`; `all` = every type) selects investor days, conferences or shareholder meetings too.  ### Search modes  - `lexical` (default): keyword search — English full text with stemming; quoted phrases, `OR` and `-word` work (`websearch_to_tsquery`); ranked by `ts_rank_cd`. Finance tokens such as `FY2027`, `10-K`, `Q3` or `EBITDA` match as written.  - `literal`: the exact characters of the passage — no stemming, no fuzzy matching, `%` / `_` / `\\` match themselves; case-sensitive unless `case_sensitive=false` (only allowed with `mode=literal`; default `true`). A pattern under 3 characters needs `identifier` or `event_id`. Newest first; `score` is 0.  - `semantic`: meaning-based search (multilingual sentence embeddings); `score` is the cosine similarity.  - `hybrid`: `lexical` and `semantic` fused by reciprocal rank (`score = Σ 1 / (60 + rank)`, equal weights, ties by passage); `match.lexical_rank` / `match.semantic_rank` give each leg's rank. Best for natural-language questions.  - `match.spans` mark the matched characters in `text` (zero-based, end-exclusive Unicode code-point offsets); `text` is cut around the first match (`text_truncated`). Semantic matches carry no spans. An exact mode never expands into semantic or fuzzy results. Every mode costs the same.  ### Coverage  - `coverage.completeness` = `complete` (every searched passage is indexed: no hits is a genuine no-result), `partial` (some passages are still being indexed or failed, or a hybrid leg was unavailable) or `unknown` (a mode's index is not built for the searched scope, e.g. `semantic_index_missing`) — read it before treating an empty list as \"not found\".  - `coverage.lexical` / `coverage.semantic` count the searched transcripts or documents per index (`indexed`, `pending`, `failed`); null for a leg the mode did not use. `reasons` lists why the answer may be incomplete. The counts come from the indexing ledger: a transcript or document whose current version the index has not confirmed counts as `pending`; when they cannot be read, the hits are still returned with `completeness: unknown`, both legs null and `coverage_unavailable`.  ### Changelog  - 2026-10: modes added and the default mode changed from semantic to `lexical`; pass `mode=semantic` for the previous behaviour (or `mode=hybrid` for natural-language questions).  ### Errors  - `400` for a `mode=lexical` query of stopwords only (no searchable words), for `case_sensitive` with any mode but `literal`, and for a `mode=literal` pattern under 3 characters without a scope (see Search modes).  - `429 upstream_rate_limited` and `503 search_unavailable` carry `Retry-After` (`503` also when a keyword search runs over its time limit — never an empty answer).  - `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 rag: STANDARD.
+        \"Ask this call\": search earnings-call transcripts and slide text by keywords (default `mode=lexical`) or exact text (`literal`) — one call (`event_id`), one company (`identifier`) or every call (default: the last 365 days).  ### What you get  - Up to 8 passages with speaker and `start_ms`, how each matched (`match`) and the index coverage of the search (`coverage`). Cite `event_id` and `start_ms`.  - On plans that include the audio and slides routes (PRO): `audio_url` opens the recording's permanent URL at the passage (`#t=<seconds>`; null while no recording is available) and `slide.image_url` (a signed URL) shows the slide.  ### Event types  - `event_type` (default `earnings_call`; `all` = every type) selects investor days, conferences or shareholder meetings too.  ### Search modes  - `lexical` (default): keyword search — English full text with stemming; quoted phrases, `OR` and `-word` work; scoped by `identifier` or `event_id`, a passage needs any of the words, ranked by BM25 (rarer words weigh more), and the answer to a matching analyst question follows right after it (its `match.spans` may be empty); without a scope every word must match, ranked by `ts_rank_cd`. Finance tokens such as `FY2027`, `10-K`, `Q3` or `EBITDA` match as written.  - `literal`: the exact characters of the passage — no stemming, no fuzzy matching, `%` / `_` / `\\` match themselves; case-sensitive unless `case_sensitive=false` (only allowed with `mode=literal`; default `true`). A pattern under 3 characters needs `identifier` or `event_id`. Newest first; `score` is 0.  - `match.spans` mark the matched characters in `text` (zero-based, end-exclusive Unicode code-point offsets); `text` is cut around the first match (`text_truncated`); `match.lexical_rank` is the hit's 1-based rank. Neither mode expands into fuzzy results. Both modes cost the same.  ### Coverage  - `coverage.completeness` = `complete` (every searched passage is indexed: no hits is a genuine no-result), `partial` (some passages are still being indexed or failed) or `unknown` (nothing of the searched scope is indexed yet, or the counts could not be read) — read it before treating an empty list as \"not found\".  - `coverage.lexical` counts the searched transcripts or documents in the text index (`indexed`, `pending`, `failed`). `reasons` lists why the answer may be incomplete. The counts come from the indexing ledger: a transcript or document whose current version the index has not confirmed counts as `pending`; when they cannot be read, the hits are still returned with `completeness: unknown`, `lexical` null and `coverage_unavailable`.  ### Changelog  - 2026-10: modes added and the default mode changed from semantic to `lexical`.  - 2026-11: modes `semantic` and `hybrid` removed; vector search is gone, pass `mode=lexical` (default) or `literal`.  ### Errors  - `400` for a `mode=lexical` query of stopwords only (no searchable words), for `case_sensitive` with any mode but `literal`, and for a `mode=literal` pattern under 3 characters without a scope (see Search modes).  - `503 search_unavailable` (a search over its time limit — never an empty answer) carries `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 rag: STANDARD.
 
-        :param q: The keywords, exact text (mode=literal) or question (semantic / hybrid) to search for (required)
+        :param q: The keywords or phrases (mode=lexical) or exact text (mode=literal) to search for (required)
         :type q: str
-        :param mode: lexical (keywords, default), literal (exact characters), semantic (meaning) or hybrid (lexical + semantic, fused)
+        :param mode: lexical (keywords and phrases, default) or literal (exact characters)
         :type mode: str
         :param case_sensitive: mode=literal only: \"false\" matches regardless of case (default \"true\": case-sensitive)
         :type case_sensitive: str
@@ -8191,7 +8187,6 @@ class EarningsCallsApi:
             '400': "CompanyAvailableCompanies401Response",
             '401': "CompanyAvailableCompanies401Response",
             '404': "CompanyAvailableCompanies401Response",
-            '429': "CompanyAvailableCompanies401Response",
             '500': "CompanyAvailableCompanies401Response",
             '503': "CompanyAvailableCompanies401Response",
         }
@@ -8209,8 +8204,8 @@ class EarningsCallsApi:
     @validate_call
     def earnings_calls_search_without_preload_content(
         self,
-        q: Annotated[str, Field(min_length=2, strict=True, max_length=500, description="The keywords, exact text (mode=literal) or question (semantic / hybrid) to search for")],
-        mode: Annotated[Optional[StrictStr], Field(description="lexical (keywords, default), literal (exact characters), semantic (meaning) or hybrid (lexical + semantic, fused)")] = None,
+        q: Annotated[str, Field(min_length=2, strict=True, max_length=500, description="The keywords or phrases (mode=lexical) or exact text (mode=literal) to search for")],
+        mode: Annotated[Optional[StrictStr], Field(description="lexical (keywords and phrases, default) or literal (exact characters)")] = None,
         case_sensitive: Annotated[Optional[StrictStr], Field(description="mode=literal only: \"false\" matches regardless of case (default \"true\": case-sensitive)")] = None,
         event_id: Annotated[Optional[UUID], Field(description="Search one call")] = None,
         identifier: Annotated[Optional[StrictStr], Field(description="Search one company's calls (ticker or CIK, US only)")] = None,
@@ -8234,11 +8229,11 @@ class EarningsCallsApi:
     ) -> RESTResponseType:
         """Search earnings calls
 
-        \"Ask this call\": search earnings-call transcripts and slide text by keywords (default `mode=lexical`), exact text (`literal`), meaning (`semantic`) or both (`hybrid`) — one call (`event_id`), one company (`identifier`) or every call (default: the last 365 days).  ### What you get  - Up to 8 passages with speaker and `start_ms`, how each matched (`match`) and the index coverage of the search (`coverage`). Cite `event_id` and `start_ms`.  - On plans that include the audio and slides routes (PRO): `audio_url` opens the recording's permanent URL at the passage (`#t=<seconds>`; null while no recording is available) and `slide.image_url` (a signed URL) shows the slide.  ### Event types  - `event_type` (default `earnings_call`; `all` = every type) selects investor days, conferences or shareholder meetings too.  ### Search modes  - `lexical` (default): keyword search — English full text with stemming; quoted phrases, `OR` and `-word` work (`websearch_to_tsquery`); ranked by `ts_rank_cd`. Finance tokens such as `FY2027`, `10-K`, `Q3` or `EBITDA` match as written.  - `literal`: the exact characters of the passage — no stemming, no fuzzy matching, `%` / `_` / `\\` match themselves; case-sensitive unless `case_sensitive=false` (only allowed with `mode=literal`; default `true`). A pattern under 3 characters needs `identifier` or `event_id`. Newest first; `score` is 0.  - `semantic`: meaning-based search (multilingual sentence embeddings); `score` is the cosine similarity.  - `hybrid`: `lexical` and `semantic` fused by reciprocal rank (`score = Σ 1 / (60 + rank)`, equal weights, ties by passage); `match.lexical_rank` / `match.semantic_rank` give each leg's rank. Best for natural-language questions.  - `match.spans` mark the matched characters in `text` (zero-based, end-exclusive Unicode code-point offsets); `text` is cut around the first match (`text_truncated`). Semantic matches carry no spans. An exact mode never expands into semantic or fuzzy results. Every mode costs the same.  ### Coverage  - `coverage.completeness` = `complete` (every searched passage is indexed: no hits is a genuine no-result), `partial` (some passages are still being indexed or failed, or a hybrid leg was unavailable) or `unknown` (a mode's index is not built for the searched scope, e.g. `semantic_index_missing`) — read it before treating an empty list as \"not found\".  - `coverage.lexical` / `coverage.semantic` count the searched transcripts or documents per index (`indexed`, `pending`, `failed`); null for a leg the mode did not use. `reasons` lists why the answer may be incomplete. The counts come from the indexing ledger: a transcript or document whose current version the index has not confirmed counts as `pending`; when they cannot be read, the hits are still returned with `completeness: unknown`, both legs null and `coverage_unavailable`.  ### Changelog  - 2026-10: modes added and the default mode changed from semantic to `lexical`; pass `mode=semantic` for the previous behaviour (or `mode=hybrid` for natural-language questions).  ### Errors  - `400` for a `mode=lexical` query of stopwords only (no searchable words), for `case_sensitive` with any mode but `literal`, and for a `mode=literal` pattern under 3 characters without a scope (see Search modes).  - `429 upstream_rate_limited` and `503 search_unavailable` carry `Retry-After` (`503` also when a keyword search runs over its time limit — never an empty answer).  - `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 rag: STANDARD.
+        \"Ask this call\": search earnings-call transcripts and slide text by keywords (default `mode=lexical`) or exact text (`literal`) — one call (`event_id`), one company (`identifier`) or every call (default: the last 365 days).  ### What you get  - Up to 8 passages with speaker and `start_ms`, how each matched (`match`) and the index coverage of the search (`coverage`). Cite `event_id` and `start_ms`.  - On plans that include the audio and slides routes (PRO): `audio_url` opens the recording's permanent URL at the passage (`#t=<seconds>`; null while no recording is available) and `slide.image_url` (a signed URL) shows the slide.  ### Event types  - `event_type` (default `earnings_call`; `all` = every type) selects investor days, conferences or shareholder meetings too.  ### Search modes  - `lexical` (default): keyword search — English full text with stemming; quoted phrases, `OR` and `-word` work; scoped by `identifier` or `event_id`, a passage needs any of the words, ranked by BM25 (rarer words weigh more), and the answer to a matching analyst question follows right after it (its `match.spans` may be empty); without a scope every word must match, ranked by `ts_rank_cd`. Finance tokens such as `FY2027`, `10-K`, `Q3` or `EBITDA` match as written.  - `literal`: the exact characters of the passage — no stemming, no fuzzy matching, `%` / `_` / `\\` match themselves; case-sensitive unless `case_sensitive=false` (only allowed with `mode=literal`; default `true`). A pattern under 3 characters needs `identifier` or `event_id`. Newest first; `score` is 0.  - `match.spans` mark the matched characters in `text` (zero-based, end-exclusive Unicode code-point offsets); `text` is cut around the first match (`text_truncated`); `match.lexical_rank` is the hit's 1-based rank. Neither mode expands into fuzzy results. Both modes cost the same.  ### Coverage  - `coverage.completeness` = `complete` (every searched passage is indexed: no hits is a genuine no-result), `partial` (some passages are still being indexed or failed) or `unknown` (nothing of the searched scope is indexed yet, or the counts could not be read) — read it before treating an empty list as \"not found\".  - `coverage.lexical` counts the searched transcripts or documents in the text index (`indexed`, `pending`, `failed`). `reasons` lists why the answer may be incomplete. The counts come from the indexing ledger: a transcript or document whose current version the index has not confirmed counts as `pending`; when they cannot be read, the hits are still returned with `completeness: unknown`, `lexical` null and `coverage_unavailable`.  ### Changelog  - 2026-10: modes added and the default mode changed from semantic to `lexical`.  - 2026-11: modes `semantic` and `hybrid` removed; vector search is gone, pass `mode=lexical` (default) or `literal`.  ### Errors  - `400` for a `mode=lexical` query of stopwords only (no searchable words), for `case_sensitive` with any mode but `literal`, and for a `mode=literal` pattern under 3 characters without a scope (see Search modes).  - `503 search_unavailable` (a search over its time limit — never an empty answer) carries `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 rag: STANDARD.
 
-        :param q: The keywords, exact text (mode=literal) or question (semantic / hybrid) to search for (required)
+        :param q: The keywords or phrases (mode=lexical) or exact text (mode=literal) to search for (required)
         :type q: str
-        :param mode: lexical (keywords, default), literal (exact characters), semantic (meaning) or hybrid (lexical + semantic, fused)
+        :param mode: lexical (keywords and phrases, default) or literal (exact characters)
         :type mode: str
         :param case_sensitive: mode=literal only: \"false\" matches regardless of case (default \"true\": case-sensitive)
         :type case_sensitive: str
@@ -8300,7 +8295,6 @@ class EarningsCallsApi:
             '400': "CompanyAvailableCompanies401Response",
             '401': "CompanyAvailableCompanies401Response",
             '404': "CompanyAvailableCompanies401Response",
-            '429': "CompanyAvailableCompanies401Response",
             '500': "CompanyAvailableCompanies401Response",
             '503': "CompanyAvailableCompanies401Response",
         }