@chadwin/sdk 0.7.0 → 0.8.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,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: {
@@ -1517,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;
@@ -1531,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: {
@@ -1567,13 +1523,19 @@ interface operations {
             };
         };
     };
-    getCompanyFinancialStatements: {
+    listCompanyInsiderTransactions: {
         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;
+            query: {
+                /** @description Opaque next_cursor from the preceding page. Keep the same filters and limit. */
+                cursor?: string;
+                /** @description Rows per page from 1 through 1000. Defaults to 1000. */
+                limit?: string;
+                /** @description Optional comma-separated SEC insider transaction codes to include. Supported codes: A, C, D, E, F, G, H, I, J, K, L, M, O, P, S, U, V, W, X, Z. Omitted or empty means all supported codes. */
+                transaction_codes?: string;
+                /** @description Required inclusive SEC filing-date lower bound in YYYY-MM-DD format. */
+                from: string;
+                /** @description Optional inclusive SEC filing-date upper bound in YYYY-MM-DD format. Defaults to the current date. */
+                until?: string;
             };
             header?: never;
             path: {
@@ -1584,7 +1546,7 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Published and reviewed normalized annual financial statements. */
+            /** @description Company insider transactions filed during the requested coverage window. */
             200: {
                 headers: {
                     "Cache-Control"?: string;
@@ -1596,193 +1558,27 @@ interface operations {
                 content: {
                     /**
                      * @example {
+                     *       "has_more": false,
                      *       "issuer": {
                      *         "cik": "0000320193",
                      *         "name": "Apple Inc.",
                      *         "ticker": "AAPL"
                      *       },
-                     *       "periods": [
+                     *       "next_cursor": null,
+                     *       "transactions": [
                      *         {
-                     *           "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. */
-            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 current company has the requested ticker. */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["FinancialStatementsCompanyNotFound"];
-                };
-            };
-            /** @description More than one current company has the ticker. */
-            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"];
-                };
-            };
-        };
-    };
-    listCompanyInsiderTransactions: {
-        parameters: {
-            query: {
-                /** @description Opaque next_cursor from the preceding page. Keep the same filters and limit. */
-                cursor?: string;
-                /** @description Rows per page from 1 through 1000. Defaults to 1000. */
-                limit?: string;
-                /** @description Optional comma-separated SEC insider transaction codes to include. Supported codes: A, C, D, E, F, G, H, I, J, K, L, M, O, P, S, U, V, W, X, Z. Omitted or empty means all supported codes. */
-                transaction_codes?: string;
-                /** @description Required inclusive SEC filing-date lower bound in YYYY-MM-DD format. */
-                from: string;
-                /** @description Optional inclusive SEC filing-date upper bound in YYYY-MM-DD format. Defaults to the current date. */
-                until?: string;
-            };
-            header?: never;
-            path: {
-                /** @description US listed company ticker */
-                ticker: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Company insider transactions filed during the requested coverage window. */
-            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 {
-                     *       "has_more": false,
-                     *       "issuer": {
-                     *         "cik": "0000320193",
-                     *         "name": "Apple Inc.",
-                     *         "ticker": "AAPL"
-                     *       },
-                     *       "next_cursor": null,
-                     *       "transactions": [
-                     *         {
-                     *           "accepted_at": "2026-05-29T22:30:27.000Z",
-                     *           "accession_number": "0001140361-26-023363",
-                     *           "acquired_disposed_code": "D",
-                     *           "conversion_or_exercise_price": null,
-                     *           "deemed_execution_date": null,
-                     *           "equity_swap_involved": false,
-                     *           "exercise_date": null,
-                     *           "expiration_date": null,
-                     *           "field_footnote_ids": {
-                     *             "price": [
-                     *               "F1"
-                     *             ]
+                     *           "accepted_at": "2026-05-29T22:30:27.000Z",
+                     *           "accession_number": "0001140361-26-023363",
+                     *           "acquired_disposed_code": "D",
+                     *           "conversion_or_exercise_price": null,
+                     *           "deemed_execution_date": null,
+                     *           "equity_swap_involved": false,
+                     *           "exercise_date": null,
+                     *           "expiration_date": null,
+                     *           "field_footnote_ids": {
+                     *             "price": [
+                     *               "F1"
+                     *             ]
                      *           },
                      *           "footnote_ids": [
                      *             "F1"
@@ -2041,8 +1837,245 @@ interface operations {
                     "application/json": components["schemas"]["DatasetNotEntitledErrorResponse"];
                 };
             };
-            /** @description The requested company was not found */
-            404: {
+            /** @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;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            /** @description More than one original quarterly report matches the fiscal period */
+            409: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -2065,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;
@@ -2076,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;
         };
@@ -2123,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;
@@ -2194,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;
@@ -2242,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;
@@ -2313,6 +2348,306 @@ 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?: {
@@ -4566,19 +4901,23 @@ interface operations {
 
 type CompanyReportForm = "10-K" | "10-Q" | "20-F" | "40-F";
 type CompanyReportFiscalPeriod = "Q1" | "Q2" | "Q3";
-type FinancialStatementsGetParams = {
+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 +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;
@@ -4722,7 +5059,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 +5227,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 };