{"openapi":"3.1.0","info":{"title":"FinDataEngine","description":"\n**FinDataEngine** is a live HTTP/JSON REST API serving US company fundamentals\nsourced **exclusively from SEC EDGAR** (public domain, freely redistributable).\n\nIts differentiator is **point-in-time / as-originally-reported** data: every\nreported value is stored with its filing metadata, so you can ask what the\nfinancials looked like *as reported on a given date* — with no lookahead bias.\n\nData is sourced from the U.S. Securities and Exchange Commission (SEC) EDGAR system and is provided for informational purposes only. It is NOT investment advice. See /terms for the full API Terms of Service.\n","version":"0.1.0"},"paths":{"/health":{"get":{"tags":["health"],"summary":"Railway health probe","operationId":"root_health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Root Health Health Get"}}}}}}},"/terms":{"get":{"tags":["meta"],"summary":"Data disclaimer & terms of service","operationId":"terms_terms_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Terms Terms Get"}}}}}}},"/v1/health":{"get":{"tags":["health"],"summary":"Service and database health","operationId":"health_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Health V1 Health Get"}}}}}}},"/v1/companies":{"get":{"tags":["companies"],"summary":"Search/list companies","operationId":"list_companies_v1_companies_get","parameters":[{"name":"ticker","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Exact ticker (case-insensitive)","title":"Ticker"},"description":"Exact ticker (case-insensitive)"},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Substring match on company name","title":"Name"},"description":"Substring match on company name"},{"name":"sic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Exact SIC industry code","title":"Sic"},"description":"Exact SIC industry code"},{"name":"exchange","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Exact exchange (e.g. Nasdaq)","title":"Exchange"},"description":"Exact exchange (e.g. Nasdaq)"},{"name":"format","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"json (default) or csv","title":"Format"},"description":"json (default) or csv"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number","default":1,"title":"Page"},"description":"1-based page number"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Items per page (max 200)","default":50,"title":"Page Size"},"description":"Items per page (max 200)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response List Companies V1 Companies Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{identifier}":{"get":{"tags":["companies"],"summary":"Company profile","operationId":"get_company_v1_companies__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"format","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"json (default) or csv","title":"Format"},"description":"json (default) or csv"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Get Company V1 Companies  Identifier  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{identifier}/fundamentals":{"get":{"tags":["fundamentals"],"summary":"Financial statements (latest/restated values)","operationId":"fundamentals_v1_companies__identifier__fundamentals_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"statement","in":"query","required":false,"schema":{"type":"string","description":"One of: income_statement, balance_sheet, cash_flow","default":"income_statement","title":"Statement"},"description":"One of: income_statement, balance_sheet, cash_flow"},{"name":"period","in":"query","required":false,"schema":{"type":"string","description":"annual or quarterly","default":"annual","title":"Period"},"description":"annual or quarterly"},{"name":"format","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"json (default) or csv","title":"Format"},"description":"json (default) or csv"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Fundamentals V1 Companies  Identifier  Fundamentals Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{identifier}/point-in-time":{"get":{"tags":["point-in-time"],"summary":"Statements as reported on/before a date (no lookahead)","operationId":"point_in_time_v1_companies__identifier__point_in_time_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"as_of","in":"query","required":true,"schema":{"type":"string","description":"ISO date; values as reported on/before this date","title":"As Of"},"description":"ISO date; values as reported on/before this date"},{"name":"statement","in":"query","required":false,"schema":{"type":"string","description":"One of: income_statement, balance_sheet, cash_flow","default":"income_statement","title":"Statement"},"description":"One of: income_statement, balance_sheet, cash_flow"},{"name":"period","in":"query","required":false,"schema":{"type":"string","description":"annual or quarterly","default":"annual","title":"Period"},"description":"annual or quarterly"},{"name":"format","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"json (default) or csv","title":"Format"},"description":"json (default) or csv"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Point In Time V1 Companies  Identifier  Point In Time Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/concepts":{"get":{"tags":["concepts"],"summary":"Concepts catalog","operationId":"list_concepts_v1_concepts_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Substring match on tag or label","title":"Q"},"description":"Substring match on tag or label"},{"name":"taxonomy","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by taxonomy (e.g. us-gaap, dei)","title":"Taxonomy"},"description":"Filter by taxonomy (e.g. us-gaap, dei)"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number","default":1,"title":"Page"},"description":"1-based page number"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Items per page (max 200)","default":50,"title":"Page Size"},"description":"Items per page (max 200)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response List Concepts V1 Concepts Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{identifier}/concepts/{taxonomy}/{tag}":{"get":{"tags":["concepts"],"summary":"Raw concept time series with full filing metadata","operationId":"concept_series_v1_companies__identifier__concepts__taxonomy___tag__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"taxonomy","in":"path","required":true,"schema":{"type":"string","title":"Taxonomy"}},{"name":"tag","in":"path","required":true,"schema":{"type":"string","title":"Tag"}},{"name":"unit","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter to a specific unit (e.g. USD)","title":"Unit"},"description":"Filter to a specific unit (e.g. USD)"},{"name":"format","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"json (default) or csv","title":"Format"},"description":"json (default) or csv"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number","default":1,"title":"Page"},"description":"1-based page number"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Items per page (max 200)","default":50,"title":"Page Size"},"description":"Items per page (max 200)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Concept Series V1 Companies  Identifier  Concepts  Taxonomy   Tag  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/frames/{taxonomy}/{tag}/{unit}/{period}":{"get":{"tags":["frames"],"summary":"One concept across many companies for a period","operationId":"frame_v1_frames__taxonomy___tag___unit___period__get","parameters":[{"name":"taxonomy","in":"path","required":true,"schema":{"type":"string","title":"Taxonomy"}},{"name":"tag","in":"path","required":true,"schema":{"type":"string","title":"Tag"}},{"name":"unit","in":"path","required":true,"schema":{"type":"string","title":"Unit"}},{"name":"period","in":"path","required":true,"schema":{"type":"string","title":"Period"}},{"name":"format","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"json (default) or csv","title":"Format"},"description":"json (default) or csv"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"1-based page number","default":1,"title":"Page"},"description":"1-based page number"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Items per page (max 200)","default":50,"title":"Page Size"},"description":"Items per page (max 200)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Frame V1 Frames  Taxonomy   Tag   Unit   Period  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"},"BearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"ApiKeyHeader":[]},{"BearerAuth":[]}]}