@chadwin/sdk 0.6.0 → 0.8.0

package/dist/index.d.cts

@@ -7,6 +7,24 @@ interface PromiseWithResponse<T> extends Promise<T> {
 
 interface components {
     schemas: {
+        CompanyFinancialStatementPeriod: {
+            /** @description SEC filing used as the source for this period. EPS and weighted-average shares are adjusted for later stock splits. */
+            accession_number: string;
+            balance_sheet: components["schemas"]["FinancialStatementBalanceSheet"];
+            cash_flow_statement: components["schemas"]["FinancialStatementCashFlowStatement"];
+            currency: string;
+            /** @enum {string} */
+            fiscal_period: "FY";
+            fiscal_year: number;
+            income_statement: components["schemas"]["FinancialStatementIncomeStatement"];
+            metrics: components["schemas"]["FinancialStatementMetrics"];
+            /** Format: date */
+            period_end_date: string;
+        };
+        CompanyFinancialStatementsResponse: {
+            issuer: components["schemas"]["FinancialStatementIssuer"];
+            periods: components["schemas"]["CompanyFinancialStatementPeriod"][];
+        };
         CompanyInsiderTransactionListItem: {
             /**
              * Format: date-time
@@ -152,7 +170,10 @@ interface components {
             listings: {
                 /** @description Source exchange label. */
                 exchange: string | null;
-                /** @enum {boolean} */
+                /**
+                 * @description Present in the accepted SEC ticker snapshot; does not establish trading or business status.
+                 * @enum {boolean}
+                 */
                 is_current: true;
                 share_class_figi: string | null;
                 ticker: string;
@@ -242,7 +263,36 @@ interface components {
             error: "invalid_query" | "invalid_query_parameters";
         };
         CompanySearchResponse: {
-            companies: components["schemas"]["CompanyReference"][];
+            companies: components["schemas"]["CompanySearchResult"][];
+        };
+        CompanySearchResult: {
+            /**
+             * @description Zero-padded SEC Central Index Key.
+             * @example 0000051143
+             */
+            cik: string;
+            /**
+             * @description Stored fiscal year end in MMDD form, or null.
+             * @example 1231
+             */
+            fiscal_year_end: string | null;
+            /** @description All stored ticker and exchange associations for this CIK, including historical associations. May be empty; does not establish currentness or effective dates. */
+            listings: {
+                /** @description Source exchange label. */
+                exchange: string | null;
+                share_class_figi: string | null;
+                ticker: string;
+            }[];
+            /**
+             * @description Company display name.
+             * @example INTERNATIONAL BUSINESS MACHINES CORP
+             */
+            name: string;
+            sic: {
+                code: string;
+                industry_title: string;
+                office: string;
+            } | null;
         };
         DatasetNotEntitledErrorResponse: {
             /** @enum {string} */
@@ -252,6 +302,128 @@ interface components {
             /** @example unauthorized */
             error: string;
         };
+        FinancialStatementBalanceSheet: {
+            accounts_payable_current?: string;
+            accounts_receivable_current?: string;
+            cash_and_cash_equivalents?: string;
+            current_portion_of_long_term_debt?: string;
+            equity_attributable_to_parent?: string;
+            goodwill?: string;
+            intangible_assets_net_excluding_goodwill?: string;
+            inventory?: string;
+            long_term_debt_noncurrent?: string;
+            property_plant_and_equipment_net?: string;
+            retained_earnings_accumulated_deficit?: string;
+            short_term_borrowings?: string;
+            short_term_investments?: string;
+            total_assets?: string;
+            total_current_assets?: string;
+            total_current_liabilities?: string;
+            total_debt?: string;
+            total_liabilities?: string;
+            total_liabilities_and_equity?: string;
+        };
+        FinancialStatementCashFlowStatement: {
+            business_acquisitions_net?: string;
+            capital_expenditure?: string;
+            common_dividends_paid?: string;
+            common_stock_repurchases?: string;
+            depreciation_and_amortization_adjustment?: string;
+            effect_of_exchange_rate_on_cash?: string;
+            net_cash_from_financing_activities?: string;
+            net_cash_from_investing_activities?: string;
+            net_cash_from_operating_activities?: string;
+            net_change_in_cash_cash_equivalents_and_restricted_cash_including_exchange_rate_effect?: string;
+            proceeds_from_common_stock_issuance?: string;
+            proceeds_from_debt_issuance?: string;
+            purchases_of_investments?: string;
+            repayments_of_debt?: string;
+            share_based_compensation_adjustment?: string;
+        };
+        FinancialStatementIncomeStatement: {
+            /** @description Reported earnings per share projected onto the latest reviewed stock-split basis. */
+            basic_earnings_per_share?: string;
+            /** @description Reported weighted-average shares projected onto the latest reviewed stock-split basis. */
+            basic_weighted_average_shares?: string;
+            cost_of_sales?: string;
+            /** @description Reported earnings per share projected onto the latest reviewed stock-split basis. */
+            diluted_earnings_per_share?: string;
+            /** @description Reported weighted-average shares projected onto the latest reviewed stock-split basis. */
+            diluted_weighted_average_shares?: string;
+            gross_profit?: string;
+            income_before_income_taxes?: string;
+            income_tax_expense?: string;
+            interest_expense?: string;
+            net_income_attributable_to_parent?: string;
+            net_income_including_noncontrolling_interests?: string;
+            nonoperating_income_expense?: string;
+            operating_income?: string;
+            research_and_development_expense?: string;
+            revenue?: string;
+            selling_general_and_administrative_expense?: string;
+            total_operating_expenses?: string;
+        };
+        FinancialStatementIssuer: {
+            cik: string;
+            name: string | null;
+            ticker: string | null;
+        };
+        FinancialStatementMetrics: {
+            asset_turnover?: string;
+            cash_ratio?: string;
+            current_ratio?: string;
+            debt_to_assets?: string;
+            debt_to_equity?: string;
+            ebit?: string;
+            ebit_margin?: string;
+            effective_tax_rate?: string;
+            free_cash_flow?: string;
+            free_cash_flow_margin?: string;
+            gross_margin?: string;
+            interest_coverage?: string;
+            net_debt?: string;
+            net_margin?: string;
+            operating_cash_flow_margin?: string;
+            operating_cash_flow_to_net_income?: string;
+            operating_margin?: string;
+            pretax_margin?: string;
+            quick_ratio?: string;
+            return_on_assets?: string;
+            return_on_equity?: string;
+            working_capital?: string;
+        };
+        FinancialStatementsBadRequest: {
+            /** @enum {string} */
+            error: "invalid_query_parameters";
+        };
+        FinancialStatementsCompanyNotFound: {
+            /** @enum {string} */
+            error: "company_not_found";
+        };
+        FinancialStatementsInternalError: {
+            /** @enum {string} */
+            error: "internal_server_error";
+        };
+        FinancialStatementsNotEntitled: {
+            /** @enum {string} */
+            error: "dataset_not_entitled";
+        };
+        FinancialStatementsTickerAmbiguous: {
+            /** @enum {string} */
+            error: "company_ambiguous";
+        };
+        FinancialStatementsTooManyRequests: {
+            /** @enum {string} */
+            error: "rate_limited" | "billing_period_quota_exceeded";
+        };
+        FinancialStatementsUnauthorized: {
+            /** @enum {string} */
+            error: "unauthorized";
+        };
+        FinancialStatementsUnavailable: {
+            /** @enum {string} */
+            error: "database_unavailable";
+        };
         InitialOwnershipActivity: {
             /**
              * Format: date-time
@@ -313,7 +485,7 @@ interface components {
             has_more: boolean;
             /**
              * @description Cursor to send after the current page has been processed successfully.
-             * @example cur_eyJ2IjoxLCJhZnRlciI6MjAzfQ
+             * @example cur_request_bound_example
              */
             next_cursor: string;
         };
@@ -525,7 +697,7 @@ interface components {
             has_more: boolean;
             /**
              * @description Cursor to send after the current page has been processed successfully.
-             * @example cur_eyJ2IjoxLCJhZnRlciI6MTI5fQ
+             * @example cur_request_bound_example
              */
             next_cursor: string;
             transactions: components["schemas"]["InsiderTransactionFeedEvent"][];
@@ -722,7 +894,7 @@ interface components {
             has_more: boolean;
             /**
              * @description Cursor to send after the current page has been processed successfully.
-             * @example cur_eyJ2IjoxLCJhZnRlciI6MTIzfQ
+             * @example cur_request_bound_example
              */
             next_cursor: string;
             updates: components["schemas"]["InstitutionalHoldingFeedUpdate"][];
@@ -1219,125 +1391,19 @@ interface components {
     pathItems: never;
 }
 interface operations {
-    searchCompanies: {
+    getCompany: {
         parameters: {
-            query: {
-                /** @description Company name, current ticker, or padded or unpadded CIK. */
-                query: string;
+            query?: {
+                /** @description Ticker from the accepted SEC snapshot. Supply exactly one ticker or CIK; letters normalize to uppercase. */
+                ticker?: string;
+                /** @description Positive SEC CIK, one to ten decimal digits. Supply exactly one ticker or CIK; CIKs normalize to ten digits. */
+                cik?: string;
             };
             header?: never;
             path?: never;
             cookie?: never;
         };
         requestBody?: never;
-        responses: {
-            /** @description Ranked company matches. */
-            200: {
-                headers: {
-                    "Cache-Control"?: string;
-                    "X-Billing-Period-Quota-Limit"?: string;
-                    "X-Billing-Period-Quota-Remaining"?: string;
-                    "X-Billing-Period-Quota-Reset"?: string;
-                    [name: string]: unknown;
-                };
-                content: {
-                    /**
-                     * @example {
-                     *       "companies": [
-                     *         {
-                     *           "cik": "0000051143",
-                     *           "fiscal_year_end": "1231",
-                     *           "listings": [
-                     *             {
-                     *               "exchange": "NYSE",
-                     *               "is_current": true,
-                     *               "share_class_figi": "BBG001S5S399",
-                     *               "ticker": "IBM"
-                     *             }
-                     *           ],
-                     *           "name": "International Business Machines Corporation",
-                     *           "sic": {
-                     *             "code": "3570",
-                     *             "industry_title": "COMPUTER & OFFICE EQUIPMENT",
-                     *             "office": "Office of Technology"
-                     *           }
-                     *         }
-                     *       ]
-                     *     }
-                     */
-                    "application/json": components["schemas"]["CompanySearchResponse"];
-                };
-            };
-            /** @description The query is missing, invalid, or has unsupported keys. */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    /**
-                     * @example {
-                     *       "error": "invalid_query"
-                     *     }
-                     */
-                    "application/json": components["schemas"]["CompanySearchBadRequestResponse"];
-                };
-            };
-            /** @description The request is missing a valid Chadwin API key. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description The request exceeded a rate limit. */
-            429: {
-                headers: {
-                    "RateLimit-Limit"?: string;
-                    "RateLimit-Reset"?: string;
-                    "Retry-After"?: string;
-                    "X-Billing-Period-Quota-Limit"?: string;
-                    "X-Billing-Period-Quota-Remaining"?: string;
-                    "X-Billing-Period-Quota-Reset"?: string;
-                    [name: string]: unknown;
-                };
-                content: {
-                    /**
-                     * @example {
-                     *       "error": "rate_limited"
-                     *     }
-                     */
-                    "application/json": components["schemas"]["CompanyReferenceTooManyRequestsResponse"];
-                };
-            };
-            /** @description The database is unavailable. */
-            503: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    /**
-                     * @example {
-                     *       "error": "database_unavailable"
-                     *     }
-                     */
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-        };
-    };
-    getCompany: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                /** @description US listed company ticker */
-                ticker: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
         responses: {
             /** @description Company reference details. */
             200: {
@@ -1374,6 +1440,18 @@ interface operations {
                     "application/json": components["schemas"]["CompanyReferenceResponse"];
                 };
             };
+            /** @description Supply exactly one valid ticker or CIK and no other query keys. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @enum {string} */
+                        error: "invalid_query_parameters";
+                    };
+                };
+            };
             /** @description The request is missing a valid Chadwin API key. */
             401: {
                 headers: {
@@ -1383,7 +1461,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
-            /** @description The ticker does not resolve to exactly one current company. */
+            /** @description The ticker does not resolve, or the selected CIK has no stored company profile. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -1397,6 +1475,18 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
+            /** @description The ticker matches multiple CIKs. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @enum {string} */
+                        error: "company_ambiguous";
+                    };
+                };
+            };
             /** @description The request exceeded a rate limit. */
             429: {
                 headers: {
@@ -1747,7 +1837,235 @@ interface operations {
                     "application/json": components["schemas"]["DatasetNotEntitledErrorResponse"];
                 };
             };
-            /** @description The requested company was not found */
+            /** @description The requested company was not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description The request exceeded a rate limit. */
+            429: {
+                headers: {
+                    "RateLimit-Limit"?: string;
+                    "RateLimit-Reset"?: string;
+                    "Retry-After"?: string;
+                    "X-Billing-Period-Quota-Limit"?: string;
+                    "X-Billing-Period-Quota-Remaining"?: string;
+                    "X-Billing-Period-Quota-Reset"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description The database is unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    getCompanyReport: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                ticker: string;
+                fiscal_year: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Annual report filing family */
+            200: {
+                headers: {
+                    "Cache-Control"?: string;
+                    ETag?: string;
+                    "X-Billing-Period-Quota-Limit"?: string;
+                    "X-Billing-Period-Quota-Remaining"?: string;
+                    "X-Billing-Period-Quota-Reset"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "filings": [
+                     *         {
+                     *           "accepted_at": "2024-11-01T10:00:00.000Z",
+                     *           "accession_number": "0000320193-24-000123",
+                     *           "content_url": "/v1/sec/company-reports/0000320193-24-000123/content.html",
+                     *           "form": "10-K",
+                     *           "period_end_date": "2024-09-28",
+                     *           "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.htm"
+                     *         }
+                     *       ],
+                     *       "fiscal_period": "FY",
+                     *       "fiscal_year": 2024,
+                     *       "issuer": {
+                     *         "cik": "0000320193",
+                     *         "name": "Apple Inc.",
+                     *         "ticker": "AAPL"
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["CompanyReportFamilyResponse"];
+                };
+            };
+            /** @description The ticker or fiscal year is invalid */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description The request is missing a valid Chadwin API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description The subscription does not include this dataset. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DatasetNotEntitledErrorResponse"];
+                };
+            };
+            /** @description The company or eligible annual report was not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description More than one original annual report matches the fiscal year */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description The request exceeded a rate limit. */
+            429: {
+                headers: {
+                    "RateLimit-Limit"?: string;
+                    "RateLimit-Reset"?: string;
+                    "Retry-After"?: string;
+                    "X-Billing-Period-Quota-Limit"?: string;
+                    "X-Billing-Period-Quota-Remaining"?: string;
+                    "X-Billing-Period-Quota-Reset"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description The filing catalog is unavailable */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
+    getCompanyReportForFiscalPeriod: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                ticker: string;
+                fiscal_year: string;
+                fiscal_period: "Q1" | "Q2" | "Q3";
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Quarterly report filing family */
+            200: {
+                headers: {
+                    "Cache-Control"?: string;
+                    ETag?: string;
+                    "X-Billing-Period-Quota-Limit"?: string;
+                    "X-Billing-Period-Quota-Remaining"?: string;
+                    "X-Billing-Period-Quota-Reset"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "filings": [
+                     *         {
+                     *           "accepted_at": "2025-08-01T10:00:42.000Z",
+                     *           "accession_number": "0000320193-25-000073",
+                     *           "content_url": "/v1/sec/company-reports/0000320193-25-000073/content.html",
+                     *           "form": "10-Q",
+                     *           "period_end_date": "2025-06-28",
+                     *           "sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000073/0000320193-25-000073-index.htm"
+                     *         }
+                     *       ],
+                     *       "fiscal_period": "Q3",
+                     *       "fiscal_year": 2025,
+                     *       "issuer": {
+                     *         "cik": "0000320193",
+                     *         "name": "Apple Inc.",
+                     *         "ticker": "AAPL"
+                     *       }
+                     *     }
+                     */
+                    "application/json": components["schemas"]["CompanyReportFamilyResponse"];
+                };
+            };
+            /** @description The ticker, fiscal year, or fiscal period is invalid */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description The request is missing a valid Chadwin API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description The subscription does not include this dataset. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DatasetNotEntitledErrorResponse"];
+                };
+            };
+            /** @description The company or eligible quarterly report was not found */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -1756,6 +2074,15 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
+            /** @description More than one original quarterly report matches the fiscal period */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
             /** @description The request exceeded a rate limit. */
             429: {
                 headers: {
@@ -1771,7 +2098,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
-            /** @description The database is unavailable */
+            /** @description The filing catalog is unavailable */
             503: {
                 headers: {
                     [name: string]: unknown;
@@ -1782,13 +2109,14 @@ interface operations {
             };
         };
     };
-    getCompanyReport: {
+    getCompanyReportByCik: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                ticker: string;
                 fiscal_year: string;
+                /** @description Positive SEC CIK as one to ten decimal digits; leading zeros are optional. */
+                cik: string;
             };
             cookie?: never;
         };
@@ -1829,7 +2157,7 @@ interface operations {
                     "application/json": components["schemas"]["CompanyReportFamilyResponse"];
                 };
             };
-            /** @description The ticker or fiscal year is invalid */
+            /** @description The cik or fiscal year is invalid */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -1900,13 +2228,14 @@ interface operations {
             };
         };
     };
-    getCompanyReportForFiscalPeriod: {
+    getCompanyReportByCikForFiscalPeriod: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                ticker: string;
                 fiscal_year: string;
+                /** @description Positive SEC CIK as one to ten decimal digits; leading zeros are optional. */
+                cik: string;
                 fiscal_period: "Q1" | "Q2" | "Q3";
             };
             cookie?: never;
@@ -1948,7 +2277,7 @@ interface operations {
                     "application/json": components["schemas"]["CompanyReportFamilyResponse"];
                 };
             };
-            /** @description The ticker, fiscal year, or fiscal period is invalid */
+            /** @description The cik, fiscal year, or fiscal period is invalid */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -2019,10 +2348,310 @@ interface operations {
             };
         };
     };
+    getCompanyFinancialStatements: {
+        parameters: {
+            query?: {
+                /** @description Ticker from the accepted SEC snapshot. Supply exactly one ticker or CIK; letters normalize to uppercase. */
+                ticker?: string;
+                /** @description Positive SEC CIK, one to ten decimal digits. Supply exactly one ticker or CIK; CIKs normalize to ten digits. */
+                cik?: string;
+                /** @description One fiscal year from 1900 through 9999. */
+                fiscal_year?: number;
+                /** @description Newest available fiscal years to return, from 1 through 20. */
+                years?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Published and reviewed normalized annual financial statements. */
+            200: {
+                headers: {
+                    "Cache-Control"?: string;
+                    "X-Billing-Period-Quota-Limit"?: string;
+                    "X-Billing-Period-Quota-Remaining"?: string;
+                    "X-Billing-Period-Quota-Reset"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "issuer": {
+                     *         "cik": "0000320193",
+                     *         "name": "Apple Inc.",
+                     *         "ticker": "AAPL"
+                     *       },
+                     *       "periods": [
+                     *         {
+                     *           "accession_number": "0000320193-25-000079",
+                     *           "balance_sheet": {
+                     *             "accounts_payable_current": "69860000000",
+                     *             "accounts_receivable_current": "39777000000",
+                     *             "cash_and_cash_equivalents": "35934000000",
+                     *             "current_portion_of_long_term_debt": "12350000000",
+                     *             "equity_attributable_to_parent": "73733000000",
+                     *             "inventory": "5718000000",
+                     *             "long_term_debt_noncurrent": "78328000000",
+                     *             "property_plant_and_equipment_net": "49834000000",
+                     *             "short_term_borrowings": "7979000000",
+                     *             "short_term_investments": "18763000000",
+                     *             "total_assets": "359241000000",
+                     *             "total_current_assets": "147957000000",
+                     *             "total_current_liabilities": "165631000000",
+                     *             "total_liabilities": "285508000000",
+                     *             "total_liabilities_and_equity": "359241000000"
+                     *           },
+                     *           "cash_flow_statement": {
+                     *             "capital_expenditure": "12715000000",
+                     *             "common_stock_repurchases": "90711000000",
+                     *             "depreciation_and_amortization_adjustment": "11698000000",
+                     *             "net_cash_from_financing_activities": "-120686000000",
+                     *             "net_cash_from_investing_activities": "15195000000",
+                     *             "net_cash_from_operating_activities": "111482000000",
+                     *             "net_change_in_cash_cash_equivalents_and_restricted_cash_including_exchange_rate_effect": "5991000000",
+                     *             "purchases_of_investments": "24407000000",
+                     *             "share_based_compensation_adjustment": "12863000000"
+                     *           },
+                     *           "currency": "USD",
+                     *           "fiscal_period": "FY",
+                     *           "fiscal_year": 2025,
+                     *           "income_statement": {
+                     *             "basic_earnings_per_share": "7.49",
+                     *             "basic_weighted_average_shares": "14948500000",
+                     *             "cost_of_sales": "220960000000",
+                     *             "diluted_earnings_per_share": "7.46",
+                     *             "diluted_weighted_average_shares": "15004697000",
+                     *             "gross_profit": "195201000000",
+                     *             "income_before_income_taxes": "132729000000",
+                     *             "income_tax_expense": "20719000000",
+                     *             "net_income_attributable_to_parent": "112010000000",
+                     *             "net_income_including_noncontrolling_interests": "112010000000",
+                     *             "nonoperating_income_expense": "-321000000",
+                     *             "operating_income": "133050000000",
+                     *             "research_and_development_expense": "34550000000",
+                     *             "revenue": "416161000000",
+                     *             "selling_general_and_administrative_expense": "27601000000",
+                     *             "total_operating_expenses": "62151000000"
+                     *           },
+                     *           "metrics": {
+                     *             "asset_turnover": "1.15",
+                     *             "cash_ratio": "0.22",
+                     *             "current_ratio": "0.89",
+                     *             "effective_tax_rate": "15.61",
+                     *             "free_cash_flow": "98767000000",
+                     *             "free_cash_flow_margin": "23.73",
+                     *             "gross_margin": "46.91",
+                     *             "net_margin": "26.92",
+                     *             "operating_cash_flow_margin": "26.79",
+                     *             "operating_cash_flow_to_net_income": "1.00",
+                     *             "operating_margin": "31.97",
+                     *             "pretax_margin": "31.89",
+                     *             "quick_ratio": "0.57",
+                     *             "return_on_assets": "30.93",
+                     *             "return_on_equity": "171.42",
+                     *             "working_capital": "-17674000000"
+                     *           },
+                     *           "period_end_date": "2025-09-27"
+                     *         }
+                     *       ]
+                     *     }
+                     */
+                    "application/json": components["schemas"]["CompanyFinancialStatementsResponse"];
+                };
+            };
+            /** @description The identifier or query parameters are invalid. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FinancialStatementsBadRequest"];
+                };
+            };
+            /** @description The request is missing a valid Chadwin API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FinancialStatementsUnauthorized"];
+                };
+            };
+            /** @description The subscription does not include this dataset. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FinancialStatementsNotEntitled"];
+                };
+            };
+            /** @description No company matches the requested ticker. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FinancialStatementsCompanyNotFound"];
+                };
+            };
+            /** @description The ticker matches more than one CIK in the accepted SEC snapshot. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FinancialStatementsTickerAmbiguous"];
+                };
+            };
+            /** @description The request exceeded a rate limit or monthly quota. */
+            429: {
+                headers: {
+                    "RateLimit-Limit"?: string;
+                    "RateLimit-Reset"?: string;
+                    "Retry-After"?: string;
+                    "X-Billing-Period-Quota-Limit"?: string;
+                    "X-Billing-Period-Quota-Remaining"?: string;
+                    "X-Billing-Period-Quota-Reset"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FinancialStatementsTooManyRequests"];
+                };
+            };
+            /** @description A stored result cannot map to the public schema. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FinancialStatementsInternalError"];
+                };
+            };
+            /** @description The database is unavailable. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FinancialStatementsUnavailable"];
+                };
+            };
+        };
+    };
+    searchCompanies: {
+        parameters: {
+            query: {
+                /** @description Company name, stored ticker association, or padded or unpadded CIK. */
+                query: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Ranked company matches. */
+            200: {
+                headers: {
+                    "Cache-Control"?: string;
+                    "X-Billing-Period-Quota-Limit"?: string;
+                    "X-Billing-Period-Quota-Remaining"?: string;
+                    "X-Billing-Period-Quota-Reset"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "companies": [
+                     *         {
+                     *           "cik": "0000051143",
+                     *           "fiscal_year_end": "1231",
+                     *           "listings": [
+                     *             {
+                     *               "exchange": "NYSE",
+                     *               "share_class_figi": "BBG001S5S399",
+                     *               "ticker": "IBM"
+                     *             }
+                     *           ],
+                     *           "name": "International Business Machines Corporation",
+                     *           "sic": {
+                     *             "code": "3570",
+                     *             "industry_title": "COMPUTER & OFFICE EQUIPMENT",
+                     *             "office": "Office of Technology"
+                     *           }
+                     *         }
+                     *       ]
+                     *     }
+                     */
+                    "application/json": components["schemas"]["CompanySearchResponse"];
+                };
+            };
+            /** @description The query is missing, invalid, or has unsupported keys. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "invalid_query"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["CompanySearchBadRequestResponse"];
+                };
+            };
+            /** @description The request is missing a valid Chadwin API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description The request exceeded a rate limit. */
+            429: {
+                headers: {
+                    "RateLimit-Limit"?: string;
+                    "RateLimit-Reset"?: string;
+                    "Retry-After"?: string;
+                    "X-Billing-Period-Quota-Limit"?: string;
+                    "X-Billing-Period-Quota-Remaining"?: string;
+                    "X-Billing-Period-Quota-Reset"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "rate_limited"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["CompanyReferenceTooManyRequestsResponse"];
+                };
+            };
+            /** @description The database is unavailable. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "error": "database_unavailable"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+        };
+    };
     listCompanyReportFeed: {
         parameters: {
             query?: {
-                /** @description Use `next_cursor` from the previous response. Keep the same `forms` filter and do not combine this with `start`. */
+                /** @description Use `next_cursor` from the previous response. The cursor is bound to this feed, the normalized `forms` filter, and the page size. Do not combine it with `start`. */
                 cursor?: string;
                 /** @description Optional comma-separated report families. Supported values are 10-K, 10-Q, 20-F, and 40-F. Each family includes its /A amendments. */
                 forms?: string;
@@ -2050,7 +2679,7 @@ interface operations {
                     /**
                      * @example {
                      *       "has_more": false,
-                     *       "next_cursor": "cur_eyJ2IjoxLCJhZnRlciI6MTIzNDV9",
+                     *       "next_cursor": "cur_request_bound_example",
                      *       "updates": [
                      *         {
                      *           "accepted_at": "2025-08-01T10:00:42.000Z",
@@ -2167,7 +2796,7 @@ interface operations {
             query?: {
                 /** @description Optional comma-separated SEC forms to include. Supported forms: 3, 3/A, 4, 4/A, 5, 5/A, 144, 144/A. Omission selects all supported forms. Reuse the same selection with every cursor request. */
                 forms?: string;
-                /** @description Use `next_cursor` from the previous response to continue where you left off. Keep the same `forms` filter. Do not use `cursor` and `start` together. Omit both to get the most recent activity updates. */
+                /** @description Use `next_cursor` from the previous response to continue where you left off. The cursor is bound to this feed, the normalized `forms` filter, and the page size. Do not use `cursor` and `start` together. Omit both to get the most recent activity updates. */
                 cursor?: string;
                 /** @description Page size from 1 through 1000. */
                 limit?: string;
@@ -2466,7 +3095,7 @@ interface operations {
     listInsiderTransactionFeed: {
         parameters: {
             query?: {
-                /** @description Use `next_cursor` from the previous response to continue where you left off. Keep the same `transaction_codes` filter. Do not use `cursor` and `start` together. Omit both to get the most recent transaction updates. */
+                /** @description Use `next_cursor` from the previous response to continue where you left off. The cursor is bound to this feed, the normalized `transaction_codes` filter, and the page size. Do not use `cursor` and `start` together. Omit both to get the most recent transaction updates. */
                 cursor?: string;
                 /** @description Page size from 1 through 1000. */
                 limit?: string;
@@ -2550,7 +3179,7 @@ interface operations {
     listInstitutionalFilingFeed: {
         parameters: {
             query?: {
-                /** @description Use `next_cursor` from the previous response to continue where you left off. Keep the same `forms` filter. Do not use `cursor` and `start` together. Omit both to get the most recent filing updates. */
+                /** @description Use `next_cursor` from the previous response to continue where you left off. The cursor is bound to this feed, the normalized `forms` filter, and the page size. Do not use `cursor` and `start` together. Omit both to get the most recent filing updates. */
                 cursor?: string;
                 /** @description Optional comma-separated 13F form types to include. Supported forms: 13F-HR, 13F-HR/A, 13F-NT, 13F-NT/A. Omitted or empty means all supported forms. */
                 forms?: string;
@@ -2634,7 +3263,7 @@ interface operations {
     listInstitutionalManagers: {
         parameters: {
             query?: {
-                /** @description Optional pagination cursor returned as next_cursor from a prior response. */
+                /** @description Opaque next_cursor from the prior page. Keep the same filters and page size. */
                 cursor?: string;
                 /** @description Page size from 1 through 1000. */
                 limit?: string;
@@ -2673,7 +3302,7 @@ interface operations {
                      *           "total_value_usd": "267891234567"
                      *         }
                      *       ],
-                     *       "next_cursor": "cur_eyJ2IjoxLCJuYW1lIjoiQmVya3NoaXJlIEhhdGhhd2F5IEluYy4iLCJmb3JtXzEzZl9maWxlX251bWJlciI6IjAyOC0wNDU0NSJ9"
+                     *       "next_cursor": "cur_request_bound_example"
                      *     }
                      */
                     "application/json": components["schemas"]["InstitutionalManagersResponse"];
@@ -2933,7 +3562,7 @@ interface operations {
     listInstitutionalManagerHoldings: {
         parameters: {
             query: {
-                /** @description Optional pagination cursor returned as next_cursor from a prior response. */
+                /** @description Opaque next_cursor from the prior page. Keep the same resource identifiers and page size. If the bound filing or manager-period revision changed, restart without a cursor. */
                 cursor?: string;
                 /** @description Page size from 1 through 5000. */
                 limit?: string;
@@ -2997,7 +3626,7 @@ interface operations {
                      *         "form_13f_file_number": "028-04545",
                      *         "name": "Berkshire Hathaway Inc."
                      *       },
-                     *       "next_cursor": "cur_eyJ2IjoxLCJhZnRlciI6MX0",
+                     *       "next_cursor": "cur_request_bound_example",
                      *       "period": {
                      *         "accepted_at": "2026-05-15T20:12:34.000Z",
                      *         "period_of_report": "2026-03-31"
@@ -3043,6 +3672,15 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
+            /** @description The manager-period holdings changed after the cursor was issued. Restart pagination from the first page. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
             /** @description The request exceeded a rate limit. */
             429: {
                 headers: {
@@ -3188,7 +3826,7 @@ interface operations {
     listInstitutionalManagerPositions: {
         parameters: {
             query: {
-                /** @description Optional pagination cursor returned as next_cursor from a prior response. */
+                /** @description Opaque next_cursor from the prior page. Keep the same resource identifiers and page size. If the bound filing or manager-period revision changed, restart without a cursor. */
                 cursor?: string;
                 /** @description Page size from 1 through 5000. */
                 limit?: string;
@@ -3971,7 +4609,7 @@ interface operations {
     listSecInstitutionalFilingHoldings: {
         parameters: {
             query?: {
-                /** @description Optional pagination cursor returned as next_cursor from a prior response. */
+                /** @description Opaque next_cursor from the prior page. Keep the same resource identifiers and page size. If the bound filing or manager-period revision changed, restart without a cursor. */
                 cursor?: string;
                 /** @description Page size from 1 through 5000. */
                 limit?: string;
@@ -4027,7 +4665,7 @@ interface operations {
                      *           }
                      *         }
                      *       ],
-                     *       "next_cursor": "cur_eyJ2IjoxLCJhZnRlciI6MX0",
+                     *       "next_cursor": "cur_request_bound_example",
                      *       "period_of_report": "2026-03-31",
                      *       "report_type": "13F HOLDINGS REPORT"
                      *     }
@@ -4071,6 +4709,15 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
+            /** @description The filing holdings changed after the cursor was issued. Restart pagination from the first page. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
             /** @description The request exceeded a rate limit. */
             429: {
                 headers: {
@@ -4254,6 +4901,23 @@ interface operations {
 
 type CompanyReportForm = "10-K" | "10-Q" | "20-F" | "40-F";
 type CompanyReportFiscalPeriod = "Q1" | "Q2" | "Q3";
+type CompanySelector = {
+    ticker: string;
+    cik?: never;
+} | {
+    cik: string;
+    ticker?: never;
+};
+type FinancialStatementsGetParams = CompanySelector & ({
+    fiscalYear: number;
+    years?: never;
+} | {
+    years: number;
+    fiscalYear?: never;
+} | {
+    fiscalYear?: never;
+    years?: never;
+});
 type InsiderActivityForm = "3" | "3/A" | "4" | "4/A" | "5" | "5/A" | "144" | "144/A";
 type InsiderTransactionCode = "A" | "C" | "D" | "E" | "F" | "G" | "H" | "I" | "J" | "K" | "L" | "M" | "O" | "P" | "S" | "U" | "V" | "W" | "X" | "Z";
 type InstitutionalFilingForm = "13F-HR" | "13F-HR/A" | "13F-NT" | "13F-NT/A";
@@ -4371,9 +5035,7 @@ declare class Companies {
     search({ query }: {
         query: string;
     }): PromiseWithResponse<JsonResponse<"searchCompanies">>;
-    get({ ticker }: {
-        ticker: string;
-    }): PromiseWithResponse<JsonResponse<"getCompany">>;
+    get({ ticker, cik }: CompanySelector): PromiseWithResponse<JsonResponse<"getCompany">>;
 }
 declare class CompanyReports {
     private readonly transport;
@@ -4394,6 +5056,11 @@ declare class CompanyReports {
         accessionNumber: string;
     }): PromiseWithResponse<TextResponse<"getSecCompanyReportContent">>;
 }
+declare class FinancialStatements {
+    private readonly transport;
+    constructor(transport: HttpTransport);
+    get({ ticker, cik, fiscalYear, years, }: FinancialStatementsGetParams): PromiseWithResponse<JsonResponse<"getCompanyFinancialStatements">>;
+}
 declare class InsiderTransactions {
     private readonly transport;
     constructor(transport: HttpTransport);
@@ -4539,6 +5206,7 @@ declare class Chadwin {
     readonly companies: Companies;
     readonly companyReports: CompanyReports;
     readonly feeds: Feeds;
+    readonly financialStatements: FinancialStatements;
     readonly insiderFilings: InsiderFilings;
     readonly insiderTransactions: InsiderTransactions;
     readonly institutionalFilings: InstitutionalFilings;
@@ -4559,4 +5227,4 @@ declare class APIError extends Error {
     constructor(message: string, options?: APIErrorOptions);
 }
 
-export { APIError, Chadwin, type ClientOptions, type CompanyReportFeedFilters, type CompanyReportFiscalPeriod, type CompanyReportForm, type InsiderActivityFeedFilters, type InsiderActivityForm, type InsiderTransactionCode, type InsiderTransactionFeedFilters, type InstitutionalFilingFeedFilters, type InstitutionalFilingForm, type InstitutionalHolding, type InstitutionalManager, type InstitutionalPosition, type PromiseWithResponse };
+export { APIError, Chadwin, type ClientOptions, type CompanyReportFeedFilters, type CompanyReportFiscalPeriod, type CompanyReportForm, type CompanySelector, type FinancialStatementsGetParams, type InsiderActivityFeedFilters, type InsiderActivityForm, type InsiderTransactionCode, type InsiderTransactionFeedFilters, type InstitutionalFilingFeedFilters, type InstitutionalFilingForm, type InstitutionalHolding, type InstitutionalManager, type InstitutionalPosition, type PromiseWithResponse };