{"openapi":"3.0.0","info":{"title":"Origin SEC Registry API","version":"1.0.0","description":"AI-readable SEC company data for 8,000+ US public companies. Profiles, stock quotes, earnings transcripts, filing signals, executive career paths, and cross-company search — all with cryptographic provenance from SEC EDGAR filings. Free, no API key required for basic access.","contact":{"name":"Rootz Corp","email":"discover@rootz.global","url":"https://origin.rootz.global"},"license":{"name":"Proprietary — free for AI agent access","url":"https://origin.rootz.global/docs/privacy"}},"servers":[{"url":"https://origin.rootz.global","description":"Production server"}],"paths":{"/api/company/{ticker}":{"get":{"operationId":"getCompanyIdentity","summary":"Company identity card (~200 tokens)","description":"Layer 0: Basic company identity — name, CIK, ticker, exchange, SIC code, status, peak metrics, and links to deeper data layers. Every response includes a cryptographic origin leaf.","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string"},"description":"Stock ticker symbol (e.g., AAPL, NVDA, TSLA) or CIK number","example":"AAPL"}],"responses":{"200":{"description":"Company identity card with origin leaf","content":{"application/json":{"schema":{"type":"object","properties":{"schema":{"type":"string","example":"rootz.ai/sec-company/v1"},"layer":{"type":"integer","example":0},"identity":{"type":"object","properties":{"name":{"type":"string","example":"Apple Inc."},"cik":{"type":"string","example":"0000320193"},"ticker":{"type":"string","example":"AAPL"},"exchange":{"type":"string","example":"Nasdaq"},"sic":{"type":"string","example":"3571"},"sic_description":{"type":"string"},"state_of_incorporation":{"type":"string"},"headquarters":{"type":"string"},"status":{"type":"string","enum":["active","inactive","acquired","delisted"]}}},"summary":{"type":"string","description":"AI-extracted company summary"},"peak_metrics":{"type":"object","properties":{"market_cap_usd":{"type":"number"},"employees":{"type":"integer"}}},"tags":{"type":"array","items":{"type":"string"}},"deeper":{"type":"object","description":"Links to more detailed data layers"},"origin":{"type":"object","description":"Cryptographic provenance leaf — include as parent when citing this data"}}}}}},"404":{"description":"Company not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"ticker":{"type":"string"},"hint":{"type":"string"}}}}}}}}},"/api/company/{ticker}/profile":{"get":{"operationId":"getCompanyProfile","summary":"Full company profile (~800 tokens)","description":"Layer 1: People, products, partnerships, and affiliations extracted from SEC filings.","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string"},"description":"Stock ticker symbol","example":"NVDA"}],"responses":{"200":{"description":"Full company profile with people, products, partnerships","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Company not found"}}}},"/api/company/{ticker}/timeline":{"get":{"operationId":"getCompanyTimeline","summary":"Quarter-by-quarter company history (~2000 tokens)","description":"Layer 2: Timeline events extracted from SEC filings — acquisitions, product launches, leadership changes, financial milestones.","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string"},"description":"Stock ticker symbol","example":"MSFT"}],"responses":{"200":{"description":"Timeline of company events","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Company not found"}}}},"/api/company/{ticker}/filings":{"get":{"operationId":"getCompanyFilings","summary":"SEC filing index with EDGAR links","description":"Layer 3: Index of SEC filings (10-K, 10-Q, 8-K) with accession numbers, EDGAR URLs, and extraction status. Filter by form type.","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string"},"description":"Stock ticker symbol","example":"GOOGL"},{"name":"form","in":"query","required":false,"schema":{"type":"string","enum":["10-K","10-Q","8-K"]},"description":"Filter by filing form type"}],"responses":{"200":{"description":"Filing index with EDGAR links","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Company not found"}}}},"/api/company/{ticker}/quote":{"get":{"operationId":"getStockQuote","summary":"Latest EOD stock quote with provenance","description":"Latest end-of-day stock quote (OHLCV, VWAP, trade count) sourced from SIP consolidated data via Massive.com. Includes cryptographic origin leaf linking to exchange data.","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string"},"description":"Stock ticker symbol","example":"AAPL"}],"responses":{"200":{"description":"Stock quote with OHLCV data and origin leaf","content":{"application/json":{"schema":{"type":"object","properties":{"schema":{"type":"string","example":"rootz.ai/stock-quote/v1"},"ticker":{"type":"string"},"name":{"type":"string"},"quote_date":{"type":"string","format":"date"},"quote":{"type":"object","properties":{"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"integer"},"vwap":{"type":"number"},"trade_count":{"type":"integer"}}},"market_context":{"type":"object","properties":{"market_cap":{"type":"number"},"employees":{"type":"integer"},"shares_outstanding":{"type":"number"}}},"origin":{"type":"object","description":"Cryptographic provenance leaf"}}}}}}}}},"/api/company/{ticker}/quote/history":{"get":{"operationId":"getQuoteHistory","summary":"Historical daily stock quotes","description":"Daily price history with chained origin leaves. Each day links cryptographically to the previous.","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string"},"description":"Stock ticker symbol","example":"TSLA"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":30,"maximum":365},"description":"Number of days to return (max 365)"},{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Start date (YYYY-MM-DD)"}],"responses":{"200":{"description":"Array of daily quotes with origin leaves","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/company/{ticker}/transcripts":{"get":{"operationId":"getTranscripts","summary":"Earnings call transcripts with provenance chain","description":"Earnings call transcripts scraped from company IR sites. Each transcript has a PDF anchor artifact (original evidence), JSON/markdown extractions, indexed speakers, key metrics, and Q&A question counts. Full origin chain: Company IR site (SSL/DNS) > PDF > extractions.","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string"},"description":"Stock ticker symbol","example":"NVDA"}],"responses":{"200":{"description":"Transcript index with provenance data","content":{"application/json":{"schema":{"type":"object","properties":{"schema":{"type":"string","example":"rootz.ai/sec-transcripts/v1"},"ticker":{"type":"string"},"name":{"type":"string"},"transcript_count":{"type":"integer"},"transcripts":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"fiscal_quarter":{"type":"integer"},"fiscal_year":{"type":"integer"},"call_date":{"type":"string"},"speakers":{"type":"array","items":{"type":"string"}},"qa_questions":{"type":"integer"},"key_metrics":{"type":"array","items":{"type":"string"}},"word_count":{"type":"integer"}}}},"origin":{"type":"object"}}}}}},"404":{"description":"Company not found"}}}},"/api/company/{ticker}/facts":{"get":{"operationId":"getCompanyFacts","summary":"Extracted facts from earnings calls","description":"All facts extracted from earnings call transcripts for a company. Filter by fact type (metric, guidance, strategy) or topic (ai, blockchain, quantum).","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string"},"description":"Stock ticker symbol","example":"NVDA"},{"name":"type","in":"query","required":false,"schema":{"type":"string"},"description":"Fact type filter (e.g., metric, guidance, strategy)"},{"name":"topic","in":"query","required":false,"schema":{"type":"string"},"description":"Topic filter (e.g., ai, blockchain, quantum)"}],"responses":{"200":{"description":"Array of extracted facts","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Company not found"}}}},"/api/company/{ticker}/earnings":{"get":{"operationId":"getEarningsCalendar","summary":"Earnings dates — confirmed and predicted","description":"Earnings calendar for a company. Confirmed dates from 8-K filings, predicted dates from historical patterns. Includes recent 8-K filings for context.","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string"},"description":"Stock ticker symbol","example":"AAPL"}],"responses":{"200":{"description":"Earnings history with confirmation status","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/company/{ticker}/people":{"get":{"operationId":"getCompanyPeople","summary":"Key people and their career paths","description":"Executives, board members, and key personnel at a company, with cross-company career paths showing where they worked before and after.","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string"},"description":"Stock ticker symbol","example":"WAVX"}],"responses":{"200":{"description":"People with career paths","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Company not found"}}}},"/api/person/{name}":{"get":{"operationId":"getPersonCareer","summary":"Executive career path across public companies","description":"Full career history for a person across all public companies in the registry. Shows roles, periods, and company status.","parameters":[{"name":"name","in":"path","required":true,"schema":{"type":"string"},"description":"Person name (case-insensitive, partial match supported)","example":"steven sprague"}],"responses":{"200":{"description":"Career path across companies","content":{"application/json":{"schema":{"type":"object","properties":{"schema":{"type":"string","example":"rootz.ai/sec-person/v1"},"person":{"type":"object","properties":{"name":{"type":"string"},"notes":{"type":"string"}}},"career":{"type":"array","items":{"type":"object","properties":{"company":{"type":"string"},"ticker":{"type":"string"},"role":{"type":"string"},"role_type":{"type":"string"},"period":{"type":"string"}}}}}}}}},"404":{"description":"Person not found"}}}},"/api/signals":{"get":{"operationId":"getFilingSignals","summary":"Filing signals from 10-K text analysis","description":"Investment signals extracted from SEC 10-K filing text via pattern matching. Includes capex increases, AI adoption, restructuring, litigation risk, and more. Every signal traces to a specific accession number. Filter by signal type, ticker, exchange, or combine two signal types.","parameters":[{"name":"ticker","in":"query","required":false,"schema":{"type":"string"},"description":"Filter signals for a specific ticker","example":"NVDA"},{"name":"type","in":"query","required":false,"schema":{"type":"string"},"description":"Signal type (e.g., capex_increase, ai_adoption, restructuring)"},{"name":"exchange","in":"query","required":false,"schema":{"type":"string"},"description":"Filter by stock exchange (e.g., Nasdaq, NYSE)"},{"name":"also","in":"query","required":false,"schema":{"type":"string"},"description":"Cross-filter: find companies with BOTH this and the type signal"},{"name":"min_strength","in":"query","required":false,"schema":{"type":"integer"},"description":"Minimum signal strength filter"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"maximum":200},"description":"Maximum results to return"}],"responses":{"200":{"description":"Signal types index (no params) or filtered signal results","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/search":{"get":{"operationId":"searchCompanies","summary":"Cross-company search by keyword","description":"Search across companies, people, and timeline events by keyword. Returns matching companies (by name, summary, tags), people (by name or notes), and timeline events.","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"description":"Search query","example":"artificial intelligence"}],"responses":{"200":{"description":"Search results grouped by type","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"results":{"type":"object","properties":{"companies":{"type":"array","items":{"type":"object"}},"people":{"type":"array","items":{"type":"object"}},"events":{"type":"array","items":{"type":"object"}}}},"total":{"type":"integer"}}}}}},"400":{"description":"Missing q parameter"}}}},"/api/search/transcripts":{"get":{"operationId":"searchTranscripts","summary":"Cross-company transcript topic search","description":"Search earnings call transcripts across companies by topic, speaker, or fact type. Find which companies discussed AI, blockchain, quantum computing, etc.","parameters":[{"name":"topic","in":"query","required":false,"schema":{"type":"string"},"description":"Topic to search (e.g., ai, blockchain, quantum, robotics)","example":"ai"},{"name":"type","in":"query","required":false,"schema":{"type":"string"},"description":"Fact type filter (e.g., metric, guidance)"},{"name":"first","in":"query","required":false,"schema":{"type":"boolean"},"description":"If true, show first-mention date per company"}],"responses":{"200":{"description":"Companies and facts matching the topic","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/verify/{leaf_hash}":{"get":{"operationId":"verifyOriginLeaf","summary":"Verify a cryptographic origin leaf","description":"Verify a SHA-256 origin leaf hash from any Origin API response. Returns a signed verification receipt with nonce for chain-of-custody tracking. Pass prev_nonce to build a verification chain across multiple lookups.","parameters":[{"name":"leaf_hash","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"},"description":"64-character hex SHA-256 leaf hash"},{"name":"prev_nonce","in":"query","required":false,"schema":{"type":"string"},"description":"Previous verification nonce to extend the chain"}],"responses":{"200":{"description":"Signed verification receipt","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid leaf hash format"}}}},"/api/ir/rankings":{"get":{"operationId":"getIRRankings","summary":"AI query rankings — which companies AIs ask about most","description":"Rankings of companies by AI agent query volume. Shows which companies are most queried by ChatGPT, Claude, Gemini, Perplexity, and other AI platforms. Filterable by time period.","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30},"description":"Lookback period in days"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"maximum":500},"description":"Number of companies to return"}],"responses":{"200":{"description":"Ranked list of companies by AI query volume","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/stats":{"get":{"operationId":"getRegistryStats","summary":"Registry statistics and coverage","description":"Overall registry stats — total companies, people, products, partnerships, filings, and 24h AI query counts by platform.","responses":{"200":{"description":"Registry statistics","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/health":{"get":{"operationId":"getHealth","summary":"API health check","description":"Returns API health status, uptime, and database connectivity.","responses":{"200":{"description":"Health status","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["healthy","degraded"]},"uptime_seconds":{"type":"integer"},"timestamp":{"type":"string","format":"date-time"},"db":{"type":"string"}}}}}}}}}},"usage_meta":{"source":"core","current_tier":"free","requests_this_hour":1,"hourly_limit":500,"remaining":499,"agent_type":"claude","validation_required_for_commercial_use":true,"license":"https://github.com/skswave/origin-data/blob/main/LICENSE.md","pricing":"https://origin.rootz.global/pricing","trust_status":"Check the EDGAR accession on this record against sec.gov — that check does not run through us. Response signature and the exact rule: https://origin.rootz.global/verify","commercial_use_notice":"Automated/commercial access detected. Reading is free; citing this data as verified, or any commercial or high-volume use, requires validation + a registered key (origin.rootz.global/dashboard). Unvalidated commercial use is unlicensed.","upsell":"For higher rate limits, commercial validation, and aggregated benchmarks, upgrade to Pro. See origin.rootz.global/pricing","tier_recommendation":"pro"}}