invinite-data-api 5.6.0__tar.gz → 5.7.0__tar.gz

{invinite_data_api-5.6.0 → invinite_data_api-5.7.0}/PKG-INFO

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

{invinite_data_api-5.6.0 → invinite_data_api-5.7.0}/invinite_data_api/__init__.py

@@ -14,7 +14,7 @@
 """  # noqa: E501
 
 
-__version__ = "5.6.0"
+__version__ = "5.7.0"
 
 # Define package exports
 __all__ = [
@@ -102,7 +102,13 @@ __all__ = [
     "FilerDetail",
     "FilerDetailFormerNamesInner",
     "FilerDetailSuccessorsInner",
+    "FilerFund",
+    "FilerFundAdviser",
+    "FilerFundReturn",
+    "FilerFundSeries",
+    "FilerFundShareClass",
     "FilerListing",
+    "FilerPrivateOfferings",
     "Filing",
     "FilingDetail",
     "FilingDocument",
@@ -116,6 +122,7 @@ __all__ = [
     "FiscalPeriod",
     "FormCatalogEntry",
     "FormulaMember",
+    "FundHolding",
     "GetAsReportedFinancials200Response",
     "GetAsReportedFinancialsDetailed200Response",
     "GetAsReportedFinancialsPresentation200Response",
@@ -132,6 +139,7 @@ __all__ = [
     "Holding",
     "HoldingChange",
     "InsiderTrade",
+    "InsiderTradeFootnote",
     "InvestorDocument",
     "InvestorDocumentSearchHit",
     "Ipo",
@@ -162,6 +170,7 @@ __all__ = [
     "ListFilings200ResponseMetaFormFacetInner",
     "ListFiscalPeriods200Response",
     "ListFormCatalog200Response",
+    "ListFundHoldings200Response",
     "ListGrowth200Response",
     "ListGuidance200Response",
     "ListHoldingChanges200Response",
@@ -175,6 +184,8 @@ __all__ = [
     "ListMarketHolidays200Response",
     "ListMetricCatalog200Response",
     "ListNews200Response",
+    "ListOfferings200Response",
+    "ListOfferings200ResponseMeta",
     "ListParticipants200Response",
     "ListPeople200Response",
     "ListQa200Response",
@@ -211,6 +222,8 @@ __all__ = [
     "NewsText",
     "NewsTextBlocksInner",
     "NewsTextCoverage",
+    "Offering",
+    "OfferingRelatedPerson",
     "Participation",
     "ParticipationEvidenceInner",
     "PdfDocument",
@@ -378,7 +391,13 @@ from invinite_data_api.models.filer import Filer as Filer
 from invinite_data_api.models.filer_detail import FilerDetail as FilerDetail
 from invinite_data_api.models.filer_detail_former_names_inner import FilerDetailFormerNamesInner as FilerDetailFormerNamesInner
 from invinite_data_api.models.filer_detail_successors_inner import FilerDetailSuccessorsInner as FilerDetailSuccessorsInner
+from invinite_data_api.models.filer_fund import FilerFund as FilerFund
+from invinite_data_api.models.filer_fund_adviser import FilerFundAdviser as FilerFundAdviser
+from invinite_data_api.models.filer_fund_return import FilerFundReturn as FilerFundReturn
+from invinite_data_api.models.filer_fund_series import FilerFundSeries as FilerFundSeries
+from invinite_data_api.models.filer_fund_share_class import FilerFundShareClass as FilerFundShareClass
 from invinite_data_api.models.filer_listing import FilerListing as FilerListing
+from invinite_data_api.models.filer_private_offerings import FilerPrivateOfferings as FilerPrivateOfferings
 from invinite_data_api.models.filing import Filing as Filing
 from invinite_data_api.models.filing_detail import FilingDetail as FilingDetail
 from invinite_data_api.models.filing_document import FilingDocument as FilingDocument
@@ -392,6 +411,7 @@ from invinite_data_api.models.filing_source import FilingSource as FilingSource
 from invinite_data_api.models.fiscal_period import FiscalPeriod as FiscalPeriod
 from invinite_data_api.models.form_catalog_entry import FormCatalogEntry as FormCatalogEntry
 from invinite_data_api.models.formula_member import FormulaMember as FormulaMember
+from invinite_data_api.models.fund_holding import FundHolding as FundHolding
 from invinite_data_api.models.get_as_reported_financials200_response import GetAsReportedFinancials200Response as GetAsReportedFinancials200Response
 from invinite_data_api.models.get_as_reported_financials_detailed200_response import GetAsReportedFinancialsDetailed200Response as GetAsReportedFinancialsDetailed200Response
 from invinite_data_api.models.get_as_reported_financials_presentation200_response import GetAsReportedFinancialsPresentation200Response as GetAsReportedFinancialsPresentation200Response
@@ -408,6 +428,7 @@ from invinite_data_api.models.hit_match import HitMatch as HitMatch
 from invinite_data_api.models.holding import Holding as Holding
 from invinite_data_api.models.holding_change import HoldingChange as HoldingChange
 from invinite_data_api.models.insider_trade import InsiderTrade as InsiderTrade
+from invinite_data_api.models.insider_trade_footnote import InsiderTradeFootnote as InsiderTradeFootnote
 from invinite_data_api.models.investor_document import InvestorDocument as InvestorDocument
 from invinite_data_api.models.investor_document_search_hit import InvestorDocumentSearchHit as InvestorDocumentSearchHit
 from invinite_data_api.models.ipo import Ipo as Ipo
@@ -438,6 +459,7 @@ from invinite_data_api.models.list_filings200_response_meta import ListFilings20
 from invinite_data_api.models.list_filings200_response_meta_form_facet_inner import ListFilings200ResponseMetaFormFacetInner as ListFilings200ResponseMetaFormFacetInner
 from invinite_data_api.models.list_fiscal_periods200_response import ListFiscalPeriods200Response as ListFiscalPeriods200Response
 from invinite_data_api.models.list_form_catalog200_response import ListFormCatalog200Response as ListFormCatalog200Response
+from invinite_data_api.models.list_fund_holdings200_response import ListFundHoldings200Response as ListFundHoldings200Response
 from invinite_data_api.models.list_growth200_response import ListGrowth200Response as ListGrowth200Response
 from invinite_data_api.models.list_guidance200_response import ListGuidance200Response as ListGuidance200Response
 from invinite_data_api.models.list_holding_changes200_response import ListHoldingChanges200Response as ListHoldingChanges200Response
@@ -451,6 +473,8 @@ from invinite_data_api.models.list_mapping_rules200_response import ListMappingR
 from invinite_data_api.models.list_market_holidays200_response import ListMarketHolidays200Response as ListMarketHolidays200Response
 from invinite_data_api.models.list_metric_catalog200_response import ListMetricCatalog200Response as ListMetricCatalog200Response
 from invinite_data_api.models.list_news200_response import ListNews200Response as ListNews200Response
+from invinite_data_api.models.list_offerings200_response import ListOfferings200Response as ListOfferings200Response
+from invinite_data_api.models.list_offerings200_response_meta import ListOfferings200ResponseMeta as ListOfferings200ResponseMeta
 from invinite_data_api.models.list_participants200_response import ListParticipants200Response as ListParticipants200Response
 from invinite_data_api.models.list_people200_response import ListPeople200Response as ListPeople200Response
 from invinite_data_api.models.list_qa200_response import ListQa200Response as ListQa200Response
@@ -487,6 +511,8 @@ from invinite_data_api.models.news_search_hit_item import NewsSearchHitItem as N
 from invinite_data_api.models.news_text import NewsText as NewsText
 from invinite_data_api.models.news_text_blocks_inner import NewsTextBlocksInner as NewsTextBlocksInner
 from invinite_data_api.models.news_text_coverage import NewsTextCoverage as NewsTextCoverage
+from invinite_data_api.models.offering import Offering as Offering
+from invinite_data_api.models.offering_related_person import OfferingRelatedPerson as OfferingRelatedPerson
 from invinite_data_api.models.participation import Participation as Participation
 from invinite_data_api.models.participation_evidence_inner import ParticipationEvidenceInner as ParticipationEvidenceInner
 from invinite_data_api.models.pdf_document import PdfDocument as PdfDocument

{invinite_data_api-5.6.0 → invinite_data_api-5.7.0}/invinite_data_api/api/companies_api.py

@@ -371,7 +371,7 @@ class CompaniesApi:
     def get_filer(
         self,
         cik: Annotated[StrictStr, Field(description="SEC CIK (any padding)")],
-        expand: Annotated[Optional[Annotated[str, Field(strict=True)]], Field(description="Optional objects to include: `lifecycle`, `proposed_symbols`, `former_names`, `successors` (comma list)")] = None,
+        expand: Annotated[Optional[Annotated[str, Field(strict=True)]], Field(description="Optional objects to include: `lifecycle`, `proposed_symbols`, `former_names`, `successors`, `fund`, `private_offerings` (comma list)")] = None,
         fields: Annotated[Optional[StrictStr], Field(description="Comma list of root-level fields to keep (R7)")] = None,
         _request_timeout: Union[
             None,
@@ -392,7 +392,7 @@ class CompaniesApi:
 
         :param cik: SEC CIK (any padding) (required)
         :type cik: str
-        :param expand: Optional objects to include: `lifecycle`, `proposed_symbols`, `former_names`, `successors` (comma list)
+        :param expand: Optional objects to include: `lifecycle`, `proposed_symbols`, `former_names`, `successors`, `fund`, `private_offerings` (comma list)
         :type expand: str
         :param fields: Comma list of root-level fields to keep (R7)
         :type fields: str
@@ -455,7 +455,7 @@ class CompaniesApi:
     def get_filer_with_http_info(
         self,
         cik: Annotated[StrictStr, Field(description="SEC CIK (any padding)")],
-        expand: Annotated[Optional[Annotated[str, Field(strict=True)]], Field(description="Optional objects to include: `lifecycle`, `proposed_symbols`, `former_names`, `successors` (comma list)")] = None,
+        expand: Annotated[Optional[Annotated[str, Field(strict=True)]], Field(description="Optional objects to include: `lifecycle`, `proposed_symbols`, `former_names`, `successors`, `fund`, `private_offerings` (comma list)")] = None,
         fields: Annotated[Optional[StrictStr], Field(description="Comma list of root-level fields to keep (R7)")] = None,
         _request_timeout: Union[
             None,
@@ -476,7 +476,7 @@ class CompaniesApi:
 
         :param cik: SEC CIK (any padding) (required)
         :type cik: str
-        :param expand: Optional objects to include: `lifecycle`, `proposed_symbols`, `former_names`, `successors` (comma list)
+        :param expand: Optional objects to include: `lifecycle`, `proposed_symbols`, `former_names`, `successors`, `fund`, `private_offerings` (comma list)
         :type expand: str
         :param fields: Comma list of root-level fields to keep (R7)
         :type fields: str
@@ -539,7 +539,7 @@ class CompaniesApi:
     def get_filer_without_preload_content(
         self,
         cik: Annotated[StrictStr, Field(description="SEC CIK (any padding)")],
-        expand: Annotated[Optional[Annotated[str, Field(strict=True)]], Field(description="Optional objects to include: `lifecycle`, `proposed_symbols`, `former_names`, `successors` (comma list)")] = None,
+        expand: Annotated[Optional[Annotated[str, Field(strict=True)]], Field(description="Optional objects to include: `lifecycle`, `proposed_symbols`, `former_names`, `successors`, `fund`, `private_offerings` (comma list)")] = None,
         fields: Annotated[Optional[StrictStr], Field(description="Comma list of root-level fields to keep (R7)")] = None,
         _request_timeout: Union[
             None,
@@ -560,7 +560,7 @@ class CompaniesApi:
 
         :param cik: SEC CIK (any padding) (required)
         :type cik: str
-        :param expand: Optional objects to include: `lifecycle`, `proposed_symbols`, `former_names`, `successors` (comma list)
+        :param expand: Optional objects to include: `lifecycle`, `proposed_symbols`, `former_names`, `successors`, `fund`, `private_offerings` (comma list)
         :type expand: str
         :param fields: Comma list of root-level fields to keep (R7)
         :type fields: str

{invinite_data_api-5.6.0 → invinite_data_api-5.7.0}/invinite_data_api/api/holdings_api.py

@@ -19,6 +19,7 @@ from datetime import date
 from pydantic import Field, StrictStr, field_validator
 from typing import Optional
 from typing_extensions import Annotated
+from invinite_data_api.models.list_fund_holdings200_response import ListFundHoldings200Response
 from invinite_data_api.models.list_holding_changes200_response import ListHoldingChanges200Response
 from invinite_data_api.models.list_holdings200_response import ListHoldings200Response
 
@@ -40,6 +41,442 @@ class HoldingsApi:
         self.api_client = api_client
 
 
+    @validate_call
+    def list_fund_holdings(
+        self,
+        company: Annotated[Optional[Annotated[str, Field(min_length=1, strict=True)]], Field(description="Ticker (`AAPL`) or CIK (all digits, any padding); a comma list of 1–50 reads several companies in one request (R2). One of the scope filters of this list is required.")] = None,
+        filer: Annotated[Optional[StrictStr], Field(description="Fund registrant CIK (one): its fund portfolio")] = None,
+        series: Annotated[Optional[StrictStr], Field(description="SEC series id of one fund (S + 9 digits; a unit investment trust without a series: cik:<registrant CIK>); with filer=, required when the registrant files for more than one fund")] = None,
+        accession: Annotated[Optional[StrictStr], Field(description="NPORT-P filing: its reported holdings as filed")] = None,
+        period_end: Annotated[Optional[date], Field(description="Each fund's latest report on or before this date")] = None,
+        sort: Annotated[Optional[StrictStr], Field(description="Sort field: `-value_usd` (the only order the store serves); the id tiebreaker is always appended")] = None,
+        fields: Annotated[Optional[StrictStr], Field(description="Comma list of root-level fields to keep (R7)")] = None,
+        limit: Annotated[Optional[Annotated[int, Field(le=1000, strict=True, ge=1)]], Field(description="Rows per page (default 25, max 1 000 on 13F rows)")] = None,
+        cursor: Annotated[Optional[StrictStr], Field(description="Opaque `next_cursor` of the previous page; reuse it with the SAME filters (changed filters → 400 cursor_mismatch)")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ListFundHoldings200Response:
+        """List N-PORT fund holdings
+
+        N-PORT fund and ETF positions from the funds' quarterly public reports (about 60 days after the report date): by issuer (`company=`, one row per fund holding it, from each fund's latest report on or before `period_end`, its positions in the issuer summed), by fund (`filer=` registrant CIK, `series=` when the registrant files for several funds: that fund's positions) or by filing (`accession=`, an NPORT-P filing's reported holdings as filed); exactly one of `company`, `filer` or `accession` (`series` alone needs `filer`). `period_end` defaults to today. Order: value in USD, descending (`company=`, `filer=`), the filing's line order (`accession=`); several companies are read one after another. A fund row is not a 13F `Holding` (different row type, R16): `/v1/holdings` keeps the 13F managers.
+
+        :param company: Ticker (`AAPL`) or CIK (all digits, any padding); a comma list of 1–50 reads several companies in one request (R2). One of the scope filters of this list is required.
+        :type company: str
+        :param filer: Fund registrant CIK (one): its fund portfolio
+        :type filer: str
+        :param series: SEC series id of one fund (S + 9 digits; a unit investment trust without a series: cik:<registrant CIK>); with filer=, required when the registrant files for more than one fund
+        :type series: str
+        :param accession: NPORT-P filing: its reported holdings as filed
+        :type accession: str
+        :param period_end: Each fund's latest report on or before this date
+        :type period_end: date
+        :param sort: Sort field: `-value_usd` (the only order the store serves); the id tiebreaker is always appended
+        :type sort: str
+        :param fields: Comma list of root-level fields to keep (R7)
+        :type fields: str
+        :param limit: Rows per page (default 25, max 1 000 on 13F rows)
+        :type limit: int
+        :param cursor: Opaque `next_cursor` of the previous page; reuse it with the SAME filters (changed filters → 400 cursor_mismatch)
+        :type cursor: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._list_fund_holdings_serialize(
+            company=company,
+            filer=filer,
+            series=series,
+            accession=accession,
+            period_end=period_end,
+            sort=sort,
+            fields=fields,
+            limit=limit,
+            cursor=cursor,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "ListFundHoldings200Response",
+            '304': None,
+            '400': "Problem",
+            '401': "Problem",
+            '402': "Problem",
+            '403': "Problem",
+            '404': "Problem",
+            '429': "Problem",
+            '500': "Problem",
+            '503': "Problem",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call
+    def list_fund_holdings_with_http_info(
+        self,
+        company: Annotated[Optional[Annotated[str, Field(min_length=1, strict=True)]], Field(description="Ticker (`AAPL`) or CIK (all digits, any padding); a comma list of 1–50 reads several companies in one request (R2). One of the scope filters of this list is required.")] = None,
+        filer: Annotated[Optional[StrictStr], Field(description="Fund registrant CIK (one): its fund portfolio")] = None,
+        series: Annotated[Optional[StrictStr], Field(description="SEC series id of one fund (S + 9 digits; a unit investment trust without a series: cik:<registrant CIK>); with filer=, required when the registrant files for more than one fund")] = None,
+        accession: Annotated[Optional[StrictStr], Field(description="NPORT-P filing: its reported holdings as filed")] = None,
+        period_end: Annotated[Optional[date], Field(description="Each fund's latest report on or before this date")] = None,
+        sort: Annotated[Optional[StrictStr], Field(description="Sort field: `-value_usd` (the only order the store serves); the id tiebreaker is always appended")] = None,
+        fields: Annotated[Optional[StrictStr], Field(description="Comma list of root-level fields to keep (R7)")] = None,
+        limit: Annotated[Optional[Annotated[int, Field(le=1000, strict=True, ge=1)]], Field(description="Rows per page (default 25, max 1 000 on 13F rows)")] = None,
+        cursor: Annotated[Optional[StrictStr], Field(description="Opaque `next_cursor` of the previous page; reuse it with the SAME filters (changed filters → 400 cursor_mismatch)")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[ListFundHoldings200Response]:
+        """List N-PORT fund holdings
+
+        N-PORT fund and ETF positions from the funds' quarterly public reports (about 60 days after the report date): by issuer (`company=`, one row per fund holding it, from each fund's latest report on or before `period_end`, its positions in the issuer summed), by fund (`filer=` registrant CIK, `series=` when the registrant files for several funds: that fund's positions) or by filing (`accession=`, an NPORT-P filing's reported holdings as filed); exactly one of `company`, `filer` or `accession` (`series` alone needs `filer`). `period_end` defaults to today. Order: value in USD, descending (`company=`, `filer=`), the filing's line order (`accession=`); several companies are read one after another. A fund row is not a 13F `Holding` (different row type, R16): `/v1/holdings` keeps the 13F managers.
+
+        :param company: Ticker (`AAPL`) or CIK (all digits, any padding); a comma list of 1–50 reads several companies in one request (R2). One of the scope filters of this list is required.
+        :type company: str
+        :param filer: Fund registrant CIK (one): its fund portfolio
+        :type filer: str
+        :param series: SEC series id of one fund (S + 9 digits; a unit investment trust without a series: cik:<registrant CIK>); with filer=, required when the registrant files for more than one fund
+        :type series: str
+        :param accession: NPORT-P filing: its reported holdings as filed
+        :type accession: str
+        :param period_end: Each fund's latest report on or before this date
+        :type period_end: date
+        :param sort: Sort field: `-value_usd` (the only order the store serves); the id tiebreaker is always appended
+        :type sort: str
+        :param fields: Comma list of root-level fields to keep (R7)
+        :type fields: str
+        :param limit: Rows per page (default 25, max 1 000 on 13F rows)
+        :type limit: int
+        :param cursor: Opaque `next_cursor` of the previous page; reuse it with the SAME filters (changed filters → 400 cursor_mismatch)
+        :type cursor: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._list_fund_holdings_serialize(
+            company=company,
+            filer=filer,
+            series=series,
+            accession=accession,
+            period_end=period_end,
+            sort=sort,
+            fields=fields,
+            limit=limit,
+            cursor=cursor,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "ListFundHoldings200Response",
+            '304': None,
+            '400': "Problem",
+            '401': "Problem",
+            '402': "Problem",
+            '403': "Problem",
+            '404': "Problem",
+            '429': "Problem",
+            '500': "Problem",
+            '503': "Problem",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call
+    def list_fund_holdings_without_preload_content(
+        self,
+        company: Annotated[Optional[Annotated[str, Field(min_length=1, strict=True)]], Field(description="Ticker (`AAPL`) or CIK (all digits, any padding); a comma list of 1–50 reads several companies in one request (R2). One of the scope filters of this list is required.")] = None,
+        filer: Annotated[Optional[StrictStr], Field(description="Fund registrant CIK (one): its fund portfolio")] = None,
+        series: Annotated[Optional[StrictStr], Field(description="SEC series id of one fund (S + 9 digits; a unit investment trust without a series: cik:<registrant CIK>); with filer=, required when the registrant files for more than one fund")] = None,
+        accession: Annotated[Optional[StrictStr], Field(description="NPORT-P filing: its reported holdings as filed")] = None,
+        period_end: Annotated[Optional[date], Field(description="Each fund's latest report on or before this date")] = None,
+        sort: Annotated[Optional[StrictStr], Field(description="Sort field: `-value_usd` (the only order the store serves); the id tiebreaker is always appended")] = None,
+        fields: Annotated[Optional[StrictStr], Field(description="Comma list of root-level fields to keep (R7)")] = None,
+        limit: Annotated[Optional[Annotated[int, Field(le=1000, strict=True, ge=1)]], Field(description="Rows per page (default 25, max 1 000 on 13F rows)")] = None,
+        cursor: Annotated[Optional[StrictStr], Field(description="Opaque `next_cursor` of the previous page; reuse it with the SAME filters (changed filters → 400 cursor_mismatch)")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """List N-PORT fund holdings
+
+        N-PORT fund and ETF positions from the funds' quarterly public reports (about 60 days after the report date): by issuer (`company=`, one row per fund holding it, from each fund's latest report on or before `period_end`, its positions in the issuer summed), by fund (`filer=` registrant CIK, `series=` when the registrant files for several funds: that fund's positions) or by filing (`accession=`, an NPORT-P filing's reported holdings as filed); exactly one of `company`, `filer` or `accession` (`series` alone needs `filer`). `period_end` defaults to today. Order: value in USD, descending (`company=`, `filer=`), the filing's line order (`accession=`); several companies are read one after another. A fund row is not a 13F `Holding` (different row type, R16): `/v1/holdings` keeps the 13F managers.
+
+        :param company: Ticker (`AAPL`) or CIK (all digits, any padding); a comma list of 1–50 reads several companies in one request (R2). One of the scope filters of this list is required.
+        :type company: str
+        :param filer: Fund registrant CIK (one): its fund portfolio
+        :type filer: str
+        :param series: SEC series id of one fund (S + 9 digits; a unit investment trust without a series: cik:<registrant CIK>); with filer=, required when the registrant files for more than one fund
+        :type series: str
+        :param accession: NPORT-P filing: its reported holdings as filed
+        :type accession: str
+        :param period_end: Each fund's latest report on or before this date
+        :type period_end: date
+        :param sort: Sort field: `-value_usd` (the only order the store serves); the id tiebreaker is always appended
+        :type sort: str
+        :param fields: Comma list of root-level fields to keep (R7)
+        :type fields: str
+        :param limit: Rows per page (default 25, max 1 000 on 13F rows)
+        :type limit: int
+        :param cursor: Opaque `next_cursor` of the previous page; reuse it with the SAME filters (changed filters → 400 cursor_mismatch)
+        :type cursor: str
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._list_fund_holdings_serialize(
+            company=company,
+            filer=filer,
+            series=series,
+            accession=accession,
+            period_end=period_end,
+            sort=sort,
+            fields=fields,
+            limit=limit,
+            cursor=cursor,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "ListFundHoldings200Response",
+            '304': None,
+            '400': "Problem",
+            '401': "Problem",
+            '402': "Problem",
+            '403': "Problem",
+            '404': "Problem",
+            '429': "Problem",
+            '500': "Problem",
+            '503': "Problem",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _list_fund_holdings_serialize(
+        self,
+        company,
+        filer,
+        series,
+        accession,
+        period_end,
+        sort,
+        fields,
+        limit,
+        cursor,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        # process the query parameters
+        if company is not None:
+            
+            _query_params.append(('company', company))
+            
+        if filer is not None:
+            
+            _query_params.append(('filer', filer))
+            
+        if series is not None:
+            
+            _query_params.append(('series', series))
+            
+        if accession is not None:
+            
+            _query_params.append(('accession', accession))
+            
+        if period_end is not None:
+            if isinstance(period_end, date):
+                _query_params.append(
+                    (
+                        'period_end',
+                        period_end.strftime(
+                            self.api_client.configuration.date_format
+                        )
+                    )
+                )
+            else:
+                _query_params.append(('period_end', period_end))
+            
+        if sort is not None:
+            
+            _query_params.append(('sort', sort))
+            
+        if fields is not None:
+            
+            _query_params.append(('fields', fields))
+            
+        if limit is not None:
+            
+            _query_params.append(('limit', limit))
+            
+        if cursor is not None:
+            
+            _query_params.append(('cursor', cursor))
+            
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json', 
+                    'application/problem+json'
+                ]
+            )
+
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'bearerAuth'
+        ]
+
+        return self.api_client.param_serialize(
+            method='GET',
+            resource_path='/v1/fund-holdings',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+
+
+
     @validate_call
     def list_holding_changes(
         self,