{"openapi":"3.1.0","info":{"title":"drillr Public Data API","version":"2.0.0-spec.110","description":"REST endpoints over the same tables the drillr app runs on: fundamentals, filings, earnings, ownership, events, executives, analyst data and news for US, Japan and China equities. Every row derived from a disclosure links to the official filing. Generated from the Public Data API interface spec (revision 110, 2026-09-11). Read endpoints use GET query parameters; news search uses POST with a JSON body; every path below already carries the `/api/v2` prefix, so the server URL is the bare host. Authenticate with an `X-API-KEY` header; keys are created at https://drillr.ai/account/api-keys and every call is billed in credits (`x-credits`).","termsOfService":"https://drillr.ai/legal/terms","contact":{"name":"drillr developer support","url":"https://drillr.ai/docs","email":"support@lil-grebe.com"},"license":{"name":"drillr Terms of Service","url":"https://drillr.ai/legal/terms"},"x-logo":{"url":"https://drillr.ai/images/brand/logo_512_optimized.png","altText":"drillr"}},"externalDocs":{"description":"API reference","url":"https://drillr.ai/docs/api"},"servers":[{"url":"https://gateway.drillr.ai"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"Company","description":"Ticker resolution, natural-language company discovery and company profiles"},{"name":"Filings","description":"Regulatory filing lists and full-text filing search (US, Japan, China)"},{"name":"Signal","description":"Industry inflections, enterprise AI adoption and cross-source news search"},{"name":"Financials","description":"The three financial statements and precomputed financial metrics"},{"name":"Prices","description":"Historical bars and latest closing-price snapshots (US)"},{"name":"Earnings","description":"Earnings calendar and structured earnings-call summaries"},{"name":"Ownership","description":"Insider holdings and transactions, institutional holdings (US only)"},{"name":"Events","description":"Corporate events: financings, deals, executive changes, corporate actions, ownership (US only)"},{"name":"Analyst","description":"Analyst consensus and individual rating events (US only)"},{"name":"Executives","description":"Executive roster and annual compensation (US only)"},{"name":"Contract","description":"The machine-readable API contract itself"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY"}},"schemas":{"StatementCalculationNode":{"oneOf":[{"type":"object","properties":{"operation":{"const":"reported"},"metric":{"type":"string"},"value":{"type":"number"},"currency":{"type":["string","null"]},"period_start":{"type":["string","null"],"format":"date"},"report_period":{"type":["string","null"],"format":"date"},"available_at":{"type":["string","null"],"format":"date"},"accession_number":{"type":["string","null"]},"form_type":{"type":["string","null"]},"filing_url":{"type":"string","format":"uri"},"filing_date":{"type":["string","null"],"format":"date"}},"required":["operation","metric","value","currency","period_start","report_period","available_at","accession_number","form_type","filing_url","filing_date"],"additionalProperties":false},{"type":"object","properties":{"operation":{"type":"string","enum":["plus","minus","plus0","minus0","plus_minus","confirm_minus2","minus_same_vintage","col","col_if_null","subtract","annual_minus_three_quarters","same_end_balance","previous_end_cash","negative_absolute","negate"]},"metric":{"type":"string"},"value":{"type":"number"},"currency":{"type":["string","null"]},"period_start":{"type":["string","null"],"format":"date"},"report_period":{"type":["string","null"],"format":"date"},"available_at":{"type":["string","null"],"format":"date"},"inputs":{"type":"array","minItems":1,"maxItems":4,"items":{"anyOf":[{"$ref":"#/components/schemas/StatementCalculationNode"},{"type":"null"}]}}},"required":["operation","metric","value","currency","period_start","report_period","available_at","inputs"],"additionalProperties":false}]},"PublicDataError":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"]},"PublicTickersItem":{"type":"object","properties":{"ticker":{"type":"string"},"market":{"type":"string","enum":["US","CN","JP"]},"name":{"type":"string"},"exchange":{"type":"string"},"identifiers":{"type":"object","properties":{"isin":{"type":["string","null"]},"cik":{"type":["string","null"]},"cusip":{"type":["string","null"]}},"required":["isin","cik","cusip"],"additionalProperties":false}},"required":["ticker","market","name","exchange","identifiers"],"additionalProperties":false},"PublicCompanyDiscoveryItem":{"type":"object","properties":{"ticker":{"type":"string"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"reason":{"type":"string"}},"required":["ticker","company_name","reason"],"additionalProperties":false},"PublicCompanyProfileItem":{"type":"object","properties":{"ticker":{"type":"string"},"market":{"type":"string","enum":["US","CN","JP"]},"name":{"type":"string"},"name_local":{"anyOf":[{"type":"string"},{"type":"null"}]},"exchange":{"type":"string"},"country":{"type":"string"},"currency":{"type":"string"},"sector":{"type":"string"},"industry":{"type":"string"},"listing_date":{"type":"string","format":"date"},"website":{"type":"string"},"full_time_employees":{"type":"integer"},"identifiers":{"type":"object","properties":{"isin":{"type":["string","null"]},"cik":{"type":["string","null"]},"cusip":{"type":["string","null"]}},"required":["isin","cik","cusip"],"additionalProperties":false}},"required":["ticker","market","name","name_local","exchange","country","currency","sector","industry","listing_date","website","full_time_employees","identifiers"],"additionalProperties":false},"PublicFilingsItem":{"type":"object","properties":{"ticker":{"type":"string"},"market":{"type":"string","enum":["US","CN","JP"]},"form_type":{"type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"filing_date":{"type":"string","format":"date"},"period_of_report":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}]},"accession_number":{"type":"string"},"filing_url":{"type":"string","format":"uri"}},"required":["ticker","market","form_type","title","filing_date","period_of_report","accession_number","filing_url"],"additionalProperties":false},"PublicFilingSearchItem":{"type":"object","properties":{"ticker":{"type":"string"},"market":{"type":"string","enum":["US","CN","JP"]},"form_type":{"type":"string"},"filing_date":{"type":"string","format":"date"},"language":{"type":"string"},"section":{"type":"string"},"snippet":{"type":"string"},"score":{"type":"number"}},"required":["ticker","market","form_type","filing_date","language","section","snippet","score"],"additionalProperties":false},"PublicIndustryInflectionsItem":{"type":"object","properties":{"change_id":{"type":"string"},"quarter":{"type":"string"},"name":{"type":"string"},"regime_type":{"type":"string"},"impact_scope":{"type":"string"},"impact_degree":{"type":"integer"},"attention_verdict":{"type":"string"},"change_summary":{"type":"string"},"first_seen":{"type":"string","format":"date"},"source_tickers":{"type":"array","items":{"type":"string"}},"company_impacts":{"type":"array","items":{"type":"object","properties":{"ticker":{"type":"string"},"relation":{"type":"string","enum":["direct","indirect"]},"direction":{"type":"string","enum":["positive","negative","mixed","unclear"]},"magnitude":{"type":["integer","null"],"minimum":1,"maximum":3},"impact_stage":{"type":"string","enum":["realized","emerging","not_yet","unclear"]},"evidence_status":{"type":"string","enum":["confirmed","inferred"]},"affected_business":{"type":["string","null"]},"impact":{"type":"string"}},"required":["ticker","relation","direction","magnitude","impact_stage","evidence_status","affected_business","impact"],"additionalProperties":false}}},"required":["change_id","quarter","name","regime_type","impact_scope","impact_degree","attention_verdict","change_summary","first_seen","source_tickers","company_impacts"],"additionalProperties":false},"PublicEnterpriseAiAdoptionItem":{"type":"object","properties":{"deployment_id":{"type":"string"},"application_id":{"type":"string"},"ticker":{"type":"string"},"company_name":{"type":"string"},"application_name":{"type":"string"},"first_report_date":{"type":"string","format":"date"},"update_date":{"type":"string","format":"date"},"summary":{"type":"string"},"evolution_summary":{"type":"string"},"business_position":{"type":"string"},"deployment_stage":{"type":"string"},"deployment_scope":{"type":"string"},"value_type":{"type":"string"},"metrics":{"type":"array","items":{"type":"object","properties":{"metric_name":{"type":"string"},"value":{"type":"string"},"scope":{"type":"string"},"metric_role":{"type":"string"},"financial_metric":{"type":["string","null"]},"financial_attribution":{"type":["string","null"]},"evidence_id":{"type":"string"}},"required":["metric_name","value","scope","metric_role","financial_metric","financial_attribution","evidence_id"],"additionalProperties":false}},"evidence":{"type":"array","items":{"type":"object","properties":{"evidence_id":{"type":"string"},"quote":{"type":"string"},"speaker":{"type":["string","null"]},"section":{"type":["string","null"]}},"required":["evidence_id","quote","speaker","section"],"additionalProperties":false}}},"required":["deployment_id","application_id","ticker","company_name","application_name","first_report_date","update_date","summary","evolution_summary","business_position","deployment_stage","deployment_scope","value_type","metrics","evidence"],"additionalProperties":false},"PublicNewsSearchItem":{"type":"object","properties":{"query":{"type":["string","null"]},"theme":{"type":["string","null"]},"theme_resolved":{"anyOf":[{"type":"object","properties":{"id":{"type":["integer","null"]},"label":{"type":"string"},"sim":{"type":"number"},"matched":{"type":"boolean"}},"required":["id","label","sim","matched"],"additionalProperties":false},{"type":"null"}]},"ticker":{"type":"array","items":{"type":"string"}},"since":{"type":["string","null"],"format":"date-time"},"until":{"type":["string","null"],"format":"date-time"},"order_by":{"type":"string","enum":["relevance","event_time","create_time"]},"count":{"type":"integer"},"results":{"type":"array","items":{"type":"object","properties":{"story_id":{"type":"integer"},"title":{"type":"string"},"summary":{"type":"string"},"node_count":{"type":"integer"},"first_seen_at":{"type":"string","format":"date-time"},"last_seen_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"},"sim":{"type":"number"},"events_in_window":{"type":"integer"},"tags":{"type":"object","properties":{"version":{"type":"integer"},"primary_class":{"type":"string"},"event_types":{"type":"array","items":{"type":"string"}},"regions":{"type":"array","items":{"type":"string"}},"sectors_gics":{"type":"array","items":{"type":"string"}}},"required":["version","primary_class","event_types","regions","sectors_gics"],"additionalProperties":false},"events":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"time_event":{"type":"string","format":"date-time"},"summary":{"type":"string"},"event_type":{"type":"string"},"event_subtype":{"type":["string","null"]},"primary_entity_name":{"type":["string","null"]},"object_name":{"type":["string","null"]},"score":{"type":"number"},"sim":{"type":"number"},"sources_total":{"type":"integer"},"first_reported":{"type":"string","format":"date-time"},"last_reported":{"type":"string","format":"date-time"},"source":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"time":{"type":"string","format":"date-time"},"headline":{"type":["string","null"]}},"required":["name","url","time","headline"],"additionalProperties":false}},"required":["id","time_event","summary","event_type","event_subtype","primary_entity_name","object_name","score","sim","sources_total","first_reported","last_reported","source"],"additionalProperties":false}}},"required":["story_id","title","summary","node_count","first_seen_at","last_seen_at","created_at","sim","events_in_window","tags","events"],"additionalProperties":false}},"claims":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"time_event":{"type":"string","format":"date-time"},"claim_type":{"type":"string"},"claim_subtype":{"type":["string","null"]},"claimant_name":{"type":["string","null"]},"target_name":{"type":["string","null"]},"summary":{"type":"string"},"sources_total":{"type":"integer"},"first_reported":{"type":"string","format":"date-time"},"last_reported":{"type":"string","format":"date-time"},"source":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"time":{"type":"string","format":"date-time"},"headline":{"type":["string","null"]}},"required":["name","url","time","headline"],"additionalProperties":false}},"required":["id","time_event","claim_type","claim_subtype","claimant_name","target_name","summary","sources_total","first_reported","last_reported","source"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]},"claims_skipped":{"type":["string","null"]}},"required":["query","theme","theme_resolved","ticker","since","until","order_by","count","results","claims","next_cursor","claims_skipped"],"additionalProperties":false},"PublicIncomeStatementsItem":{"type":"object","properties":{"ticker":{"type":"string"},"market":{"type":"string","enum":["US","CN","JP"]},"fiscal_year":{"type":"integer"},"period":{"type":"string","enum":["FY","Q1","Q2","Q3","Q4"]},"period_start":{"type":"string","format":"date"},"report_period":{"type":"string","format":"date"},"currency":{"type":"string"},"accounting_standard":{"type":"string"},"accession_number":{"type":"string"},"form_type":{"type":"string"},"filing_url":{"type":"string","format":"uri"},"filing_date":{"type":"string","format":"date"},"derived_fields":{"type":"array","items":{"type":"string"}},"derivation":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/StatementCalculationNode"}},"revenue":{"type":"number"},"cost_of_revenue":{"type":"number"},"gross_profit":{"type":"number"},"research_and_development_expense":{"type":"number"},"selling_and_marketing_expense":{"anyOf":[{"type":"number"},{"type":"null"}]},"general_and_administrative_expense":{"type":"number"},"selling_general_and_administrative_expense":{"anyOf":[{"type":"number"},{"type":"null"}]},"taxes_and_surcharges":{"anyOf":[{"type":"number"},{"type":"null"}]},"operating_expenses":{"anyOf":[{"type":"number"},{"type":"null"}]},"operating_income":{"type":"number"},"interest_income":{"anyOf":[{"type":"number"},{"type":"null"}]},"interest_expense":{"anyOf":[{"type":"number"},{"type":"null"}]},"other_non_operating_income":{"anyOf":[{"type":"number"},{"type":"null"}]},"ordinary_income":{"anyOf":[{"type":"number"},{"type":"null"}]},"extraordinary_gains":{"anyOf":[{"type":"number"},{"type":"null"}]},"extraordinary_losses":{"anyOf":[{"type":"number"},{"type":"null"}]},"pretax_income":{"type":"number"},"income_tax_expense":{"type":"number"},"net_income":{"anyOf":[{"type":"number"},{"type":"null"}]},"net_income_attributable_to_parent":{"type":"number"},"net_income_attributable_to_noncontrolling_interests":{"anyOf":[{"type":"number"},{"type":"null"}]},"depreciation_and_amortization":{"anyOf":[{"type":"number"},{"type":"null"}]},"share_based_compensation":{"type":"number"},"eps_basic":{"anyOf":[{"type":"number"},{"type":"null"}]},"eps_diluted":{"anyOf":[{"type":"number"},{"type":"null"}]},"dividend_per_share":{"type":"number"},"weighted_average_shares_basic":{"type":"number"},"weighted_average_shares_diluted":{"anyOf":[{"type":"number"},{"type":"null"}]},"ebitda":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["ticker","market","fiscal_year","period","period_start","report_period","currency","accounting_standard","accession_number","form_type","filing_url","filing_date","derived_fields","derivation","revenue","cost_of_revenue","gross_profit","research_and_development_expense","selling_and_marketing_expense","general_and_administrative_expense","selling_general_and_administrative_expense","taxes_and_surcharges","operating_expenses","operating_income","interest_income","interest_expense","other_non_operating_income","ordinary_income","extraordinary_gains","extraordinary_losses","pretax_income","income_tax_expense","net_income","net_income_attributable_to_parent","net_income_attributable_to_noncontrolling_interests","depreciation_and_amortization","share_based_compensation","eps_basic","eps_diluted","dividend_per_share","weighted_average_shares_basic","weighted_average_shares_diluted","ebitda"],"additionalProperties":false},"PublicBalanceSheetsItem":{"type":"object","properties":{"ticker":{"type":"string"},"market":{"type":"string","enum":["US","CN","JP"]},"fiscal_year":{"type":"integer"},"period":{"type":"string","enum":["FY","Q1","Q2","Q3","Q4"]},"period_start":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}]},"report_period":{"type":"string","format":"date"},"currency":{"type":"string"},"accounting_standard":{"type":"string"},"accession_number":{"type":"string"},"form_type":{"type":"string"},"filing_url":{"type":"string","format":"uri"},"filing_date":{"type":"string","format":"date"},"derived_fields":{"type":"array","items":{"type":"string"}},"derivation":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/StatementCalculationNode"}},"cash_and_cash_equivalents":{"type":"number"},"short_term_investments":{"type":"number"},"accounts_receivable":{"anyOf":[{"type":"number"},{"type":"null"}]},"inventories":{"type":"number"},"prepaid_expenses":{"anyOf":[{"type":"number"},{"type":"null"}]},"other_current_assets":{"anyOf":[{"type":"number"},{"type":"null"}]},"current_assets":{"type":"number"},"property_plant_equipment":{"anyOf":[{"type":"number"},{"type":"null"}]},"right_of_use_assets":{"type":"number"},"goodwill":{"anyOf":[{"type":"number"},{"type":"null"}]},"intangible_assets":{"type":"number"},"long_term_investments":{"anyOf":[{"type":"number"},{"type":"null"}]},"deferred_tax_assets":{"anyOf":[{"type":"number"},{"type":"null"}]},"other_non_current_assets":{"type":"number"},"non_current_assets":{"anyOf":[{"type":"number"},{"type":"null"}]},"total_assets":{"type":"number"},"accounts_payable":{"type":"number"},"short_term_debt":{"anyOf":[{"type":"number"},{"type":"null"}]},"current_portion_of_long_term_debt":{"anyOf":[{"type":"number"},{"type":"null"}]},"employee_compensation_payable":{"anyOf":[{"type":"number"},{"type":"null"}]},"income_taxes_payable":{"type":"number"},"accrued_liabilities":{"anyOf":[{"type":"number"},{"type":"null"}]},"deferred_revenue":{"anyOf":[{"type":"number"},{"type":"null"}]},"other_current_liabilities":{"anyOf":[{"type":"number"},{"type":"null"}]},"current_liabilities":{"type":"number"},"long_term_debt":{"anyOf":[{"type":"number"},{"type":"null"}]},"lease_liabilities":{"type":"number"},"deferred_tax_liabilities":{"type":"number"},"other_non_current_liabilities":{"anyOf":[{"type":"number"},{"type":"null"}]},"non_current_liabilities":{"anyOf":[{"type":"number"},{"type":"null"}]},"total_liabilities":{"type":"number"},"common_stock":{"type":"number"},"additional_paid_in_capital":{"anyOf":[{"type":"number"},{"type":"null"}]},"retained_earnings":{"type":"number"},"treasury_stock":{"anyOf":[{"type":"number"},{"type":"null"}]},"accumulated_other_comprehensive_income":{"anyOf":[{"type":"number"},{"type":"null"}]},"equity_attributable_to_parent":{"type":"number"},"noncontrolling_interests":{"anyOf":[{"type":"number"},{"type":"null"}]},"total_equity":{"type":"number"},"temporary_equity":{"anyOf":[{"type":"number"},{"type":"null"}]},"total_debt":{"anyOf":[{"type":"number"},{"type":"null"}]},"net_debt":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["ticker","market","fiscal_year","period","period_start","report_period","currency","accounting_standard","accession_number","form_type","filing_url","filing_date","derived_fields","derivation","cash_and_cash_equivalents","short_term_investments","accounts_receivable","inventories","prepaid_expenses","other_current_assets","current_assets","property_plant_equipment","right_of_use_assets","goodwill","intangible_assets","long_term_investments","deferred_tax_assets","other_non_current_assets","non_current_assets","total_assets","accounts_payable","short_term_debt","current_portion_of_long_term_debt","employee_compensation_payable","income_taxes_payable","accrued_liabilities","deferred_revenue","other_current_liabilities","current_liabilities","long_term_debt","lease_liabilities","deferred_tax_liabilities","other_non_current_liabilities","non_current_liabilities","total_liabilities","common_stock","additional_paid_in_capital","retained_earnings","treasury_stock","accumulated_other_comprehensive_income","equity_attributable_to_parent","noncontrolling_interests","total_equity","temporary_equity","total_debt","net_debt"],"additionalProperties":false},"PublicCashFlowStatementsItem":{"type":"object","properties":{"ticker":{"type":"string"},"market":{"type":"string","enum":["US","CN","JP"]},"fiscal_year":{"type":"integer"},"period":{"type":"string","enum":["FY","Q1","Q2","Q3","Q4"]},"period_start":{"type":"string","format":"date"},"report_period":{"type":"string","format":"date"},"currency":{"type":"string"},"accounting_standard":{"type":"string"},"accession_number":{"type":"string"},"form_type":{"type":"string"},"filing_url":{"type":"string","format":"uri"},"filing_date":{"type":"string","format":"date"},"derived_fields":{"type":"array","items":{"type":"string"}},"derivation":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/StatementCalculationNode"}},"operating_cash_flow":{"type":"number"},"change_in_working_capital":{"anyOf":[{"type":"number"},{"type":"null"}]},"capital_expenditures":{"anyOf":[{"type":"number"},{"type":"null"}]},"acquisitions_net":{"anyOf":[{"type":"number"},{"type":"null"}]},"purchases_of_investments":{"anyOf":[{"type":"number"},{"type":"null"}]},"proceeds_from_investments":{"anyOf":[{"type":"number"},{"type":"null"}]},"investing_cash_flow":{"type":"number"},"share_repurchases":{"anyOf":[{"type":"number"},{"type":"null"}]},"dividends_paid":{"type":"number"},"financing_cash_flow":{"type":"number"},"effect_of_exchange_rate_on_cash":{"anyOf":[{"type":"number"},{"type":"null"}]},"net_change_in_cash":{"type":"number"},"cash_at_end_of_period":{"type":"number"},"income_taxes_paid":{"type":"number"},"interest_paid":{"anyOf":[{"type":"number"},{"type":"null"}]},"free_cash_flow":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["ticker","market","fiscal_year","period","period_start","report_period","currency","accounting_standard","accession_number","form_type","filing_url","filing_date","derived_fields","derivation","operating_cash_flow","change_in_working_capital","capital_expenditures","acquisitions_net","purchases_of_investments","proceeds_from_investments","investing_cash_flow","share_repurchases","dividends_paid","financing_cash_flow","effect_of_exchange_rate_on_cash","net_change_in_cash","cash_at_end_of_period","income_taxes_paid","interest_paid","free_cash_flow"],"additionalProperties":false},"PublicFinancialMetricsSnapshotItem":{"type":"object","properties":{"ticker":{"type":"string"},"market":{"type":"string","enum":["US","CN","JP"]},"currency":{"type":"string"},"shares_outstanding":{"type":"number"},"market_capitalization":{"type":"number"},"market_capitalization_usd":{"type":"number"},"enterprise_value":{"type":"number"},"pe_ratio_ttm":{"type":"number"},"peg_ratio_ttm":{"type":"number"},"pb_ratio_ttm":{"type":"number"},"ps_ratio_ttm":{"type":"number"},"pcf_ratio_ttm":{"type":"number"},"ev_to_sales_ttm":{"type":"number"},"ev_to_ebitda_ttm":{"type":"number"},"ev_to_ebit_ttm":{"type":"number"},"gross_profit_margin_ttm":{"type":"number"},"ebitda_margin_ttm":{"type":"number"},"net_income_margin_ttm":{"type":"number"},"fcf_margin_ttm":{"type":"number"},"roe_ttm":{"type":"number"},"roa_ttm":{"type":"number"},"roic_ttm":{"type":"number"},"revenue_growth_ttm":{"type":"number"},"eps_growth_ttm":{"type":"number"},"fcf_growth_ttm":{"type":"number"},"revenue_cagr_3y":{"type":"number"},"eps_cagr_3y":{"type":"number"},"dividend_yield_ttm":{"type":"number"},"payout_ratio_ttm":{"type":"number"},"dividend_growth_1y":{"type":"number"},"consecutive_dividend_years":{"type":"number"},"debt_to_equity":{"type":"number"},"net_debt_to_equity":{"type":"number"},"debt_to_assets":{"type":"number"},"debt_to_ebitda":{"type":"number"},"net_debt_to_ebitda":{"type":"number"},"interest_coverage":{"type":"number"},"ebitda_to_interest":{"type":"number"},"current_ratio":{"type":"number"},"quick_ratio":{"type":"number"},"cash_ratio":{"type":"number"},"working_capital":{"type":"number"},"operating_cash_flow_ratio":{"type":"number"},"fcf_to_debt":{"type":"number"},"ocf_to_debt":{"type":"number"},"ebit_margin_ttm":{"type":"number"},"capex_to_sales_ttm":{"type":"number"},"asset_turnover_ttm":{"type":"number"},"cash_per_share_ttm":{"type":"number"},"ebitda_growth_ttm":{"type":"number"},"ebit_growth_ttm":{"type":"number"},"ocf_growth_ttm":{"type":"number"},"ebitda_cagr_3y":{"type":"number"},"ebit_cagr_3y":{"type":"number"},"net_income_cagr_3y":{"type":"number"},"fcf_cagr_3y":{"type":"number"},"book_value_cagr_3y":{"type":"number"},"total_assets_cagr_3y":{"type":"number"},"dividend_rate_ttm":{"type":"number"},"fcf_payout_ratio_ttm":{"type":"number"},"dividend_cagr_3y":{"type":"number"},"dividend_frequency":{"type":"string"},"price_date":{"type":"string","format":"date"},"statement_period_end":{"type":"string"},"statement_period":{"type":"string"}},"required":["ticker","market","currency","shares_outstanding","market_capitalization","market_capitalization_usd","enterprise_value","pe_ratio_ttm","peg_ratio_ttm","pb_ratio_ttm","ps_ratio_ttm","pcf_ratio_ttm","ev_to_sales_ttm","ev_to_ebitda_ttm","ev_to_ebit_ttm","gross_profit_margin_ttm","ebitda_margin_ttm","net_income_margin_ttm","fcf_margin_ttm","roe_ttm","roa_ttm","roic_ttm","revenue_growth_ttm","eps_growth_ttm","fcf_growth_ttm","revenue_cagr_3y","eps_cagr_3y","dividend_yield_ttm","payout_ratio_ttm","dividend_growth_1y","consecutive_dividend_years","debt_to_equity","net_debt_to_equity","debt_to_assets","debt_to_ebitda","net_debt_to_ebitda","interest_coverage","ebitda_to_interest","current_ratio","quick_ratio","cash_ratio","working_capital","operating_cash_flow_ratio","fcf_to_debt","ocf_to_debt","ebit_margin_ttm","capex_to_sales_ttm","asset_turnover_ttm","cash_per_share_ttm","ebitda_growth_ttm","ebit_growth_ttm","ocf_growth_ttm","ebitda_cagr_3y","ebit_cagr_3y","net_income_cagr_3y","fcf_cagr_3y","book_value_cagr_3y","total_assets_cagr_3y","dividend_rate_ttm","fcf_payout_ratio_ttm","dividend_cagr_3y","dividend_frequency","price_date","statement_period_end","statement_period"],"additionalProperties":false},"PublicPricesHistoricalItem":{"type":"object","properties":{"ticker":{"type":"string"},"date":{"type":"string","format":"date"},"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"}},"required":["ticker","date","open","high","low","close"],"additionalProperties":false},"PublicPricesSnapshotItem":{"type":"object","properties":{"ticker":{"type":"string"},"date":{"type":"string","format":"date"},"price":{"type":"number"}},"required":["ticker","date","price"],"additionalProperties":false},"PublicEarningsCalendarItem":{"type":"object","properties":{"ticker":{"type":"string"},"date":{"type":"string","format":"date"},"eps_actual":{"type":"number"},"eps_estimated":{"type":"number"},"revenue_actual":{"type":"number"},"revenue_estimated":{"type":"number"},"last_updated":{"type":"string","format":"date"}},"required":["ticker","date","eps_actual","eps_estimated","revenue_actual","revenue_estimated","last_updated"],"additionalProperties":false},"PublicEarningsCallSummaryItem":{"type":"object","properties":{"ticker":{"type":"string"},"fiscal_year":{"type":"integer"},"period":{"type":"string","enum":["Q1","Q2","Q3","Q4","FY"]},"date":{"type":"string","format":"date"},"title":{"type":"string"},"management_highlights":{"type":"string"},"guidance":{"type":"string"},"risks":{"type":"string"},"segment_performance":{"type":"string"},"qa_topics":{"type":"string"}},"required":["ticker","fiscal_year","period","date","title","management_highlights","guidance","risks","segment_performance","qa_topics"],"additionalProperties":false},"PublicInsiderTradesItem":{"type":"object","properties":{"ticker":{"type":"string"},"insider_name":{"type":"string"},"insider_title":{"type":"string"},"is_director":{"type":"boolean"},"is_officer":{"type":"boolean"},"record_type":{"type":"string","enum":["initial_holding","transaction"]},"transaction_type":{"type":"string","enum":["buy","sell","award","exercise","tax_withholding","other"]},"transaction_code":{"type":"string"},"transaction_date":{"type":"string","format":"date"},"security_title":{"type":"string"},"ownership_type":{"type":"string"},"shares":{"type":"number"},"price_per_share":{"type":"number"},"total_value":{"type":"number"},"shares_owned_after":{"type":"number"},"form_type":{"type":"string","enum":["3","3/A","4","4/A","5","5/A"]},"is_amendment":{"type":"boolean"},"original_filing_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}]},"accession_number":{"type":"string"},"filing_url":{"type":"string","format":"uri"},"filing_date":{"type":"string","format":"date"}},"required":["ticker","insider_name","insider_title","is_director","is_officer","record_type","transaction_type","transaction_code","transaction_date","security_title","ownership_type","shares","price_per_share","total_value","shares_owned_after","form_type","is_amendment","original_filing_date","accession_number","filing_url","filing_date"],"additionalProperties":false},"PublicInstitutionalHoldingsItem":{"type":"object","properties":{"ticker":{"anyOf":[{"type":"string"},{"type":"null"}]},"investor_name":{"type":"string"},"investor_cik":{"type":"string"},"report_period":{"type":"string","format":"date"},"shares":{"type":"number"},"market_value":{"type":"number"},"change_in_shares":{"type":"number"},"accession_number":{"type":"string"},"form_type":{"type":"string"},"filing_url":{"type":"string","format":"uri"},"filing_date":{"type":"string","format":"date"}},"required":["ticker","investor_name","investor_cik","report_period","shares","market_value","change_in_shares","accession_number","form_type","filing_url","filing_date"],"additionalProperties":false},"PublicEventsItem":{"type":"object","properties":{"event_id":{"type":"string"},"ticker":{"type":"string"},"market":{"type":"string","enum":["US"]},"event_class":{"type":"string","enum":["capital","distribution","share_structure","transaction","agreement","governance","ownership","legal_regulatory"]},"event_type":{"type":"string","enum":["equity_issuance","debt_issuance","convertible","guarantee","debt_default","dividend","buyback","capital_reduction","stock_split","reverse_split","bonus_issue","share_class_change","acquisition","disposal","merger","spin_off","joint_venture","strategic_investment","restructuring","license","supply","partnership","major_contract","settlement","executive_change","director_change","auditor_change","equity_incentive","stake_change","delisting","bankruptcy"]},"axis":{"type":"object","properties":{"instrument":{"type":"string","enum":["public_offering","private_placement","rights_issue","pipe","atm","bond","note","term_loan","revolver","loan","cb","bw","exchangeable","convertible_preferred"]},"action":{"type":"string","enum":["new","amend","drawdown","repay","cancel","release","announce","execute","cancel_shares","appointment","departure","role_change","pledge","supplement","freeze","unfreeze","initiate","raise","lower","withdraw","halt","resume"]},"subtype":{"type":"string","enum":["regular","special","interim","in_kind","dual_class_setup","full_circulation","par_value_change","rights_amendment","business_restructuring","internal_reorg","investigation","penalty","warning","rectification","risk_warning","forced","voluntary","petition","reorganization","liquidation","receivership"]},"source":{"type":"string","enum":["retained_earnings","capital_reserve"]},"consideration_type":{"type":"string","enum":["all_cash","all_stock","mixed","debt_assumption","nil"]},"structure":{"type":"string","enum":["share_deal","asset_deal","tender_offer","scheme_of_arrangement"]},"mechanism":{"type":"string","enum":["equity_transfer","inheritance","concert_agreement","other"]},"role_type":{"type":"string","enum":["ceo","cfo","coo","chair","director","other"]},"reason":{"type":"string","enum":["resignation","retirement","termination","death","other"]},"direction":{"type":"string","enum":["increase","decrease","down","up"]},"intent":{"type":"string","enum":["active","passive"]},"share_source":{"type":"string","enum":["ipo","private_placement","equity_incentive"]},"party_role":{"type":"string","enum":["plaintiff","defendant","other"]},"proceeding":{"type":"string","enum":["civil","criminal","arbitration"]}},"additionalProperties":false},"source_category":{"type":"string"},"event_date":{"type":"string","format":"date"},"title":{"type":"string"},"stage":{"type":"string","enum":["announced","approved","amended","completed","terminated"]},"event_group_id":{"type":"string"},"is_current":{"type":"boolean"},"accession_number":{"type":"string"},"form_type":{"type":"string"},"filing_url":{"type":"string","format":"uri"},"filing_date":{"type":"string","format":"date"}},"required":["event_id","ticker","market","event_class","event_type","axis","source_category","event_date","title","stage","event_group_id","is_current","accession_number","form_type","filing_url","filing_date"],"additionalProperties":false},"PublicEventsFinancingsItem":{"type":"object","properties":{"event_id":{"type":"string"},"ticker":{"type":"string"},"market":{"type":"string","enum":["US"]},"event_class":{"type":"string","enum":["capital"]},"event_type":{"type":"string","enum":["equity_issuance","debt_issuance","convertible","guarantee","debt_default"]},"axis":{"type":"object","properties":{"instrument":{"type":"string","enum":["public_offering","private_placement","rights_issue","pipe","atm","bond","note","term_loan","revolver","loan","cb","bw","exchangeable","convertible_preferred"]},"action":{"type":"string","enum":["new","amend","drawdown","repay","cancel","release","announce","execute","cancel_shares","appointment","departure","role_change","pledge","supplement","freeze","unfreeze","initiate","raise","lower","withdraw","halt","resume"]},"subtype":{"type":"string","enum":["regular","special","interim","in_kind","dual_class_setup","full_circulation","par_value_change","rights_amendment","business_restructuring","internal_reorg","investigation","penalty","warning","rectification","risk_warning","forced","voluntary","petition","reorganization","liquidation","receivership"]},"source":{"type":"string","enum":["retained_earnings","capital_reserve"]},"consideration_type":{"type":"string","enum":["all_cash","all_stock","mixed","debt_assumption","nil"]},"structure":{"type":"string","enum":["share_deal","asset_deal","tender_offer","scheme_of_arrangement"]},"mechanism":{"type":"string","enum":["equity_transfer","inheritance","concert_agreement","other"]},"role_type":{"type":"string","enum":["ceo","cfo","coo","chair","director","other"]},"reason":{"type":"string","enum":["resignation","retirement","termination","death","other"]},"direction":{"type":"string","enum":["increase","decrease","down","up"]},"intent":{"type":"string","enum":["active","passive"]},"share_source":{"type":"string","enum":["ipo","private_placement","equity_incentive"]},"party_role":{"type":"string","enum":["plaintiff","defendant","other"]},"proceeding":{"type":"string","enum":["civil","criminal","arbitration"]}},"additionalProperties":false},"source_category":{"type":"string"},"event_date":{"type":"string","format":"date"},"title":{"type":"string"},"stage":{"type":"string","enum":["announced","approved","amended","completed","terminated"]},"event_group_id":{"type":"string"},"is_current":{"type":"boolean"},"accession_number":{"type":"string"},"form_type":{"type":"string"},"filing_url":{"type":"string","format":"uri"},"filing_date":{"type":"string","format":"date"},"instrument":{"anyOf":[{"type":"string"},{"type":"null"}]},"action":{"anyOf":[{"type":"string"},{"type":"null"}]},"amount":{"anyOf":[{"type":"number"},{"type":"null"}]},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"counterparty_names":{"type":"array","items":{"type":"string"}},"use_of_proceeds":{"anyOf":[{"type":"string"},{"type":"null"}]},"closing_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}]},"interest_rate":{"anyOf":[{"type":"number"},{"type":"null"}]},"maturity_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}]},"is_secured":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"covenants":{"type":"array","items":{"type":"string"}},"shares":{"anyOf":[{"type":"number"},{"type":"null"}]},"price_per_share":{"anyOf":[{"type":"number"},{"type":"null"}]},"discount_pct":{"anyOf":[{"type":"number"},{"type":"null"}]},"exemption":{"anyOf":[{"type":"string"},{"type":"null"}]},"registration_rights":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"lock_up_period":{"anyOf":[{"type":"string"},{"type":"null"}]},"conversion_price":{"anyOf":[{"type":"number"},{"type":"null"}]},"conversion_ratio":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["event_id","ticker","market","event_class","event_type","axis","source_category","event_date","title","stage","event_group_id","is_current","accession_number","form_type","filing_url","filing_date","instrument","action","amount","currency","counterparty_names","use_of_proceeds","closing_date","interest_rate","maturity_date","is_secured","covenants","shares","price_per_share","discount_pct","exemption","registration_rights","lock_up_period","conversion_price","conversion_ratio"],"additionalProperties":false},"PublicEventsDealsItem":{"type":"object","properties":{"event_id":{"type":"string"},"ticker":{"type":"string"},"market":{"type":"string","enum":["US"]},"event_class":{"type":"string","enum":["transaction","agreement"]},"event_type":{"type":"string","enum":["acquisition","disposal","merger","spin_off","joint_venture","strategic_investment","restructuring","license","supply","partnership","major_contract","settlement"]},"axis":{"type":"object","properties":{"instrument":{"type":"string","enum":["public_offering","private_placement","rights_issue","pipe","atm","bond","note","term_loan","revolver","loan","cb","bw","exchangeable","convertible_preferred"]},"action":{"type":"string","enum":["new","amend","drawdown","repay","cancel","release","announce","execute","cancel_shares","appointment","departure","role_change","pledge","supplement","freeze","unfreeze","initiate","raise","lower","withdraw","halt","resume"]},"subtype":{"type":"string","enum":["regular","special","interim","in_kind","dual_class_setup","full_circulation","par_value_change","rights_amendment","business_restructuring","internal_reorg","investigation","penalty","warning","rectification","risk_warning","forced","voluntary","petition","reorganization","liquidation","receivership"]},"source":{"type":"string","enum":["retained_earnings","capital_reserve"]},"consideration_type":{"type":"string","enum":["all_cash","all_stock","mixed","debt_assumption","nil"]},"structure":{"type":"string","enum":["share_deal","asset_deal","tender_offer","scheme_of_arrangement"]},"mechanism":{"type":"string","enum":["equity_transfer","inheritance","concert_agreement","other"]},"role_type":{"type":"string","enum":["ceo","cfo","coo","chair","director","other"]},"reason":{"type":"string","enum":["resignation","retirement","termination","death","other"]},"direction":{"type":"string","enum":["increase","decrease","down","up"]},"intent":{"type":"string","enum":["active","passive"]},"share_source":{"type":"string","enum":["ipo","private_placement","equity_incentive"]},"party_role":{"type":"string","enum":["plaintiff","defendant","other"]},"proceeding":{"type":"string","enum":["civil","criminal","arbitration"]}},"additionalProperties":false},"source_category":{"type":"string"},"event_date":{"type":"string","format":"date"},"title":{"type":"string"},"stage":{"type":"string","enum":["announced","approved","amended","completed","terminated"]},"event_group_id":{"type":"string"},"is_current":{"type":"boolean"},"accession_number":{"type":"string"},"form_type":{"type":"string"},"filing_url":{"type":"string","format":"uri"},"filing_date":{"type":"string","format":"date"},"deal_domain":{"type":"string"},"direction":{"anyOf":[{"type":"string"},{"type":"null"}]},"filer_role":{"anyOf":[{"type":"string"},{"type":"null"}]},"counterparty_names":{"type":"array","items":{"type":"string"}},"counterparty_tickers":{"type":"array","items":{"type":"string"}},"deal_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"deal_value":{"anyOf":[{"type":"number"},{"type":"null"}]},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"consideration_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"structure":{"anyOf":[{"type":"string"},{"type":"null"}]},"stake_pct":{"anyOf":[{"type":"number"},{"type":"null"}]},"price_per_share":{"anyOf":[{"type":"number"},{"type":"null"}]},"premium_pct":{"anyOf":[{"type":"number"},{"type":"null"}]},"termination_fee":{"anyOf":[{"type":"number"},{"type":"null"}]},"expected_close_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}]},"conditions":{"type":"array","items":{"type":"string"}},"termination_reason":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["event_id","ticker","market","event_class","event_type","axis","source_category","event_date","title","stage","event_group_id","is_current","accession_number","form_type","filing_url","filing_date","deal_domain","direction","filer_role","counterparty_names","counterparty_tickers","deal_name","deal_value","currency","consideration_type","structure","stake_pct","price_per_share","premium_pct","termination_fee","expected_close_date","conditions","termination_reason"],"additionalProperties":false},"PublicEventsExecutiveChangesItem":{"type":"object","properties":{"event_id":{"type":"string"},"ticker":{"type":"string"},"market":{"type":"string","enum":["US"]},"event_class":{"type":"string","enum":["governance"]},"event_type":{"type":"string","enum":["executive_change","director_change","auditor_change"]},"axis":{"type":"object","properties":{"instrument":{"type":"string","enum":["public_offering","private_placement","rights_issue","pipe","atm","bond","note","term_loan","revolver","loan","cb","bw","exchangeable","convertible_preferred"]},"action":{"type":"string","enum":["new","amend","drawdown","repay","cancel","release","announce","execute","cancel_shares","appointment","departure","role_change","pledge","supplement","freeze","unfreeze","initiate","raise","lower","withdraw","halt","resume"]},"subtype":{"type":"string","enum":["regular","special","interim","in_kind","dual_class_setup","full_circulation","par_value_change","rights_amendment","business_restructuring","internal_reorg","investigation","penalty","warning","rectification","risk_warning","forced","voluntary","petition","reorganization","liquidation","receivership"]},"source":{"type":"string","enum":["retained_earnings","capital_reserve"]},"consideration_type":{"type":"string","enum":["all_cash","all_stock","mixed","debt_assumption","nil"]},"structure":{"type":"string","enum":["share_deal","asset_deal","tender_offer","scheme_of_arrangement"]},"mechanism":{"type":"string","enum":["equity_transfer","inheritance","concert_agreement","other"]},"role_type":{"type":"string","enum":["ceo","cfo","coo","chair","director","other"]},"reason":{"type":"string","enum":["resignation","retirement","termination","death","other"]},"direction":{"type":"string","enum":["increase","decrease","down","up"]},"intent":{"type":"string","enum":["active","passive"]},"share_source":{"type":"string","enum":["ipo","private_placement","equity_incentive"]},"party_role":{"type":"string","enum":["plaintiff","defendant","other"]},"proceeding":{"type":"string","enum":["civil","criminal","arbitration"]}},"additionalProperties":false},"source_category":{"type":"string"},"event_date":{"type":"string","format":"date"},"title":{"type":"string"},"stage":{"type":"string","enum":["announced","approved","amended","completed","terminated"]},"event_group_id":{"type":"string"},"is_current":{"type":"boolean"},"accession_number":{"type":"string"},"form_type":{"type":"string"},"filing_url":{"type":"string","format":"uri"},"filing_date":{"type":"string","format":"date"},"person_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"role":{"anyOf":[{"type":"string"},{"type":"null"}]},"role_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"action":{"anyOf":[{"type":"string"},{"type":"null"}]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"effective_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}]},"successor_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_interim":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"required":["event_id","ticker","market","event_class","event_type","axis","source_category","event_date","title","stage","event_group_id","is_current","accession_number","form_type","filing_url","filing_date","person_name","role","role_type","action","reason","effective_date","successor_name","is_interim"],"additionalProperties":false},"PublicEventsCorporateActionsItem":{"type":"object","properties":{"event_id":{"type":"string"},"ticker":{"type":"string"},"market":{"type":"string","enum":["US"]},"event_class":{"type":"string","enum":["distribution","share_structure"]},"event_type":{"type":"string","enum":["dividend","buyback","capital_reduction","stock_split","reverse_split","bonus_issue","share_class_change"]},"axis":{"type":"object","properties":{"instrument":{"type":"string","enum":["public_offering","private_placement","rights_issue","pipe","atm","bond","note","term_loan","revolver","loan","cb","bw","exchangeable","convertible_preferred"]},"action":{"type":"string","enum":["new","amend","drawdown","repay","cancel","release","announce","execute","cancel_shares","appointment","departure","role_change","pledge","supplement","freeze","unfreeze","initiate","raise","lower","withdraw","halt","resume"]},"subtype":{"type":"string","enum":["regular","special","interim","in_kind","dual_class_setup","full_circulation","par_value_change","rights_amendment","business_restructuring","internal_reorg","investigation","penalty","warning","rectification","risk_warning","forced","voluntary","petition","reorganization","liquidation","receivership"]},"source":{"type":"string","enum":["retained_earnings","capital_reserve"]},"consideration_type":{"type":"string","enum":["all_cash","all_stock","mixed","debt_assumption","nil"]},"structure":{"type":"string","enum":["share_deal","asset_deal","tender_offer","scheme_of_arrangement"]},"mechanism":{"type":"string","enum":["equity_transfer","inheritance","concert_agreement","other"]},"role_type":{"type":"string","enum":["ceo","cfo","coo","chair","director","other"]},"reason":{"type":"string","enum":["resignation","retirement","termination","death","other"]},"direction":{"type":"string","enum":["increase","decrease","down","up"]},"intent":{"type":"string","enum":["active","passive"]},"share_source":{"type":"string","enum":["ipo","private_placement","equity_incentive"]},"party_role":{"type":"string","enum":["plaintiff","defendant","other"]},"proceeding":{"type":"string","enum":["civil","criminal","arbitration"]}},"additionalProperties":false},"source_category":{"type":"string"},"event_date":{"type":"string","format":"date"},"title":{"type":"string"},"stage":{"type":"string","enum":["announced","approved","amended","completed","terminated"]},"event_group_id":{"type":"string"},"is_current":{"type":"boolean"},"accession_number":{"type":"string"},"form_type":{"type":"string"},"filing_url":{"type":"string","format":"uri"},"filing_date":{"type":"string","format":"date"},"subtype":{"anyOf":[{"type":"string"},{"type":"null"}]},"ex_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}]},"record_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}]},"pay_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}]},"amount_per_share":{"anyOf":[{"type":"number"},{"type":"null"}]},"currency":{"anyOf":[{"type":"string"},{"type":"null"}]},"ratio":{"anyOf":[{"type":"number"},{"type":"null"}]},"shares_affected":{"anyOf":[{"type":"number"},{"type":"null"}]},"amount_total":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["event_id","ticker","market","event_class","event_type","axis","source_category","event_date","title","stage","event_group_id","is_current","accession_number","form_type","filing_url","filing_date","subtype","ex_date","record_date","pay_date","amount_per_share","currency","ratio","shares_affected","amount_total"],"additionalProperties":false},"PublicEventsOwnershipItem":{"type":"object","properties":{"event_id":{"type":"string"},"ticker":{"type":"string"},"market":{"type":"string","enum":["US"]},"event_class":{"type":"string","enum":["ownership"]},"event_type":{"type":"string","enum":["stake_change"]},"axis":{"type":"object","properties":{"instrument":{"type":"string","enum":["public_offering","private_placement","rights_issue","pipe","atm","bond","note","term_loan","revolver","loan","cb","bw","exchangeable","convertible_preferred"]},"action":{"type":"string","enum":["new","amend","drawdown","repay","cancel","release","announce","execute","cancel_shares","appointment","departure","role_change","pledge","supplement","freeze","unfreeze","initiate","raise","lower","withdraw","halt","resume"]},"subtype":{"type":"string","enum":["regular","special","interim","in_kind","dual_class_setup","full_circulation","par_value_change","rights_amendment","business_restructuring","internal_reorg","investigation","penalty","warning","rectification","risk_warning","forced","voluntary","petition","reorganization","liquidation","receivership"]},"source":{"type":"string","enum":["retained_earnings","capital_reserve"]},"consideration_type":{"type":"string","enum":["all_cash","all_stock","mixed","debt_assumption","nil"]},"structure":{"type":"string","enum":["share_deal","asset_deal","tender_offer","scheme_of_arrangement"]},"mechanism":{"type":"string","enum":["equity_transfer","inheritance","concert_agreement","other"]},"role_type":{"type":"string","enum":["ceo","cfo","coo","chair","director","other"]},"reason":{"type":"string","enum":["resignation","retirement","termination","death","other"]},"direction":{"type":"string","enum":["increase","decrease","down","up"]},"intent":{"type":"string","enum":["active","passive"]},"share_source":{"type":"string","enum":["ipo","private_placement","equity_incentive"]},"party_role":{"type":"string","enum":["plaintiff","defendant","other"]},"proceeding":{"type":"string","enum":["civil","criminal","arbitration"]}},"additionalProperties":false},"source_category":{"type":"string"},"event_date":{"type":"string","format":"date"},"title":{"type":"string"},"stage":{"type":"string","enum":["completed","amended"]},"event_group_id":{"type":"string"},"is_current":{"type":"boolean"},"accession_number":{"type":"string"},"form_type":{"type":"string"},"filing_url":{"type":"string","format":"uri"},"filing_date":{"type":"string","format":"date"},"holder_name":{"type":"string"},"pct_before":{"anyOf":[{"type":"number"},{"type":"null"}]},"pct_after":{"anyOf":[{"type":"number"},{"type":"null"}]},"threshold_pct":{"type":"number"},"shares_after":{"anyOf":[{"type":"number"},{"type":"null"}]},"shares_changed":{"anyOf":[{"type":"number"},{"type":"null"}]},"direction":{"anyOf":[{"type":"string"},{"type":"null"}]},"intent":{"type":"string"}},"required":["event_id","ticker","market","event_class","event_type","axis","source_category","event_date","title","stage","event_group_id","is_current","accession_number","form_type","filing_url","filing_date","holder_name","pct_before","pct_after","threshold_pct","shares_after","shares_changed","direction","intent"],"additionalProperties":false},"PublicAnalystConsensusItem":{"type":"object","properties":{"ticker":{"type":"string"},"total_analysts":{"type":"integer"},"strong_buy":{"type":"integer"},"buy":{"type":"integer"},"hold":{"type":"integer"},"sell":{"type":"integer"},"strong_sell":{"type":"integer"},"consensus_rating":{"type":"string"},"price_target_consensus":{"type":"number"},"price_target_high":{"type":"number"},"price_target_low":{"type":"number"},"price_target_count":{"type":"integer"}},"required":["ticker","total_analysts","strong_buy","buy","hold","sell","strong_sell","consensus_rating","price_target_consensus","price_target_high","price_target_low","price_target_count"],"additionalProperties":false},"PublicAnalystRatingsItem":{"type":"object","properties":{"ticker":{"type":"string"},"date":{"type":"string","format":"date"},"firm":{"type":"string"},"rating_action":{"type":"string"},"price_target_action":{"anyOf":[{"type":"string"},{"type":"null"}]},"rating_current":{"type":"string"},"rating_prior":{"anyOf":[{"type":"string"},{"type":"null"}]},"rating_current_normalized":{"anyOf":[{"type":"string"},{"type":"null"}]},"price_target_current":{"anyOf":[{"type":"number"},{"type":"null"}]},"price_target_prior":{"anyOf":[{"type":"number"},{"type":"null"}]},"source_name":{"type":"string"},"source_url":{"type":"string","format":"uri"},"published_at":{"type":"string","format":"date-time"}},"required":["ticker","date","firm","rating_action","price_target_action","rating_current","rating_prior","rating_current_normalized","price_target_current","price_target_prior","source_name","source_url","published_at"],"additionalProperties":false},"PublicExecutivesItem":{"type":"object","properties":{"ticker":{"type":"string"},"name":{"type":"string"},"title":{"type":"string"},"role_type":{"type":"string"},"start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}]},"end_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}]},"is_current":{"type":"boolean"},"accession_number":{"type":"string"},"form_type":{"type":"string"},"filing_url":{"type":"string","format":"uri"},"filing_date":{"type":"string","format":"date"}},"required":["ticker","name","title","role_type","start_date","end_date","is_current","accession_number","form_type","filing_url","filing_date"],"additionalProperties":false},"PublicExecutiveCompensationItem":{"type":"object","properties":{"ticker":{"type":"string"},"name":{"type":"string"},"title":{"type":"string"},"year":{"type":"integer"},"salary":{"type":"number"},"bonus":{"type":"number"},"stock_awards":{"type":"number"},"option_awards":{"type":"number"},"non_equity_incentive":{"type":"number"},"pension_value_change":{"type":"number"},"other_compensation":{"type":"number"},"total":{"type":"number"},"accession_number":{"type":"string"},"form_type":{"type":"string"},"filing_url":{"type":"string","format":"uri"},"filing_date":{"type":"string","format":"date"}},"required":["ticker","name","title","year","salary","bonus","stock_awards","option_awards","non_equity_incentive","pension_value_change","other_compensation","total","accession_number","form_type","filing_url","filing_date"],"additionalProperties":false}}},"paths":{"/api/v2/tickers":{"get":{"operationId":"publicDataV2Tickers","tags":["Company"],"summary":"Resolve or list canonical tickers","description":"Converts a company name, local code, ISIN, CIK or CUSIP into the `ticker` that every other endpoint uses, one per row. Without `query`, lists all currently trading common stocks in a market. Call this first when you only have a name or an identifier.\n\nExample request: `GET /api/v2/tickers?query=Apple%20Inc.&market=US`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"weekdays; profile 07:00 UTC, snapshot 16:00 UTC","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string"}},{"name":"market","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["US","CN","JP"]},"minItems":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":10}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicTickersItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"ticker":"AAPL","market":"US","name":"Apple Inc.","exchange":"XNAS","identifiers":{"isin":"US0378331005","cik":"0000320193","cusip":"037833100"}}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/company-discovery":{"get":{"operationId":"publicDataV2CompanyDiscovery","tags":["Company"],"summary":"Discover companies from a natural-language description","description":"Finds companies from a plain-language description. Returns every candidate that passes verification, one company per row: the ticker, the company name and the reason it matched. Use it when you do not know the ticker, then call the other endpoints with what it returns.\n\nExample request: `GET /api/v2/company-discovery?query=US%20companies%20that%20design%20GPUs%20for%20data%20centers&market=US`","security":[{"ApiKeyAuth":[]}],"x-credits":"3 cr per call","x-refresh":"follows company snapshot rebuild","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"}},{"name":"market","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["US","CN","JP","HK","KR"]},"minItems":1}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicCompanyDiscoveryItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"ticker":"NVDA","company_name":"NVIDIA Corporation","reason":"US company designing GPUs for accelerated data center platforms."},{"ticker":"AMD","company_name":"Advanced Micro Devices, Inc.","reason":"US company designing data center GPUs, including Radeon and Instinct accelerators."},{"ticker":"INTC","company_name":"Intel Corp.","reason":"Designs data center and AI discrete GPUs."}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/company-profile":{"get":{"operationId":"publicDataV2CompanyProfile","tags":["Company"],"summary":"Get company profiles","description":"Returns basic company profiles and external identifiers, one row per company. For prices, use `/prices-snapshot`; for valuation, use `/financial-metrics-snapshot`.\n\nExample request: `GET /api/v2/company-profile?ticker=AAPL`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"weekdays; profile 07:00 UTC, snapshot 16:00 UTC","parameters":[{"name":"ticker","in":"query","required":true,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":50}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicCompanyProfileItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"ticker":"AAPL","market":"US","name":"Apple Inc.","name_local":null,"exchange":"XNAS","country":"US","currency":"USD","sector":"Technology","industry":"Consumer Electronics","listing_date":"1980-12-12","website":"https://www.apple.com","full_time_employees":164000,"identifiers":{"isin":"US0378331005","cik":"0000320193","cusip":"037833100"}}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/filings":{"get":{"operationId":"publicDataV2Filings","tags":["Filings"],"summary":"List retained regulatory filings","description":"Returns a company's filings, one row per filing, with the form type, filing date and a link to the official document. Ordered by `filing_date` descending, then `accession_number` descending for the same day. Covers the last 5 years for US and the last 3 years of financial reports for JP / CN; there are no date or form-type parameters and no market-wide scan — every filing for that company inside the window comes back together. Filter for annual or quarterly reports yourself on the `form_type` field of the returned rows.\n\nExample request: `GET /api/v2/filings?ticker=AAPL&limit=20`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"US 5m; JP 15-30m; CN daily 16:00 UTC","parameters":[{"name":"ticker","in":"query","required":true,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":10}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicFilingsItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"ticker":"AAPL","market":"US","form_type":"4","title":null,"filing_date":"2026-02-03","period_of_report":null,"accession_number":"0001216519-26-000002","filing_url":"https://www.sec.gov/Archives/edgar/data/320193/000121651926000002/0001216519-26-000002.txt"},{"ticker":"AAPL","market":"US","form_type":"10-K","title":"Annual report for fiscal year ended September 27, 2025","filing_date":"2025-10-31","period_of_report":"2025-09-27","accession_number":"0000320193-25-000079","filing_url":"https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079.txt"}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/filing-search":{"get":{"operationId":"publicDataV2FilingSearch","tags":["Filings"],"summary":"Search retained filing text for one company","description":"Search SEC filings and Chinese and Japanese financial reports for facts buried in footnotes, tables and narrative disclosures. Semantic and keyword search returns original passages with filing context.\n\nExample request: `GET /api/v2/filing-search?ticker=AAPL&query=share+repurchase&form_type=10-K&from=2025-01&to=2025-12`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.1 cr per call","x-refresh":"US 5m; JP 15-30m; CN daily 16:00 UTC","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"}},{"name":"ticker","in":"query","required":true,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":1}},{"name":"form_type","in":"query","required":false,"schema":{"type":"string"}},{"name":"from","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicFilingSearchItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"ticker":"AAPL","market":"US","form_type":"10-K","filing_date":"2025-10-31","language":"en","section":"Share Repurchase Program","snippet":"Share Repurchase Program During 2025, the Company repurchased 402 million shares of its common stock for $89.3 billion…","score":0.0472}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/industry-inflections":{"get":{"operationId":"publicDataV2IndustryInflections","tags":["Signal"],"summary":"List published industry inflections","description":"Returns industry-level changes synthesized from the earnings calls of multiple US-listed companies, one row per inflection theme that can be tracked over time: the change mechanism, impact scope and degree, market attention, and the per-company impact breakdown (the `company_impacts` array, not flattened by company). Built from earnings calls held after July 2026 and refreshed daily as new calls and evidence arrive.\n\nExample request: `GET /api/v2/industry-inflections?limit=10&page=1`","security":[{"ApiKeyAuth":[]}],"x-credits":"1 cr per call","x-refresh":"daily upstream research refresh and historical replay","parameters":[{"name":"keyword","in":"query","required":false,"schema":{"type":"string"}},{"name":"ticker","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":10}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":10,"default":10}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicIndustryInflectionsItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"change_id":"theme_0652186192fd13ab","quarter":"2026Q2","name":"Conflict feedstock rationing re-sorts who can supply","regime_type":"competition","impact_scope":"cross_industry","impact_degree":2,"attention_verdict":"partly","change_summary":"…","first_seen":"2026-08-13","source_tickers":["ANSLY","GRSXY","UFI"],"company_impacts":[{"ticker":"UFI","relation":"direct","direction":"positive","magnitude":2,"impact_stage":"realized","evidence_status":"confirmed","affected_business":"Brazil segment …","impact":"…"}]}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/enterprise-ai-adoption":{"get":{"operationId":"publicDataV2EnterpriseAiAdoption","tags":["Signal"],"summary":"List enterprise AI adoption observations","description":"Returns the concrete enterprise AI applications US-listed companies have disclosed on earnings calls: the workflow each is used in, its deployment stage and scope, the value disclosed, metrics and supporting evidence. General statements about AI strategy are excluded.\n\nExample request: `GET /api/v2/enterprise-ai-adoption?ticker=ALHC&since=2024-01-01`","security":[{"ApiKeyAuth":[]}],"x-credits":"1 cr per call","x-refresh":"daily upstream research refresh and historical replay","parameters":[{"name":"ticker","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":10}},{"name":"since","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":10,"default":10}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicEnterpriseAiAdoptionItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"deployment_id":"p91_external_case_05f447e473a6182f","application_id":"app_b5743ede99d797b3","ticker":"ALHC","company_name":"Alignment Healthcare, Inc.","application_name":"AI-leveraging contract management solutions …","first_report_date":"2026-04-30","update_date":"2026-04-30","summary":"[Application] … [Current Result] … [Financial Link] … [Boundary] …","evolution_summary":"[Management Stance] … ","business_position":"support_function","deployment_stage":"unclear","deployment_scope":"unclear","value_type":"cost_reduction","metrics":[{"metric_name":"Administrative cost reduction","value":"15%","scope":"Contract management workflow","metric_role":"realized_result","financial_metric":"operating_expenses","financial_attribution":"Management attributed part of the reduction to the AI-enabled workflow.","evidence_id":"ev_3f1c8a20d4b7"}],"evidence":[{"evidence_id":"ev_3f1c8a20d4b7","quote":"we are also deploying contract management solutions that leverage AI …","speaker":null,"section":null}]}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/news-search":{"post":{"operationId":"publicDataV2NewsSearch","tags":["Signal"],"summary":"Search cross-source news storylines, events and attributed claims","description":"Searches news across sources and returns storylines. Duplicate reports of the same occurrence are merged into one event, related events are grouped into a storyline, and statements with a named speaker and subject are returned separately as attributed claims (`claims`). Each item in `results` is a storyline, not an article; every result is an in-house summary with links to the original sources, and article text is not included.\n\nExample request: `POST /api/v2/news-search` with the JSON body shown below.","security":[{"ApiKeyAuth":[]}],"x-credits":"1 cr per call","x-refresh":"continuous signal ingestion","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"theme":{"type":"string"},"ticker":{"anyOf":[{"type":"string","minLength":1},{"type":"array","items":{"type":"string","minLength":1},"minItems":1,"maxItems":1}]},"since":{"type":"string","format":"date-time"},"until":{"type":"string","format":"date-time"},"search_type":{"type":"string","enum":["all","events","claims"],"default":"all"},"order_by":{"type":"string","enum":["relevance","event_time","create_time"],"default":"relevance"},"top_k":{"type":"integer","minimum":1,"maximum":50,"default":10},"cursor":{"type":"string"}},"required":[],"anyOf":[{"required":["query"]},{"required":["theme"]},{"required":["ticker"]},{"required":["since"]},{"required":["until"]}],"additionalProperties":false},"example":{"query":"export controls","ticker":"NVDA","search_type":"all","order_by":"relevance","top_k":2}}}},"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicNewsSearchItem"},"example":{"query":"export controls","theme":null,"theme_resolved":null,"ticker":["NVDA"],"since":null,"until":null,"order_by":"relevance","count":2,"results":[{"story_id":123,"title":"US Tightens AI Chip Export Curbs on China","summary":"The US expanded restrictions on access to advanced AI chips.","node_count":48,"first_seen_at":"2026-05-30T23:59:59Z","last_seen_at":"2026-08-31T07:05:38Z","created_at":"2026-05-30T23:59:59Z","sim":0.91,"events_in_window":2,"tags":{"version":1,"primary_class":"legal_regulatory","event_types":["regulatory_action"],"regions":["US","CN"],"sectors_gics":["Information Technology"]},"events":[{"id":456,"time_event":"2026-08-31T07:05:38Z","summary":"US authorities expanded AI-chip export controls.","event_type":"regulatory_action","event_subtype":null,"primary_entity_name":"United States","object_name":"Nvidia","score":4.5,"sim":0.88,"sources_total":6,"first_reported":"2026-08-31T07:05:38Z","last_reported":"2026-08-31T09:12:00Z","source":{"name":"Reuters","url":"https://www.reuters.com/...","time":"2026-08-31T07:05:38Z","headline":"US tightens AI chip export curbs"}}]}],"claims":[{"id":789,"time_event":"2026-08-31T08:00:00Z","claim_type":"policy_statement","claim_subtype":null,"claimant_name":"US Department of Commerce","target_name":"Nvidia","summary":"The department said the updated controls cover additional advanced chips.","sources_total":3,"first_reported":"2026-08-31T08:00:00Z","last_reported":"2026-08-31T09:20:00Z","source":{"name":"Reuters","url":"https://www.reuters.com/...","time":"2026-08-31T08:00:00Z","headline":"US updates advanced-chip export controls"}}],"next_cursor":null,"claims_skipped":null}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/income-statements":{"get":{"operationId":"publicDataV2IncomeStatements","tags":["Financials"],"summary":"Get income statements","description":"Returns a company's income statement: revenue, costs, profit at each level, earnings per share and more, one row per reporting period. 29 line-item columns in total, plus the 14 meta-data fields shared by the three statements, all listed under Response fields. `ebitda` is a derived column (not an as-reported line). Quarterly amounts may be calculated from cumulative disclosures; earnings per share and weighted average shares cannot be obtained by directly subtracting cumulative figures.\n\nExample request: `GET /api/v2/income-statements?ticker=AAPL&period=FY&limit=5`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"follows filing ingestion; canonical replay weekly","parameters":[{"name":"ticker","in":"query","required":true,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":10}},{"name":"period","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["FY","Q1","Q2","Q3","Q4"]},"minItems":1,"default":["FY"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":40,"default":4}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicIncomeStatementsItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"ticker":"AAPL","market":"US","fiscal_year":2025,"period":"FY","period_start":"2024-09-29","report_period":"2025-09-27","currency":"USD","accounting_standard":"US-GAAP","accession_number":"0000320193-25-000079","form_type":"10-K","filing_url":"https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079.txt","filing_date":"2025-10-31","derived_fields":[],"derivation":{},"revenue":416161000000,"cost_of_revenue":220960000000,"gross_profit":195201000000,"research_and_development_expense":34550000000,"selling_and_marketing_expense":null,"general_and_administrative_expense":8077000000,"selling_general_and_administrative_expense":null,"taxes_and_surcharges":null,"operating_expenses":null,"operating_income":133050000000,"interest_income":null,"interest_expense":null,"other_non_operating_income":null,"ordinary_income":null,"extraordinary_gains":null,"extraordinary_losses":null,"pretax_income":132729000000,"income_tax_expense":20719000000,"net_income":null,"net_income_attributable_to_parent":112010000000,"net_income_attributable_to_noncontrolling_interests":null,"depreciation_and_amortization":null,"share_based_compensation":12863000000,"eps_basic":null,"eps_diluted":null,"dividend_per_share":1.02,"weighted_average_shares_basic":14948500000,"weighted_average_shares_diluted":null,"ebitda":null}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/balance-sheets":{"get":{"operationId":"publicDataV2BalanceSheets","tags":["Financials"],"summary":"Get balance sheets","description":"Returns a company's balance sheet: assets, liabilities, shareholders' equity and their line items, one row per reporting period as of period end. 41 line-item columns in total, plus the 14 meta-data fields shared by the three statements, all listed under Response fields; `period_start` is always `null`. `total_debt` / `net_debt` are derived columns (not as-reported lines); all other columns are as-reported values.\n\nExample request: `GET /api/v2/balance-sheets?ticker=AAPL&period=FY&limit=3`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"follows filing ingestion; canonical replay weekly","parameters":[{"name":"ticker","in":"query","required":true,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":10}},{"name":"period","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["FY","Q1","Q2","Q3","Q4"]},"minItems":1,"default":["FY"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":40,"default":4}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicBalanceSheetsItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"ticker":"AAPL","market":"US","fiscal_year":2025,"period":"FY","period_start":null,"report_period":"2025-09-27","currency":"USD","accounting_standard":"US-GAAP","accession_number":"0000320193-25-000079","form_type":"10-K","filing_url":"https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079.txt","filing_date":"2025-10-31","derived_fields":["total_equity"],"derivation":{"total_equity":{"value":73733000000,"inputs":[{"value":359241000000,"metric":"total_assets","currency":"USD","form_type":"10-K","operation":"reported","filing_url":"https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079.txt","filing_date":"2025-10-31","available_at":"2025-10-31","period_start":null,"report_period":"2025-09-27","accession_number":"0000320193-25-000079"},{"value":285508000000,"metric":"total_liabilities","currency":"USD","form_type":"10-K","operation":"reported","filing_url":"https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079.txt","filing_date":"2025-10-31","available_at":"2025-10-31","period_start":null,"report_period":"2025-09-27","accession_number":"0000320193-25-000079"}],"metric":"total_equity","currency":"USD","operation":"minus","available_at":"2025-10-31","period_start":null,"report_period":"2025-09-27"}},"cash_and_cash_equivalents":35934000000,"short_term_investments":18763000000,"accounts_receivable":null,"inventories":5718000000,"prepaid_expenses":null,"other_current_assets":null,"current_assets":147957000000,"property_plant_equipment":null,"right_of_use_assets":11205000000,"goodwill":null,"intangible_assets":13301000000,"long_term_investments":null,"deferred_tax_assets":null,"other_non_current_assets":83727000000,"non_current_assets":null,"total_assets":359241000000,"accounts_payable":69860000000,"short_term_debt":null,"current_portion_of_long_term_debt":null,"employee_compensation_payable":null,"income_taxes_payable":13016000000,"accrued_liabilities":null,"deferred_revenue":null,"other_current_liabilities":null,"current_liabilities":165631000000,"long_term_debt":null,"lease_liabilities":692000000,"deferred_tax_liabilities":19980000000,"other_non_current_liabilities":null,"non_current_liabilities":null,"total_liabilities":285508000000,"common_stock":93568000000,"additional_paid_in_capital":null,"retained_earnings":-14264000000,"treasury_stock":null,"accumulated_other_comprehensive_income":null,"equity_attributable_to_parent":73733000000,"noncontrolling_interests":null,"total_equity":73733000000,"temporary_equity":null,"total_debt":null,"net_debt":null}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/cash-flow-statements":{"get":{"operationId":"publicDataV2CashFlowStatements","tags":["Financials"],"summary":"Get cash-flow statements","description":"Returns a company's cash flow statement: operating, investing and financing cash flows plus free cash flow, one row per reporting period. 16 line-item columns in total, plus the 14 meta-data fields shared by the three statements, all listed under Response fields. Signs follow the statement direction: outflows such as capital expenditures, buybacks and dividends are negative, inflows such as investment proceeds are positive. `free_cash_flow` is a derived column (not an as-reported line). Quarterly cash flows may be calculated from cumulative disclosures; half-year or full-year cumulative amounts are not returned as single-quarter amounts.\n\nExample request: `GET /api/v2/cash-flow-statements?ticker=AAPL&period=FY&limit=3`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"follows filing ingestion; canonical replay weekly","parameters":[{"name":"ticker","in":"query","required":true,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":10}},{"name":"period","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["FY","Q1","Q2","Q3","Q4"]},"minItems":1,"default":["FY"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":40,"default":4}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicCashFlowStatementsItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"ticker":"AAPL","market":"US","fiscal_year":2025,"period":"FY","period_start":"2024-09-29","report_period":"2025-09-27","currency":"USD","accounting_standard":"US-GAAP","accession_number":"0000320193-25-000079","form_type":"10-K","filing_url":"https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079.txt","filing_date":"2025-10-31","derived_fields":["investing_cash_flow","dividends_paid","cash_at_end_of_period","income_taxes_paid"],"derivation":{"dividends_paid":{"value":-15421000000,"inputs":[{"value":15421000000,"metric":"dividends_paid","currency":"USD","form_type":"10-K","operation":"reported","filing_url":"https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079.txt","filing_date":"2025-10-31","available_at":"2025-10-31","period_start":"2024-09-29","report_period":"2025-09-27","accession_number":"0000320193-25-000079"}],"metric":"dividends_paid","currency":"USD","operation":"negative_absolute","available_at":"2025-10-31","period_start":"2024-09-29","report_period":"2025-09-27"},"income_taxes_paid":{"value":-43369000000,"inputs":[{"value":43369000000,"metric":"income_taxes_paid","currency":"USD","form_type":"10-K","operation":"reported","filing_url":"https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079.txt","filing_date":"2025-10-31","available_at":"2025-10-31","period_start":"2024-09-29","report_period":"2025-09-27","accession_number":"0000320193-25-000079"}],"metric":"income_taxes_paid","currency":"USD","operation":"negative_absolute","available_at":"2025-10-31","period_start":"2024-09-29","report_period":"2025-09-27"},"investing_cash_flow":{"value":15195000000,"inputs":[{"value":15195000000,"metric":"net_cash_used_for_investing_activities","currency":"USD","form_type":"10-K","operation":"reported","filing_url":"https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079.txt","filing_date":"2025-10-31","available_at":"2025-10-31","period_start":"2024-09-29","report_period":"2025-09-27","accession_number":"0000320193-25-000079"}],"metric":"investing_cash_flow","currency":"USD","operation":"col","available_at":"2025-10-31","period_start":"2024-09-29","report_period":"2025-09-27"},"cash_at_end_of_period":{"value":35934000000,"inputs":[{"value":35934000000,"metric":"cash_and_cash_equivalents","currency":"USD","form_type":"10-K","operation":"reported","filing_url":"https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079.txt","filing_date":"2025-10-31","available_at":"2025-10-31","period_start":null,"report_period":"2025-09-27","accession_number":"0000320193-25-000079"}],"metric":"cash_at_end_of_period","currency":"USD","operation":"col","available_at":"2025-10-31","period_start":"2024-09-29","report_period":"2025-09-27"}},"operating_cash_flow":111482000000,"change_in_working_capital":null,"capital_expenditures":null,"acquisitions_net":null,"purchases_of_investments":null,"proceeds_from_investments":null,"investing_cash_flow":15195000000,"share_repurchases":null,"dividends_paid":-15421000000,"financing_cash_flow":-120686000000,"effect_of_exchange_rate_on_cash":null,"net_change_in_cash":5991000000,"cash_at_end_of_period":35934000000,"income_taxes_paid":-43369000000,"interest_paid":null,"free_cash_flow":null}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/financial-metrics-snapshot":{"get":{"operationId":"publicDataV2FinancialMetricsSnapshot","tags":["Financials"],"summary":"Get current financial metrics","description":"Returns a company's precomputed valuation and financial ratios: market cap, enterprise value, TTM valuation multiples, margins, returns, growth rates, leverage and liquidity ratios, and dividend metrics, one row per ticker as of the latest snapshot date. Ratios are always decimals (`0.25` = 25%), not percentages; monetary fields are in `currency` (the trading currency), and `market_capitalization_usd` is additionally converted to USD at the snapshot-date rate.\n\nExample request: `GET /api/v2/financial-metrics-snapshot?ticker=AAPL`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"weekdays at 16:00 UTC","parameters":[{"name":"ticker","in":"query","required":true,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":50}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicFinancialMetricsSnapshotItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"ticker":"AAPL","market":"US","currency":"USD","shares_outstanding":14780000000,"market_capitalization":3421000000000,"market_capitalization_usd":3421000000000,"enterprise_value":3480000000000,"pe_ratio_ttm":34.2,"peg_ratio_ttm":2.9,"pb_ratio_ttm":47.1,"ps_ratio_ttm":8.5,"pcf_ratio_ttm":28,"ev_to_sales_ttm":8.7,"ev_to_ebitda_ttm":26.3,"ev_to_ebit_ttm":28.1,"gross_profit_margin_ttm":0.463,"ebitda_margin_ttm":0.334,"net_income_margin_ttm":0.253,"fcf_margin_ttm":0.27,"roe_ttm":1.472,"roa_ttm":0.29,"roic_ttm":0.58,"revenue_growth_ttm":0.061,"eps_growth_ttm":0.083,"fcf_growth_ttm":0.05,"revenue_cagr_3y":0.04,"eps_cagr_3y":0.09,"dividend_yield_ttm":0.0042,"payout_ratio_ttm":0.15,"dividend_growth_1y":0.04,"consecutive_dividend_years":13,"debt_to_equity":1.45,"net_debt_to_equity":0.24,"debt_to_assets":0.29,"debt_to_ebitda":0.62,"net_debt_to_ebitda":0.1,"interest_coverage":38.6,"ebitda_to_interest":44.2,"current_ratio":1.07,"quick_ratio":1.02,"cash_ratio":0.51,"working_capital":9473000000,"operating_cash_flow_ratio":0.89,"fcf_to_debt":1.38,"ocf_to_debt":1.54,"ebit_margin_ttm":0.318,"capex_to_sales_ttm":0.029,"asset_turnover_ttm":1.19,"cash_per_share_ttm":4.69,"ebitda_growth_ttm":0.072,"ebit_growth_ttm":0.059,"ocf_growth_ttm":0.081,"ebitda_cagr_3y":0.05,"ebit_cagr_3y":0.04,"net_income_cagr_3y":0.06,"fcf_cagr_3y":0.03,"book_value_cagr_3y":-0.08,"total_assets_cagr_3y":0.01,"dividend_rate_ttm":1.04,"fcf_payout_ratio_ttm":0.077,"dividend_cagr_3y":0.042,"dividend_frequency":"Quarterly","price_date":"2026-09-08","statement_period_end":"2026-06-27","statement_period":"Q3"}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/prices-historical":{"get":{"operationId":"publicDataV2PricesHistorical","tags":["Prices"],"summary":"Get US daily, weekly or monthly price history","description":"Returns a stock's historical daily, weekly or monthly bars: open, high, low and close, one row per bar, in descending `date` order. All bars in the date window come back in a single response; `limit` / `page` are not accepted. Prices are raw and unadjusted, updated after market close; there is no intraday or real-time data.\n\nExample request: `GET /api/v2/prices-historical?ticker=AAPL&from=2026-01-01&to=2026-08-20&interval=week`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"weekdays after close at 22:00 UTC","parameters":[{"name":"ticker","in":"query","required":true,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":1}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"interval","in":"query","required":false,"schema":{"type":"string","enum":["day","week","month"],"default":"day"}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicPricesHistoricalItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"ticker":"AAPL","date":"2026-08-17","open":248.93,"high":249.1,"low":241.82,"close":243.85}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/prices-snapshot":{"get":{"operationId":"publicDataV2PricesSnapshot","tags":["Prices"],"summary":"Get latest US closing-price snapshots","description":"Returns each stock's closing price for its latest trading day, at most one row per ticker, with `date` as that trading day. Prices are unadjusted and updated after market close; this is not a real-time quote. Row order is not declared in the contract, so match rows to the request by the `ticker` field, not by position. US common stock only: if any ticker cannot be resolved or is non-US, the whole request returns `404` rather than returning what it can and silently dropping the rest. For historical prices use `/prices-historical`.\n\nExample request: `GET /api/v2/prices-snapshot?ticker=AAPL,MSFT`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"weekdays after close at 22:00 UTC","parameters":[{"name":"ticker","in":"query","required":true,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":50}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicPricesSnapshotItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"ticker":"AAPL","date":"2026-08-20","price":231.42},{"ticker":"MSFT","date":"2026-08-20","price":512.3}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/earnings-calendar":{"get":{"operationId":"publicDataV2EarningsCalendar","tags":["Earnings"],"summary":"Get earnings calendar entries","description":"Returns the earnings calendar for a date range: which company reports on which day, with EPS / revenue estimates and actuals. One row per company per announcement, covering US / CN / JP, queried by announcement date `date`; there is no ticker filter, so filter the returned rows for a single company.\n\nExample request: `GET /api/v2/earnings-calendar?from=2026-03-06&to=2026-06-03&limit=50&page=1`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"hourly","parameters":[{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicEarningsCalendarItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"ticker":"NVDA","date":"2026-05-28","eps_actual":1.05,"eps_estimated":1.01,"revenue_actual":46743000000,"revenue_estimated":46047000000,"last_updated":"2026-05-29"}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/earnings-call-summary":{"get":{"operationId":"publicDataV2EarningsCallSummary","tags":["Earnings"],"summary":"Get earnings-call summaries","description":"Returns a structured summary of an earnings call across five dimensions: management highlights, guidance, risks, segment performance and Q&A topics, plus the title and date, one row per call; the transcript itself is not provided. Locate a call with `ticker` + `fiscal_year` + `period`; a fiscal quarter usually has only one call, so the default `limit=1` is enough.\n\nExample request: `GET /api/v2/earnings-call-summary?ticker=AAPL&fiscal_year=2020&period=Q3`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"transcripts every 10m; summary follows ingestion","parameters":[{"name":"ticker","in":"query","required":true,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":1}},{"name":"fiscal_year","in":"query","required":true,"schema":{"type":"integer"}},{"name":"period","in":"query","required":true,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["Q1","Q2","Q3","Q4","FY"]},"minItems":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":20,"default":1}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicEarningsCallSummaryItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"ticker":"AAPL","fiscal_year":2020,"period":"Q3","date":"2020-07-30","title":"Apple FY2020 Q3 earnings call summary","management_highlights":"Services and wearables reached record revenue…","guidance":"Management did not provide formal quarterly guidance…","risks":"COVID-19 continued to create uncertainty…","segment_performance":"iPhone revenue increased while Mac and iPad accelerated…","qa_topics":"Analysts focused on product demand, margins and capital returns…"}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/insider-trades":{"get":{"operationId":"publicDataV2InsiderTrades","tags":["Ownership"],"summary":"Get self-parsed insider holdings and transactions","description":"Query insiders' initial holdings and transactions for a company. Each row represents one Form 3 initial holding or one Form 4 / Form 5 transaction, including amended filings.\n\nExample request: `GET /api/v2/insider-trades?ticker=AAPL&from=2026-07-01&to=2026-08-31&transaction_type=sell&is_amendment=false`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"daily 11:00 UTC plus weekly replay","parameters":[{"name":"ticker","in":"query","required":true,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":1}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"record_type","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["initial_holding","transaction"]},"minItems":1}},{"name":"form_type","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["3","3/A","4","4/A","5","5/A"]},"minItems":1}},{"name":"transaction_type","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["buy","sell","award","exercise","tax_withholding","other"]},"minItems":1}},{"name":"is_amendment","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicInsiderTradesItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"ticker":"AAPL","insider_name":"COOK TIMOTHY D","insider_title":"Chief Executive Officer","is_director":true,"is_officer":true,"record_type":"transaction","transaction_type":"sell","transaction_code":"S","transaction_date":"2026-08-03","security_title":"Common Stock","ownership_type":"direct","shares":223986,"price_per_share":231.42,"total_value":51834840.12,"shares_owned_after":3280042,"form_type":"4","is_amendment":false,"original_filing_date":null,"accession_number":"0000320193-26-000090","filing_url":"https://www.sec.gov/Archives/edgar/data/...","filing_date":"2026-08-06"}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/institutional-holdings":{"get":{"operationId":"publicDataV2InstitutionalHoldings","tags":["Ownership"],"summary":"Get self-parsed institutional holdings","description":"Query institutional investors’ reported quarterly holdings, quantities and market values. Each row is one holding record from an SEC 13F-HR filing or amendment, rather than an aggregated institution–security position.\n\nExample request: `GET /api/v2/institutional-holdings?investor_cik=0001067983&report_period=2026-06-30`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"daily 05:00 UTC plus weekly replay","parameters":[{"name":"ticker","in":"query","required":false,"description":"One of ticker, investor_cik is required.","style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":1}},{"name":"investor_cik","in":"query","required":false,"description":"One of ticker, investor_cik is required.","schema":{"type":"string"}},{"name":"report_period","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicInstitutionalHoldingsItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"ticker":null,"investor_name":"Berkshire Hathaway Inc","investor_cik":"0001067983","report_period":"2026-06-30","shares":12561737,"market_value":577211815,"change_in_shares":-157938,"accession_number":"0001193125-26-352200","form_type":"13F-HR","filing_url":"https://www.sec.gov/Archives/edgar/data/1067983/000119312526352200/0001193125-26-352200.txt","filing_date":"2026-08-14"}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/events":{"get":{"operationId":"publicDataV2Events","tags":["Events"],"summary":"Get the canonical company-event timeline","description":"Returns a company's event timeline: financings, deals, executive changes, dividends and buybacks, ownership changes, bankruptcy and delisting. Each row contains shared fields such as the event date, classification and filing link. Type-specific fields such as deal terms are on the matching `/events-*` endpoint: choose it by `event_class`, query with the same `ticker` and `from` = `to` = `event_date`, then match on `event_id` (identical on both sides; typed endpoints do not accept an `event_id` parameter).\n\nExample request: `GET /api/v2/events?ticker=BA&event_class=capital&from=2026-08-01&to=2026-08-31`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"intraday extraction plus Sunday 09:00 UTC canonical replay","parameters":[{"name":"ticker","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":10}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"event_class","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["capital","distribution","share_structure","transaction","agreement","governance","ownership","legal_regulatory"]},"minItems":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicEventsItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"event_id":"2ab01e9be7acdb60d1fa9fdb1a50d66099f571c6","ticker":"BA","market":"US","event_class":"capital","event_type":"debt_issuance","axis":{"action":"amend"},"source_category":"8-K:1.01","event_date":"2026-08-24","title":"Debt Issuance: 2023 Five-Year Credit Agreement","stage":"amended","event_group_id":"17f96e213777c218efe4","is_current":true,"accession_number":"0001628280-26-059427","form_type":"8-K","filing_url":"https://www.sec.gov/Archives/edgar/data/12927/000162828026059427/0001628280-26-059427.txt","filing_date":"2026-08-28"}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/events-financings":{"get":{"operationId":"publicDataV2EventsFinancings","tags":["Events"],"summary":"Get financing events","description":"Returns a company's financing events with their terms: equity issuances, debt issuances, convertible notes, guarantees and defaults, one row per event (`event_class = capital`), distinguished by `event_type`, with amount, interest rate, maturity, issue price and other terms in type-specific fields. Buybacks are not here; they belong to `/events-corporate-actions`.\n\nExample request: `GET /api/v2/events-financings?ticker=BA&event_type=debt_issuance&from=2026-08-01&to=2026-08-31`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"intraday extraction plus Sunday 09:00 UTC canonical replay","parameters":[{"name":"ticker","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":10}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"event_type","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["equity_issuance","debt_issuance","convertible","guarantee","debt_default"]},"minItems":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicEventsFinancingsItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"event_id":"2ab01e9be7acdb60d1fa9fdb1a50d66099f571c6","ticker":"BA","market":"US","event_class":"capital","event_type":"debt_issuance","axis":{"action":"amend"},"source_category":"8-K:1.01","event_date":"2026-08-24","title":"Debt Issuance: 2023 Five-Year Credit Agreement","stage":"amended","event_group_id":"17f96e213777c218efe4","is_current":true,"accession_number":"0001628280-26-059427","form_type":"8-K","filing_url":"https://www.sec.gov/Archives/edgar/data/12927/000162828026059427/0001628280-26-059427.txt","filing_date":"2026-08-28","instrument":null,"action":"amend","amount":3000000000,"currency":"USD","counterparty_names":["Citibank, N.A.","JPMorgan Chase Bank, N.A."],"use_of_proceeds":null,"closing_date":null,"interest_rate":null,"maturity_date":"2029-08-24","is_secured":null,"covenants":[],"shares":null,"price_per_share":null,"discount_pct":null,"exemption":null,"registration_rights":null,"lock_up_period":null,"conversion_price":null,"conversion_ratio":null}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/events-deals":{"get":{"operationId":"publicDataV2EventsDeals","tags":["Events"],"summary":"Get deal events","description":"Returns a company's deals and agreements with counterparties: M&A, divestitures, joint ventures, licensing, material contracts and settlements, one row per deal (`event_class = transaction` or `agreement`), with the filing company as the subject: `direction` / `filer_role` state whether it is buyer or seller, licensor or licensee, and the counterparty is in `counterparty_names` / `counterparty_tickers`.\n\nExample request: `GET /api/v2/events-deals?ticker=MSFT&event_type=acquisition&from=2023-10-01&to=2023-10-31`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"intraday extraction plus Sunday 09:00 UTC canonical replay","parameters":[{"name":"ticker","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":10}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"event_class","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["transaction","agreement"]},"minItems":1}},{"name":"event_type","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["acquisition","disposal","merger","spin_off","joint_venture","strategic_investment","restructuring","license","supply","partnership","major_contract","settlement"]},"minItems":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicEventsDealsItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"event_id":"8fc647178582a2a2dc47e538925f730f201d04d2","ticker":"MSFT","market":"US","event_class":"transaction","event_type":"acquisition","axis":{"consideration_type":"mixed"},"source_category":"8-K:2.01","event_date":"2023-10-13","title":"Acquisition: Activision Blizzard, Inc.","stage":"completed","event_group_id":"a07841fd66d131a32fef","is_current":true,"accession_number":"0001193125-23-255762","form_type":"8-K","filing_url":"https://www.sec.gov/Archives/edgar/data/789019/000119312523255762/0001193125-23-255762.txt","filing_date":"2023-10-13","deal_domain":"transaction","direction":"inbound","filer_role":"acquirer","counterparty_names":["Activision Blizzard, Inc."],"counterparty_tickers":[],"deal_name":"Activision Blizzard, Inc.","deal_value":null,"currency":"USD","consideration_type":"mixed","structure":null,"stake_pct":null,"price_per_share":95,"premium_pct":null,"termination_fee":null,"expected_close_date":null,"conditions":[],"termination_reason":null}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/events-executive-changes":{"get":{"operationId":"publicDataV2EventsExecutiveChanges","tags":["Events"],"summary":"Get executive-change events","description":"Returns changes among a company's executives, directors and auditors: who, which role, appointment or departure, and the effective date, one row per change (`executive_change` / `director_change` / `auditor_change` within `event_class = governance`). Only disclosed facts are restated, with no profiling of individuals. Equity incentive events (`equity_incentive`) are available only on the `/events` timeline.\n\nExample request: `GET /api/v2/events-executive-changes?event_type=executive_change&from=2026-03-01&to=2026-03-31`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"intraday extraction plus Sunday 09:00 UTC canonical replay","parameters":[{"name":"ticker","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":10}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"event_type","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["executive_change","director_change","auditor_change"]},"minItems":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicEventsExecutiveChangesItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"event_id":"ev_5b09…","ticker":"INTC","market":"US","event_class":"governance","event_type":"executive_change","axis":{"role_type":"cfo","action":"departure","reason":"resignation"},"source_category":"8-K:5.02","event_date":"2026-03-18","title":"CFO Jane Smith resigns; John Lee named interim CFO","stage":"announced","event_group_id":"eg_2f77…","is_current":true,"accession_number":"0000050863-26-000041","form_type":"8-K","filing_url":"https://www.sec.gov/Archives/edgar/data/...","filing_date":"2026-03-18","person_name":"Jane Smith","role":"Chief Financial Officer","role_type":"cfo","action":"departure","reason":"resignation","effective_date":"2026-04-30","successor_name":"John Lee","is_interim":true}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/events-corporate-actions":{"get":{"operationId":"publicDataV2EventsCorporateActions","tags":["Events"],"summary":"Get corporate-action events","description":"Returns the dividends, buybacks, capital reductions, splits and reverse splits, stock dividends and bonus issues, and share class changes a company has announced, one row per disclosure (`event_class = distribution` or `share_structure`). It records what the company announced and is not a source of adjustment factors: no rights-issue / spin-off ex-date adjustment parameters are provided, and `/prices-historical` returns unadjusted prices.\n\nExample request: `GET /api/v2/events-corporate-actions?ticker=AVGO&event_type=dividend&from=2026-09-01&to=2026-09-30`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"intraday extraction plus Sunday 09:00 UTC canonical replay","parameters":[{"name":"ticker","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":10}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"event_class","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["distribution","share_structure"]},"minItems":1}},{"name":"event_type","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string","enum":["dividend","buyback","capital_reduction","stock_split","reverse_split","bonus_issue","share_class_change"]},"minItems":1}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicEventsCorporateActionsItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"event_id":"816c6490ec1c8e560df27035ec58d93bfeed79c9","ticker":"AVGO","market":"US","event_class":"distribution","event_type":"dividend","axis":{"subtype":"regular"},"source_category":"8-K:8.01","event_date":"2026-09-02","title":"Quarterly cash dividend of $0.65 per share declared on September 2, 2026, payable on September 30, 2026 to stockholders of record on September 21, 2026.","stage":"announced","event_group_id":"4f1dce5504133d9e8db3","is_current":true,"accession_number":"0001730168-26-000076","form_type":"8-K","filing_url":"https://www.sec.gov/Archives/edgar/data/1730168/000173016826000076/0001730168-26-000076.txt","filing_date":"2026-09-02","subtype":"regular","ex_date":null,"record_date":"2026-09-21","pay_date":"2026-09-30","amount_per_share":0.65,"currency":"USD","ratio":null,"shares_affected":null,"amount_total":null}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/events-ownership":{"get":{"operationId":"publicDataV2EventsOwnership","tags":["Events"],"summary":"Get ownership events","description":"Returns major shareholder positions disclosed in SEC Schedule 13D/G filings. Each row represents one reporting person and security position in a filing, with the currently reported ownership, its change from the preceding filing when calculable, and a link to the official document; a joint filing can return multiple rows. Only the latest row for each company + shareholder + security sequence is returned. `event_class` is fixed at `ownership` and `event_type` at `stake_change`. For routine insider trades, use `/insider-trades`.\n\nExample request: `GET /api/v2/events-ownership?ticker=PLTR&from=2026-03-01&to=2026-03-31`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"intraday extraction plus Sunday 09:00 UTC canonical replay","parameters":[{"name":"ticker","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":10}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicEventsOwnershipItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"event_id":"105be55eb44776e37c92f3d13eedcd33829833a5","ticker":"PLTR","market":"US","event_class":"ownership","event_type":"stake_change","axis":{"intent":"passive"},"source_category":"SCHEDULE 13G","event_date":"2026-03-31","title":"SCHEDULE 13G: Vanguard Capital Management — 7.28% of Common Stock","stage":"completed","event_group_id":"6e063eeabde9fd324be7","is_current":true,"accession_number":"0002100119-26-000893","form_type":"SCHEDULE 13G","filing_url":"https://www.sec.gov/Archives/edgar/data/1321655/000210011926000893/0002100119-26-000893.txt","filing_date":"2026-04-30","holder_name":"Vanguard Capital Management","pct_before":null,"pct_after":7.28,"threshold_pct":5,"shares_after":166908333,"shares_changed":null,"direction":null,"intent":"passive"}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/analyst-consensus":{"get":{"operationId":"publicDataV2AnalystConsensus","tags":["Analyst"],"summary":"Get self-built analyst consensus","description":"Returns the analyst consensus for a stock: the five-tier distribution (strong buy to strong sell) of each firm's latest rating within the last 90 days, plus the mean / high / low price target, one row per ticker. Aggregated results only; this platform's own ratings are not included.\n\nExample request: `GET /api/v2/analyst-consensus?ticker=NVDA,AMD`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"daily 23:00 UTC","parameters":[{"name":"ticker","in":"query","required":true,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":50}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicAnalystConsensusItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"ticker":"NVDA","total_analysts":47,"strong_buy":6,"buy":24,"hold":15,"sell":2,"strong_sell":0,"consensus_rating":"buy","price_target_consensus":172.5,"price_target_high":220,"price_target_low":120,"price_target_count":41}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/analyst-ratings":{"get":{"operationId":"publicDataV2AnalystRatings","tags":["Analyst"],"summary":"Get self-parsed analyst rating events","description":"Returns individual analyst rating and price target changes: which firm upgraded, downgraded or maintained a rating on which day, and what the price target moved from and to, one row per event, ordered by `date desc, published_at desc`. Sourced from news reports; every row carries the firm name `firm` and a link to the source article `source_url`, and events missing either are not exposed. Firm level only, with no individual analyst names.\n\nExample request: `GET /api/v2/analyst-ratings?ticker=NVDA&from=2026-07-01&to=2026-07-31`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"daily 23:00 UTC","parameters":[{"name":"ticker","in":"query","required":true,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":1}},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":50}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicAnalystRatingsItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"ticker":"NVDA","date":"2026-07-14","firm":"Zacks Investment Research","rating_action":"upgrade","price_target_action":null,"rating_current":"buy","rating_prior":null,"rating_current_normalized":"buy","price_target_current":null,"price_target_prior":null,"source_name":"nasdaq","source_url":"https://www.nasdaq.com/articles/nvidia-nvda-upgraded-buy-heres-what-you-should-know","published_at":"2026-07-14T16:00:02+00:00"}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/executives":{"get":{"operationId":"publicDataV2Executives","tags":["Executives"],"summary":"Get self-parsed executive profiles","description":"Returns a company's executive roster: name, position, whether currently serving, and the filing that evidences the position, one row per person per position; a person who has held several positions in turn has several rows. Start and end dates are not provided: `start_date` / `end_date` are always null (the columns stay in the contract and will be populated once 10-K Part III / 8-K Item 5.02 evidence is onboarded). Position information only, with no personal attributes such as gender or birth year.\n\nExample request: `GET /api/v2/executives?ticker=AAPL`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"weekdays 12:00 UTC; historical backfill every 30m while incomplete","parameters":[{"name":"ticker","in":"query","required":true,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":1}},{"name":"is_current","in":"query","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicExecutivesItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"ticker":"AAPL","name":"Timothy D. Cook","title":"Chief Executive Officer and Director","role_type":"ceo","start_date":null,"end_date":null,"is_current":true,"accession_number":"0001308179-26-000032","form_type":"DEF 14A","filing_url":"https://www.sec.gov/Archives/edgar/data/...","filing_date":"2026-01-10"}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/executive-compensation":{"get":{"operationId":"publicDataV2ExecutiveCompensation","tags":["Executives"],"summary":"Get self-parsed executive compensation","description":"Returns executives' annual compensation: salary, bonus, stock and option awards, other compensation and the total, one row per executive per compensation year, taken from the Summary Compensation Table (SCT) of the DEF 14A; the amount columns map one-to-one onto the statutory SCT columns and are all as-disclosed values in USD, neither split nor converted.\n\nExample request: `GET /api/v2/executive-compensation?ticker=AAPL`","security":[{"ApiKeyAuth":[]}],"x-credits":"0.02 cr per call","x-refresh":"weekdays 12:00 UTC; historical backfill every 30m while incomplete","parameters":[{"name":"ticker","in":"query","required":true,"style":"form","explode":false,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":1}}],"responses":{"200":{"description":"Successful Public Data API response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PublicExecutiveCompensationItem"}}},"required":["data"],"additionalProperties":false},"example":{"data":[{"ticker":"AAPL","name":"Timothy D. Cook","title":"Chief Executive Officer","year":2025,"salary":3000000,"bonus":0,"stock_awards":58000000,"option_awards":0,"non_equity_incentive":12000000,"pension_value_change":0,"other_compensation":1500000,"total":74500000,"accession_number":"0001308179-26-000032","form_type":"DEF 14A","filing_url":"https://www.sec.gov/Archives/edgar/data/...","filing_date":"2026-01-10"}]}}}},"400":{"description":"Bad request (invalid or unsupported parameter)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"401":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"402":{"description":"Insufficient credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"404":{"description":"Ticker not found, market not covered, or dataset not available","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDataError"}}}}}}},"/api/v2/openapi.json":{"get":{"operationId":"getPublicDataV2OpenApi","tags":["Contract"],"summary":"Download the machine-readable API contract","description":"Unauthenticated. Also reachable at https://gateway.drillr.ai/openapi.json and https://drillr.ai/openapi.json, which redirect here.","security":[],"responses":{"200":{"description":"OpenAPI 3.1 document","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}