@chadwin/sdk 0.7.0 → 0.9.0

package/dist/index.d.cts

@@ -8,6 +8,7 @@ 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"];
@@ -169,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;
@@ -259,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} */
@@ -280,12 +313,13 @@ interface components {
             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_borrowings?: string;
             total_current_assets?: string;
             total_current_liabilities?: string;
+            total_debt?: string;
             total_liabilities?: string;
             total_liabilities_and_equity?: string;
         };
@@ -307,16 +341,19 @@ interface components {
             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_noncontrolling_interests?: string;
             net_income_attributable_to_parent?: string;
             net_income_including_noncontrolling_interests?: string;
             nonoperating_income_expense?: string;
@@ -328,8 +365,8 @@ interface components {
         };
         FinancialStatementIssuer: {
             cik: string;
-            name: string;
-            ticker: string;
+            name: string | null;
+            ticker: string | null;
         };
         FinancialStatementMetrics: {
             asset_turnover?: string;
@@ -338,6 +375,7 @@ interface components {
             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;
@@ -356,7 +394,7 @@ interface components {
         };
         FinancialStatementsBadRequest: {
             /** @enum {string} */
-            error: "invalid_ticker" | "invalid_query_parameters";
+            error: "invalid_query_parameters";
         };
         FinancialStatementsCompanyNotFound: {
             /** @enum {string} */
@@ -372,7 +410,7 @@ interface components {
         };
         FinancialStatementsTickerAmbiguous: {
             /** @enum {string} */
-            error: "company_ticker_ambiguous";
+            error: "company_ambiguous";
         };
         FinancialStatementsTooManyRequests: {
             /** @enum {string} */
@@ -1353,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: {
@@ -1508,152 +1440,16 @@ interface operations {
                     "application/json": components["schemas"]["CompanyReferenceResponse"];
                 };
             };
-            /** @description The request is missing a valid Chadwin API key. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description The ticker does not resolve to exactly one current company. */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    /**
-                     * @example {
-                     *       "error": "company_not_found"
-                     *     }
-                     */
-                    "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"];
-                };
-            };
-        };
-    };
-    getCompanyFinancialStatements: {
-        parameters: {
-            query?: {
-                /** @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: {
-                /** @description US listed company ticker */
-                ticker: string;
-            };
-            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-24-000123",
-                     *           "balance_sheet": {
-                     *             "cash_and_cash_equivalents": "29943000000",
-                     *             "equity_attributable_to_parent": "56950000000",
-                     *             "total_assets": "364980000000",
-                     *             "total_current_assets": "152987000000",
-                     *             "total_current_liabilities": "176392000000"
-                     *           },
-                     *           "cash_flow_statement": {
-                     *             "net_cash_from_financing_activities": "-121983000000",
-                     *             "net_cash_from_investing_activities": "2935000000",
-                     *             "net_cash_from_operating_activities": "118254000000"
-                     *           },
-                     *           "currency": "USD",
-                     *           "fiscal_period": "FY",
-                     *           "fiscal_year": 2024,
-                     *           "income_statement": {
-                     *             "basic_earnings_per_share": "6.11",
-                     *             "diluted_earnings_per_share": "6.08",
-                     *             "income_before_income_taxes": "123485000000",
-                     *             "income_tax_expense": "29749000000",
-                     *             "net_income_attributable_to_parent": "93736000000",
-                     *             "operating_income": "123216000000",
-                     *             "revenue": "391035000000"
-                     *           },
-                     *           "metrics": {
-                     *             "cash_ratio": "0.17",
-                     *             "current_ratio": "0.87",
-                     *             "effective_tax_rate": "24.09",
-                     *             "net_margin": "23.97",
-                     *             "operating_cash_flow_margin": "30.24",
-                     *             "operating_margin": "31.51",
-                     *             "pretax_margin": "31.58",
-                     *             "return_on_equity": "157.41",
-                     *             "working_capital": "-23405000000"
-                     *           },
-                     *           "period_end_date": "2024-09-28"
-                     *         }
-                     *       ]
-                     *     }
-                     */
-                    "application/json": components["schemas"]["CompanyFinancialStatementsResponse"];
-                };
-            };
-            /** @description The ticker or query parameters are invalid. */
+            /** @description Supply exactly one valid ticker or CIK and no other query keys. */
             400: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["FinancialStatementsBadRequest"];
+                    "application/json": {
+                        /** @enum {string} */
+                        error: "invalid_query_parameters";
+                    };
                 };
             };
             /** @description The request is missing a valid Chadwin API key. */
@@ -1662,37 +1458,36 @@ interface operations {
                     [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"];
+                    "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
-            /** @description No current company has the requested ticker. */
+            /** @description The ticker does not resolve, or the selected CIK has no stored company profile. */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["FinancialStatementsCompanyNotFound"];
+                    /**
+                     * @example {
+                     *       "error": "company_not_found"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
-            /** @description More than one current company has the ticker. */
+            /** @description The ticker matches multiple CIKs. */
             409: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["FinancialStatementsTickerAmbiguous"];
+                    "application/json": {
+                        /** @enum {string} */
+                        error: "company_ambiguous";
+                    };
                 };
             };
-            /** @description The request exceeded a rate limit or monthly quota. */
+            /** @description The request exceeded a rate limit. */
             429: {
                 headers: {
                     "RateLimit-Limit"?: string;
@@ -1704,16 +1499,12 @@ interface operations {
                     [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"];
+                    /**
+                     * @example {
+                     *       "error": "rate_limited"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["CompanyReferenceTooManyRequestsResponse"];
                 };
             };
             /** @description The database is unavailable. */
@@ -1722,7 +1513,12 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["FinancialStatementsUnavailable"];
+                    /**
+                     * @example {
+                     *       "error": "database_unavailable"
+                     *     }
+                     */
+                    "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
         };
@@ -2076,23 +1872,28 @@ interface operations {
             };
         };
     };
-    getCompanyReport: {
+    getCompanyFinancialStatements: {
         parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                ticker: string;
-                fiscal_year: 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;
+                /** @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 Annual report filing family */
+            /** @description Published and reviewed normalized annual financial statements. */
             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;
@@ -2101,35 +1902,96 @@ interface operations {
                 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"
-                     *       }
+                     *       },
+                     *       "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"]["CompanyReportFamilyResponse"];
+                    "application/json": components["schemas"]["CompanyFinancialStatementsResponse"];
                 };
             };
-            /** @description The ticker or fiscal year is invalid */
+            /** @description The identifier or query parameters are invalid. */
             400: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["FinancialStatementsBadRequest"];
                 };
             };
             /** @description The request is missing a valid Chadwin API key. */
@@ -2138,7 +2000,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["FinancialStatementsUnauthorized"];
                 };
             };
             /** @description The subscription does not include this dataset. */
@@ -2147,28 +2009,28 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["DatasetNotEntitledErrorResponse"];
+                    "application/json": components["schemas"]["FinancialStatementsNotEntitled"];
                 };
             };
-            /** @description The company or eligible annual report was not found */
+            /** @description No company matches the requested ticker. */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["FinancialStatementsCompanyNotFound"];
                 };
             };
-            /** @description More than one original annual report matches the fiscal year */
+            /** @description The ticker matches more than one CIK in the accepted SEC snapshot. */
             409: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["FinancialStatementsTickerAmbiguous"];
                 };
             };
-            /** @description The request exceeded a rate limit. */
+            /** @description The request exceeded a rate limit or monthly quota. */
             429: {
                 headers: {
                     "RateLimit-Limit"?: string;
@@ -2180,34 +2042,48 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["FinancialStatementsTooManyRequests"];
                 };
             };
-            /** @description The filing catalog is unavailable */
+            /** @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"]["ErrorResponse"];
+                    "application/json": components["schemas"]["FinancialStatementsUnavailable"];
                 };
             };
         };
     };
-    getCompanyReportForFiscalPeriod: {
+    getCompanyReportsForPeriod: {
         parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                ticker: 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;
+                /** @description Required four-digit fiscal year, from 1900 through 9999. */
                 fiscal_year: string;
-                fiscal_period: "Q1" | "Q2" | "Q3";
+                /** @description Required FY for annual reports, or Q1, Q2 or Q3 for quarterly reports. FY is not Q4. */
+                fiscal_period: "FY" | "Q1" | "Q2" | "Q3";
             };
+            header?: never;
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Quarterly report filing family */
+            /** @description Original report and subsequent amendments */
             200: {
                 headers: {
                     "Cache-Control"?: string;
@@ -2222,16 +2098,16 @@ interface operations {
                      * @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"
+                     *           "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": "Q3",
-                     *       "fiscal_year": 2025,
+                     *       "fiscal_period": "FY",
+                     *       "fiscal_year": 2024,
                      *       "issuer": {
                      *         "cik": "0000320193",
                      *         "name": "Apple Inc.",
@@ -2242,13 +2118,16 @@ interface operations {
                     "application/json": components["schemas"]["CompanyReportFamilyResponse"];
                 };
             };
-            /** @description The ticker, fiscal year, or fiscal period is invalid */
+            /** @description Supply one identifier, a valid fiscal year and FY, Q1, Q2 or Q3; no extra or repeated keys. */
             400: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": {
+                        /** @enum {string} */
+                        error: "invalid_query_parameters";
+                    };
                 };
             };
             /** @description The request is missing a valid Chadwin API key. */
@@ -2269,22 +2148,28 @@ interface operations {
                     "application/json": components["schemas"]["DatasetNotEntitledErrorResponse"];
                 };
             };
-            /** @description The company or eligible quarterly report was not found */
+            /** @description The ticker is unresolved or no eligible report family exists. */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": {
+                        /** @enum {string} */
+                        error: "company_not_found" | "company_report_not_found";
+                    };
                 };
             };
-            /** @description More than one original quarterly report matches the fiscal period */
+            /** @description The ticker matches multiple CIKs or multiple original reports match the selected period. */
             409: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": {
+                        /** @enum {string} */
+                        error: "company_ambiguous" | "company_report_ambiguous";
+                    };
                 };
             };
             /** @description The request exceeded a rate limit. */
@@ -2313,6 +2198,113 @@ interface operations {
             };
         };
     };
+    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?: {
@@ -4565,20 +4557,24 @@ interface operations {
 }
 
 type CompanyReportForm = "10-K" | "10-Q" | "20-F" | "40-F";
-type CompanyReportFiscalPeriod = "Q1" | "Q2" | "Q3";
-type FinancialStatementsGetParams = {
+type CompanyReportFiscalPeriod = "FY" | "Q1" | "Q2" | "Q3";
+type CompanySelector = {
     ticker: string;
+    cik?: never;
+} | {
+    cik: string;
+    ticker?: never;
+};
+type FinancialStatementsGetParams = CompanySelector & ({
     fiscalYear: number;
     years?: never;
 } | {
-    ticker: string;
     years: number;
     fiscalYear?: never;
 } | {
-    ticker: string;
     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";
@@ -4696,9 +4692,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;
@@ -4706,15 +4700,10 @@ declare class CompanyReports {
     get({ accessionNumber, }: {
         accessionNumber: string;
     }): PromiseWithResponse<JsonResponse<"getSecCompanyReport">>;
-    getByFiscalYear({ ticker, fiscalYear, }: {
-        ticker: string;
-        fiscalYear: number;
-    }): PromiseWithResponse<JsonResponse<"getCompanyReport">>;
-    getByFiscalPeriod({ ticker, fiscalYear, fiscalPeriod, }: {
-        ticker: string;
+    getForPeriod({ ticker, cik, fiscalYear, fiscalPeriod }: CompanySelector & {
         fiscalYear: number;
         fiscalPeriod: CompanyReportFiscalPeriod;
-    }): PromiseWithResponse<JsonResponse<"getCompanyReportForFiscalPeriod">>;
+    }): PromiseWithResponse<JsonResponse<"getCompanyReportsForPeriod">>;
     getHtml({ accessionNumber, }: {
         accessionNumber: string;
     }): PromiseWithResponse<TextResponse<"getSecCompanyReportContent">>;
@@ -4722,7 +4711,7 @@ declare class CompanyReports {
 declare class FinancialStatements {
     private readonly transport;
     constructor(transport: HttpTransport);
-    get({ ticker, fiscalYear, years, }: FinancialStatementsGetParams): PromiseWithResponse<JsonResponse<"getCompanyFinancialStatements">>;
+    get({ ticker, cik, fiscalYear, years, }: FinancialStatementsGetParams): PromiseWithResponse<JsonResponse<"getCompanyFinancialStatements">>;
 }
 declare class InsiderTransactions {
     private readonly transport;
@@ -4890,4 +4879,4 @@ declare class APIError extends Error {
     constructor(message: string, options?: APIErrorOptions);
 }
 
-export { APIError, Chadwin, type ClientOptions, type CompanyReportFeedFilters, type CompanyReportFiscalPeriod, type CompanyReportForm, type FinancialStatementsGetParams, 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 };