{"openapi":"3.1.0","info":{"title":"Edgrapi","description":"Clean company financial statements & ratios from SEC EDGAR XBRL data — income statement, balance sheet, cash flow, and computed ratios, normalized to consistent JSON across companies and years.","contact":{"name":"Edgrapi","url":"https://edgrapi.com/"},"license":{"name":"Proprietary"},"version":"1.0.0"},"paths":{"/v1/keys":{"post":{"tags":["meta"],"summary":"Create Free Key","description":"Self-serve: mint a free-tier API key (throttled per IP).","operationId":"create_free_key_v1_keys_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"tags":["meta"],"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/company/{ticker}":{"get":{"tags":["fundamentals"],"summary":"Company","operationId":"company_v1_company__ticker__get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","description":"Stock ticker, e.g. AAPL","title":"Ticker"},"description":"Stock ticker, e.g. AAPL"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fundamentals/{ticker}":{"get":{"tags":["fundamentals"],"summary":"Fundamentals","operationId":"fundamentals_v1_fundamentals__ticker__get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","description":"Stock ticker, e.g. AAPL","title":"Ticker"},"description":"Stock ticker, e.g. AAPL"},{"name":"period","in":"query","required":false,"schema":{"type":"string","pattern":"^(annual|quarterly)$","default":"annual","title":"Period"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":5,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ratios/{ticker}":{"get":{"tags":["fundamentals"],"summary":"Ratios","operationId":"ratios_v1_ratios__ticker__get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","description":"Stock ticker, e.g. AAPL","title":"Ticker"},"description":"Stock ticker, e.g. AAPL"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/{ticker}":{"get":{"tags":["filings"],"summary":"Filings","operationId":"filings_v1_filings__ticker__get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","description":"Stock ticker, e.g. AAPL","title":"Ticker"},"description":"Stock ticker, e.g. AAPL"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"form","in":"query","required":false,"schema":{"type":"string","description":"Filter by form, e.g. 10-K","title":"Form"},"description":"Filter by form, e.g. 10-K"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sections/{ticker}":{"get":{"tags":["filings"],"summary":"Filing Sections","description":"Narrative sections from the latest 10-K/10-Q as clean text (Risk Factors,\nMD&A, Business, etc.) — built for LLM/RAG equity research.","operationId":"filing_sections_v1_sections__ticker__get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","description":"Stock ticker, e.g. AAPL","title":"Ticker"},"description":"Stock ticker, e.g. AAPL"},{"name":"form","in":"query","required":false,"schema":{"type":"string","description":"Filing type: 10-K or 10-Q","default":"10-K","title":"Form"},"description":"Filing type: 10-K or 10-Q"},{"name":"item","in":"query","required":false,"schema":{"type":"string","description":"Section to fetch, e.g. 1A (Risk Factors) or 7 (MD&A). Omit to list available sections.","title":"Item"},"description":"Section to fetch, e.g. 1A (Risk Factors) or 7 (MD&A). Omit to list available sections."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"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"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"tags":[{"name":"fundamentals","description":"Financial statements & ratios."},{"name":"filings","description":"Filing history."},{"name":"meta","description":"Health & discovery."}]}