{"openapi":"3.1.0","info":{"title":"Findata API","version":"1.0.0","description":"SEC-reported fundamentals and corporate-action facts. Coverage depends on imported filings; values are not investment advice. Corporate-action facts are reported period facts, not a complete event calendar."},"servers":[{"url":"https://api.findata.com"}],"security":[{"OAuth":["openid"]},{"BearerKey":[]}],"tags":[{"name":"Income statement","description":"revenue, net_income"},{"name":"Balance sheet","description":"total_assets, total_liabilities, cash, stockholders_equity, short_term_debt, long_term_debt, accounts_receivable, inventory, current_debt, current_long_term_debt, commercial_paper"},{"name":"Cash flow","description":"operating_cash_flow, capital_expenditure"},{"name":"Companies","description":"Company lookup"},{"name":"Corporate actions","description":"Reported corporate-action facts"},{"name":"Fundamentals","description":"Metric definitions and reported observations"}],"paths":{"/v1/companies":{"get":{"tags":["Companies"],"operationId":"searchCompanies","summary":"Search companies","parameters":[{"name":"query","in":"query","required":true,"description":"Company name, ticker or CIK","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","required":["companies"],"properties":{"companies":{"type":"array","items":{"type":"object","required":["cik","name"],"properties":{"cik":{"type":"string"},"name":{"type":"string"}}}}}}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"409":{"description":"Ambiguous company identifier","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded; retry after the Retry-After interval","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}}}}},"/v1/companies/{id}":{"get":{"tags":["Companies"],"operationId":"getCompany","summary":"Get a company","parameters":[{"name":"id","in":"path","required":true,"description":"Ticker symbol or SEC CIK","schema":{"type":"string"},"example":"AAPL"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","required":["cik","name"],"properties":{"cik":{"type":"string"},"name":{"type":"string"}}}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"409":{"description":"Ambiguous company identifier","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded; retry after the Retry-After interval","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}}}}},"/v1/structured/companies/{cik}/coverage":{"get":{"tags":["Companies"],"operationId":"getStructuredCoverage","summary":"Check structured filing coverage for a company","description":"Returns indexed, completed, pending, failed and unavailable filing counts; counts do not guarantee complete financial coverage.","parameters":[{"name":"cik","in":"path","required":true,"description":"SEC CIK","schema":{"type":"string","pattern":"^[0-9]{1,10}$"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","required":["cik","indexed","completed","pending","running","failed","unavailable","limitations"],"properties":{"cik":{"type":"string"},"indexed":{"type":"integer"},"completed":{"type":"integer"},"pending":{"type":"integer"},"running":{"type":"integer"},"failed":{"type":"integer"},"unavailable":{"type":"integer"},"first_filing":{"type":["string","null"]},"last_filing":{"type":["string","null"]},"latest_completed_filing":{"type":["string","null"]},"limitations":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"404":{"description":"No indexed filings","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"409":{"description":"Ambiguous company identifier","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded; retry after the Retry-After interval","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}}}}},"/v1/structured/companies/{cik}/facts":{"get":{"tags":["Fundamentals"],"operationId":"getStructuredFacts","summary":"Get traceable structured facts","description":"Returns stored filing revisions, exact contexts, units and source links. Follow next_cursor to page through results.","parameters":[{"name":"cik","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{1,10}$"}},{"name":"tag","in":"query","required":false,"description":"Exact XBRL concept name","schema":{"type":"string"}},{"name":"form","in":"query","required":false,"description":"SEC form","schema":{"type":"string"}},{"name":"as_of","in":"query","required":false,"description":"Latest filing date","schema":{"type":"string","format":"date"}},{"name":"cursor","in":"query","required":false,"description":"Cursor returned by the previous page","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","required":["cik","facts","next_cursor"],"properties":{"cik":{"type":"string"},"as_of":{"type":["string","null"]},"facts":{"type":"array","items":{"type":"object","additionalProperties":true}},"next_cursor":{"type":["string","null"]},"version_semantics":{"type":"string"}}}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"409":{"description":"Ambiguous company identifier","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded; retry after the Retry-After interval","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}}}}},"/v1/metrics":{"get":{"tags":["Fundamentals"],"operationId":"listMetrics","summary":"List available metrics and groups","responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","required":["groups","metrics"],"properties":{"groups":{"type":"array","items":{"type":"object","additionalProperties":true}},"metrics":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"409":{"description":"Ambiguous company identifier","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded; retry after the Retry-After interval","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}}}}},"/v1/companies/{id}/metrics/series":{"get":{"tags":["Fundamentals"],"operationId":"getMetricSeries","summary":"Get aligned historical metric series","description":"Returns one point per exact period end in ascending order. Values are reported decimal strings; null means no unique value. Multiple periods ending on one date are listed in ambiguous_metrics and not guessed. Duration and instant metrics aligned on a date do not necessarily describe the same interval. No quarters are derived. Follow next_before using before to page older dates. A 422 response means the candidate limit was exceeded; narrow the date range.","parameters":[{"name":"id","in":"path","required":true,"description":"Ticker symbol or SEC CIK","schema":{"type":"string"},"example":"AAPL"},{"name":"metrics","in":"query","required":true,"description":"1–15 distinct comma-separated metric codes","schema":{"type":"string","example":"revenue,net_income,total_liabilities,cash"}},{"name":"frequency","in":"query","required":false,"description":"Reporting period","schema":{"type":"string","enum":["annual","quarterly"],"default":"annual"}},{"name":"from","in":"query","required":false,"description":"Inclusive period end date","schema":{"type":"string","format":"date","example":"2010-01-01"}},{"name":"to","in":"query","required":false,"description":"Inclusive period end date","schema":{"type":"string","format":"date"}},{"name":"as_of","in":"query","required":false,"description":"Latest filing date to consider","schema":{"type":"string","format":"date"}},{"name":"before","in":"query","required":false,"description":"Exclusive period end date for older pages","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Maximum dates per page","schema":{"type":"integer","minimum":1,"maximum":200,"default":200}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","required":["company","frequency","metrics","points","next_before","limitations"],"properties":{"company":{"type":"object","required":["cik","name"],"properties":{"cik":{"type":"string"},"name":{"type":"string"}}},"frequency":{"type":"string"},"metrics":{"type":"array","items":{"type":"object","additionalProperties":true}},"points":{"type":"array","items":{"type":"object","required":["period_end","values","ambiguous_metrics"],"properties":{"period_end":{"type":"string"},"values":{"type":"object","additionalProperties":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}]}},"ambiguous_metrics":{"type":"array","items":{"type":"string"}}}}},"next_before":{"type":["string","null"]},"limitations":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"409":{"description":"Ambiguous company identifier","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"422":{"description":"Too many candidate facts; narrow the date range","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded; retry after the Retry-After interval","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}}}}},"/v1/companies/{id}/metrics/{metric}":{"get":{"tags":["Fundamentals"],"operationId":"getMetricHistory","summary":"Get reported historical values","description":"Returns the latest reported value for each period. Directly reported quarters only; no derived quarters. Up to 200 observations.","parameters":[{"name":"id","in":"path","required":true,"description":"Ticker symbol or SEC CIK","schema":{"type":"string"},"example":"AAPL"},{"name":"metric","in":"path","required":true,"schema":{"type":"string","enum":["revenue","net_income","total_assets","total_liabilities","cash","stockholders_equity","short_term_debt","long_term_debt","accounts_receivable","inventory","current_debt","current_long_term_debt","commercial_paper","operating_cash_flow","capital_expenditure"]},"example":"revenue"},{"name":"frequency","in":"query","required":false,"description":"Reporting period","schema":{"type":"string","enum":["annual","quarterly"],"default":"annual"}},{"name":"from","in":"query","required":false,"description":"Inclusive period end date","schema":{"type":"string","format":"date","example":"2010-01-01"}},{"name":"to","in":"query","required":false,"description":"Inclusive period end date","schema":{"type":"string","format":"date"}},{"name":"as_of","in":"query","required":false,"description":"Latest filing date to consider","schema":{"type":"string","format":"date"}},{"name":"view","in":"query","required":false,"description":"latest selects one observation per period; history includes revisions","schema":{"type":"string","enum":["latest","history"]}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","required":["company","metric","frequency","observations","limitations"],"properties":{"company":{"type":"object","required":["cik","name"],"properties":{"cik":{"type":"string"},"name":{"type":"string"}}},"metric":{"type":"string"},"frequency":{"type":"string"},"observations":{"type":"array","items":{"type":"object","additionalProperties":true}},"limitations":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"409":{"description":"Ambiguous company identifier","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded; retry after the Retry-After interval","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}}}}},"/v1/companies/{id}/corporate-actions":{"get":{"tags":["Corporate actions"],"operationId":"getCorporateActions","summary":"Get corporate-action facts by symbol and date range","description":"Filters by the end or instant of the XBRL reporting period, not the action date. These are filing facts, not a complete event calendar.","parameters":[{"name":"id","in":"path","required":true,"description":"Ticker symbol or SEC CIK","schema":{"type":"string"},"example":"AAPL"},{"name":"from","in":"query","required":false,"description":"Inclusive reported period end date","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"Inclusive reported period end date","schema":{"type":"string","format":"date"}},{"name":"kind","in":"query","required":false,"description":"Fact category","schema":{"type":"string","enum":["split_ratio","dividend_per_share_declared","dividend_per_share_paid","dividends_paid_total"]}},{"name":"cursor","in":"query","required":false,"description":"Cursor returned by a previous page","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","required":["cik","facts","next_cursor"],"properties":{"cik":{"type":"string"},"facts":{"type":"array","items":{"type":"object","additionalProperties":true}},"next_cursor":{"type":["string","null"]},"interpretation":{"type":"string"},"version_semantics":{"type":"string"}}}}}},"400":{"description":"Invalid parameters","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"409":{"description":"Ambiguous company identifier","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"429":{"description":"Rate limit exceeded; retry after the Retry-After interval","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}},"503":{"description":"Service unavailable","content":{"application/json":{"schema":{"type":"object","required":["error","code","message"],"properties":{"error":{"type":"string","description":"Human-readable error message (retained for compatibility)"},"code":{"type":"string","description":"Stable error category"},"message":{"type":"string","description":"Human-readable error message"}},"additionalProperties":true}}}}}}}},"components":{"securitySchemes":{"OAuth":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://ep-proud-butterfly-beqp77bl.neonauth.c-9.us-east-2.aws.neon.tech/neondb/auth/oauth2/authorize","tokenUrl":"https://ep-proud-butterfly-beqp77bl.neonauth.c-9.us-east-2.aws.neon.tech/neondb/auth/oauth2/token","scopes":{"openid":"Identify the registered user"}}},"description":"Authorization code with PKCE. Include resource=https://api.findata.com in both authorization and token requests."},"BearerKey":{"type":"http","scheme":"bearer","description":"Legacy operator key, when configured."}}}}