{"openapi":"3.1.0","info":{"title":"FilingFirehose API","description":"Structured, normalized SEC EDGAR filings — including 8-K body-text parsing that goes beyond filer-reported items. See https://filingfirehose.com.","version":"0.1.0"},"paths":{"/v1/billing/stripe-webhook":{"post":{"tags":["billing"],"summary":"Stripe Webhook","description":"Verify Stripe's signature, then dispatch on event type.\n\nOn signature failure we return 400 (Stripe will retry). On unknown event\ntypes we 200 OK to keep their delivery queue clean.","operationId":"stripe_webhook_v1_billing_stripe_webhook_post","parameters":[{"name":"Stripe-Signature","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe-Signature"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/public/8k":{"get":{"tags":["public"],"summary":"Public 8K","description":"Recent 8-K filings, past 72 hours. Free + open.","operationId":"public_8k_v1_public_8k_get","parameters":[{"name":"items","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated 8-K item codes (e.g., '1.05,5.02')","title":"Items"},"description":"Comma-separated 8-K item codes (e.g., '1.05,5.02')"},{"name":"suspected_buried_only","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Suspected Buried Only"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/public/13d":{"get":{"tags":["public"],"summary":"Public 13D","description":"Recent Schedule 13D / 13G filings, past 72 hours.","operationId":"public_13d_v1_public_13d_get","parameters":[{"name":"activist","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activist"}},{"name":"min_percent","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":100,"minimum":0},{"type":"null"}],"title":"Min Percent"}},{"name":"include_amendments","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Amendments"}},{"name":"include_passive_13g","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Passive 13G"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/public/atm":{"get":{"tags":["public"],"summary":"Public Atm","description":"Recent ATM offerings (S-3 / 424B5), past 72 hours.","operationId":"public_atm_v1_public_atm_get","parameters":[{"name":"sales_agent","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sales Agent"}},{"name":"min_shelf_million_usd","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Min Shelf Million Usd"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/health":{"get":{"tags":["meta"],"summary":"Health","operationId":"health_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Health V1 Health Get"}}}}}}},"/v1/filings/8-k":{"get":{"tags":["filings"],"summary":"Get 8K Filings","operationId":"get_8k_filings_v1_filings_8_k_get","parameters":[{"name":"items","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated 8-K item codes to filter on. Example: `1.05,5.02,8.01`. Filtering uses the union of filer_reported_items and detected_items.","title":"Items"},"description":"Comma-separated 8-K item codes to filter on. Example: `1.05,5.02,8.01`. Filtering uses the union of filer_reported_items and detected_items."},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"ISO-format YYYY-MM-DD lower bound on filed_at.","title":"Since"},"description":"ISO-format YYYY-MM-DD lower bound on filed_at."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/s3":{"get":{"tags":["filings"],"summary":"Get S3 Filings","operationId":"get_s3_filings_v1_filings_s3_get","parameters":[{"name":"is_atm","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter to ATM-flagged filings only.","title":"Is Atm"},"description":"Filter to ATM-flagged filings only."},{"name":"min_shelf_size_million","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Min Shelf Size Million"}},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Since"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"form_type","in":"query","required":false,"schema":{"type":"string","description":"Form type to scan. Default '424B5' (ATM takedowns).","default":"424B5","title":"Form Type"},"description":"Form type to scan. Default '424B5' (ATM takedowns)."},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/13d":{"get":{"tags":["filings"],"summary":"Get 13 Filings","operationId":"get_13_filings_v1_filings_13d_get","parameters":[{"name":"activist","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter to filings where this activist appears (substring match).","title":"Activist"},"description":"Filter to filings where this activist appears (substring match)."},{"name":"min_percent","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":100,"minimum":0},{"type":"null"}],"title":"Min Percent"}},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Since"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}},{"name":"form_type","in":"query","required":false,"schema":{"type":"string","description":"Form type to scan. Default 'SCHEDULE 13D'.","default":"SCHEDULE 13D","title":"Form Type"},"description":"Form type to scan. Default 'SCHEDULE 13D'."},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"Filing13":{"properties":{"accession_number":{"type":"string","title":"Accession Number","examples":["0001493152-26-022034"]},"form_type":{"type":"string","title":"Form Type","examples":["8-K"]},"cik":{"type":"string","title":"Cik","examples":["1648087"]},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name","examples":["AMERICAN REBEL HOLDINGS INC"]},"filed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filed At","examples":["2026-05-08T17:28:33-04:00"]},"cusip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cusip"},"aggregate_amount":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Aggregate Amount"},"percent_of_class":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percent Of Class"},"activist_filers":{"items":{"type":"string"},"type":"array","title":"Activist Filers"},"purpose_excerpt":{"type":"string","title":"Purpose Excerpt","default":""}},"type":"object","required":["accession_number","form_type","cik"],"title":"Filing13","description":"Parsed Schedule 13D / 13G."},"Filing8K":{"properties":{"accession_number":{"type":"string","title":"Accession Number","examples":["0001493152-26-022034"]},"form_type":{"type":"string","title":"Form Type","examples":["8-K"]},"cik":{"type":"string","title":"Cik","examples":["1648087"]},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name","examples":["AMERICAN REBEL HOLDINGS INC"]},"filed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filed At","examples":["2026-05-08T17:28:33-04:00"]},"filer_reported_items":{"items":{"type":"string"},"type":"array","title":"Filer Reported Items","examples":[["1.01","9.01"]]},"detected_items":{"items":{"type":"string"},"type":"array","title":"Detected Items","examples":[["1.01","1.05","9.01"]]},"discrepancy_items":{"items":{"type":"string"},"type":"array","title":"Discrepancy Items","description":"Items present in the body but not reported by the filer."},"suspected_buried_events":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","title":"Suspected Buried Events","description":"Map of reported_item → suspected real items, based on body keywords.","examples":[{"8.01":["1.05"]}]},"num_sections":{"type":"integer","title":"Num Sections","default":0}},"type":"object","required":["accession_number","form_type","cik"],"title":"Filing8K","description":"Parsed 8-K. The wedge: `discrepancy_items` shows what the body contains\nbut the filer didn't report. That's the alpha."},"FilingS3":{"properties":{"accession_number":{"type":"string","title":"Accession Number","examples":["0001493152-26-022034"]},"form_type":{"type":"string","title":"Form Type","examples":["8-K"]},"cik":{"type":"string","title":"Cik","examples":["1648087"]},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name","examples":["AMERICAN REBEL HOLDINGS INC"]},"filed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filed At","examples":["2026-05-08T17:28:33-04:00"]},"shelf_size_usd":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Shelf Size Usd"},"shelf_size_million_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Shelf Size Million Usd"},"is_atm":{"type":"boolean","title":"Is Atm","default":false},"sales_agents":{"items":{"type":"string"},"type":"array","title":"Sales Agents"},"use_of_proceeds_excerpt":{"type":"string","title":"Use Of Proceeds Excerpt","default":""}},"type":"object","required":["accession_number","form_type","cik"],"title":"FilingS3","description":"Parsed S-3 / 424B-family registration / takedown."},"FilingsResponse":{"properties":{"count":{"type":"integer","title":"Count"},"filings":{"anyOf":[{"items":{"$ref":"#/components/schemas/Filing8K"},"type":"array"},{"items":{"$ref":"#/components/schemas/FilingS3"},"type":"array"},{"items":{"$ref":"#/components/schemas/Filing13"},"type":"array"}],"title":"Filings"}},"type":"object","required":["count","filings"],"title":"FilingsResponse","description":"Envelope returned by /v1/filings endpoints."},"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"}}}}