{"openapi": "3.0.3", "info": {"title": "MLQ SEC & Markets API", "version": "v1", "description": "Agent-native, provenance-first access to SEC and US-markets data.\n\n**Every value names its source** \u2014 the exact SEC filing (accession + filing URL) it came from. **Point-in-time** built in: add `?as_of=YYYY-MM-DD` to the financial endpoints (facts, metrics, statements) to get only what was known (filed) on or before that date \u2014 no look-ahead bias.\n\nStatement endpoints use the **familiar camelCase field names common across financial data APIs** and return bare arrays, so switching from another provider is usually a one-line base-URL change \u2014 with provenance no one else carries. Every other list endpoint returns the standard envelope `{count (total matches), returned, offset, results}` and paginates via `limit` + `offset`."}, "servers": [{"url": "https://mlq.ai/api/v1"}], "security": [{"BearerAuth": []}, {"ApiKeyHeader": []}], "components": {"securitySchemes": {"BearerAuth": {"type": "http", "scheme": "bearer", "description": "Send your key as `Authorization: Bearer <key>`."}, "ApiKeyHeader": {"type": "apiKey", "in": "header", "name": "X-API-Key", "description": "Or send your key as `X-API-Key: <key>`."}}}, "tags": [{"name": "Financial Statements", "description": "Income / balance sheet / cash flow \u2014 standard field names, with provenance."}, {"name": "Metrics", "description": "Derived ratios & per-share metrics."}, {"name": "Facts", "description": "Raw normalized XBRL facts."}, {"name": "Companies", "description": "Company search & directory."}, {"name": "Filings", "description": "A company's SEC filing index."}, {"name": "Insider Trading", "description": "Form 4 insider buys & sells, with provenance."}, {"name": "Institutional (13F)", "description": "13F holdings \u2014 who owns what, by stock or by fund."}, {"name": "Feed", "description": "The scored EDGAR firehose \u2014 every filing, materiality-ranked."}, {"name": "Congress", "description": "Congressional stock trades (STOCK Act disclosures)."}, {"name": "Interconnection Queue", "description": "ISO interconnection queue (generation/storage/large-load) + the what-changed feed."}, {"name": "Power Generators", "description": "The as-built US generator fleet (EIA-860) \u2014 operating / planned / retired."}, {"name": "Permits", "description": "Data-center construction + air permits across 150+ US jurisdictions."}, {"name": "Data Centers", "description": "The verified data-center directory \u2014 facilities worldwide, with power, space and connectivity, each verified against an operator source."}], "paths": {"/companies/": {"get": {"tags": ["Companies"], "summary": "Search companies", "description": "Search the tracked universe by ticker or name.", "parameters": [{"name": "q", "in": "query", "schema": {"type": "string"}, "example": "apple"}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 25}}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "default": 0}, "description": "Pagination offset into the full result set (use with limit; `count` is the total)."}], "responses": {"200": {"description": "OK", "content": {"application/json": {"example": {"count": 1, "returned": 1, "offset": 0, "results": [{"ticker": "AAPL", "name": "Apple", "slug": "apple", "cik": "0000320193"}]}, "schema": {"type": "object", "properties": {"count": {"type": "integer", "description": "TOTAL matching rows (not just returned)."}, "returned": {"type": "integer", "description": "Rows in this page."}, "offset": {"type": "integer", "description": "Pagination offset used."}, "results": {"type": "array", "items": {"type": "object", "properties": {"ticker": {"type": "string", "nullable": true, "description": "Ticker."}, "name": {"type": "string", "nullable": true, "description": "Company name."}, "slug": {"type": "string", "nullable": true, "description": "mlq.ai company page slug."}, "cik": {"type": "string", "nullable": true, "description": "SEC CIK (zero-padded)."}}}}}}}}}}}}, "/companies/{ticker}/income-statement/": {"get": {"tags": ["Financial Statements"], "summary": "Income statement", "description": "Income statement, standard camelCase field names, newest first. Each period carries a `source` block.", "parameters": [{"name": "ticker", "in": "path", "required": true, "schema": {"type": "string"}, "example": "AAPL", "description": "Stock ticker (case-insensitive)."}, {"name": "period", "in": "query", "required": false, "schema": {"type": "string", "enum": ["FY", "Q1", "Q2", "Q3", "Q4", "annual", "quarter"]}, "example": "FY", "description": "Reporting period. `annual` = `FY`; `quarter` returns the quarterly series (all quarters, newest first)."}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "default": 5}, "description": "Max periods returned."}, {"name": "as_of", "in": "query", "required": false, "schema": {"type": "string", "format": "date"}, "example": "2024-01-01", "description": "Point-in-time: only data known (filed) on or before this date. No look-ahead bias."}], "responses": {"200": {"description": "OK", "content": {"application/json": {"example": [{"symbol": "AAPL", "cik": "0000320193", "date": "2025-09-27", "fiscalYear": 2025, "period": "FY", "reportedCurrency": "USD", "filingDate": "2025-10-31", "form": "10-K", "revenue": 416161000000.0, "grossProfit": 195201000000.0, "operatingIncome": 133050000000.0, "netIncome": 112010000000.0, "eps": 7.49, "epsDiluted": 7.46, "source": {"accession": "0000320193-25-000079", "filed": "2025-10-31", "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm"}}], "schema": {"type": "array", "items": {"type": "object", "properties": {"symbol": {"type": "string", "nullable": true, "description": "Ticker."}, "cik": {"type": "string", "nullable": true, "description": "SEC CIK."}, "date": {"type": "string", "nullable": true, "description": "Period end date (YYYY-MM-DD)."}, "fiscalYear": {"type": "integer", "description": "Fiscal year (calendar year the period ends in)."}, "period": {"type": "string", "nullable": true, "description": "FY or Q1..Q4."}, "reportedCurrency": {"type": "string", "nullable": true, "description": "Always USD."}, "filingDate": {"type": "string", "nullable": true, "description": "When the source filing was filed."}, "form": {"type": "string", "nullable": true, "description": "Source form (10-K/10-Q; 'derived' for computed Q4 flows)."}, "source": {"type": "object", "description": "Provenance: the exact SEC filing this value came from.", "properties": {"accession": {"type": "string", "nullable": true, "description": "SEC accession number of the source filing."}, "accessions": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}, "description": "All retained source filings, including additive amendments."}, "filed": {"type": "string", "nullable": true, "description": "Date the source filing was filed (YYYY-MM-DD)."}, "filing_url": {"type": "string", "nullable": true, "description": "EDGAR URL of the source filing index."}, "filing_urls": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}}, "doc_url": {"type": "string", "nullable": true, "description": "Direct URL of the source document, when applicable."}}}, "revenue": {"type": "number", "nullable": true, "description": "Total revenue as filed. Banks: net interest income + noninterest income (the standard bank basis \u2014 banks file no single total-revenue line). Utilities: total operating revenues incl. regulated revenue."}, "costOfRevenue": {"type": "number", "nullable": true, "description": "As-filed COGS. Some filers report depreciation separately from COGS; we keep the filed presentation."}, "grossProfit": {"type": "number", "nullable": true, "description": "As-filed (revenue \u2212 filed COGS). May exclude depreciation where the filer presents it separately."}, "researchAndDevelopmentExpenses": {"type": "number", "nullable": true, "description": "Rd expense, USD."}, "sellingGeneralAndAdministrativeExpenses": {"type": "number", "nullable": true, "description": "Sga expense, USD."}, "operatingIncome": {"type": "number", "nullable": true, "description": "As-filed OperatingIncomeLoss \u2014 INCLUDES restructuring/impairment charges (providers that recompute drop them)."}, "depreciationAndAmortization": {"type": "number", "nullable": true, "description": "Depreciation amortization, USD."}, "interestExpense": {"type": "number", "nullable": true, "description": "Interest expense, USD."}, "incomeBeforeTax": {"type": "number", "nullable": true, "description": "Pretax income, USD."}, "incomeTaxExpense": {"type": "number", "nullable": true, "description": "Income tax, USD."}, "netIncome": {"type": "number", "nullable": true, "description": "Net income attributable to the parent (same basis as diluted EPS), before preferred dividends. Derived consolidated\u2212NCI when the filer tags only consolidated figures."}, "eps": {"type": "number", "nullable": true, "description": "Basic EPS as filed."}, "epsDiluted": {"type": "number", "nullable": true, "description": "Diluted EPS as filed."}, "weightedAverageShsOut": {"type": "number", "nullable": true, "description": "Shares basic, USD."}, "weightedAverageShsOutDil": {"type": "number", "nullable": true, "description": "Shares diluted, USD."}, "ebit": {"type": "number", "nullable": true, "description": "Alias of as-filed operating income."}, "ebitda": {"type": "number", "nullable": true, "description": "Operating income + D&A (from as-filed components; not a recomputed EBITDA)."}}}}}}}}}}, "/companies/{ticker}/balance-sheet/": {"get": {"tags": ["Financial Statements"], "summary": "Balance sheet", "description": "Balance sheet, standard camelCase field names. Each period carries a `source` block.", "parameters": [{"name": "ticker", "in": "path", "required": true, "schema": {"type": "string"}, "example": "AAPL", "description": "Stock ticker (case-insensitive)."}, {"name": "period", "in": "query", "required": false, "schema": {"type": "string", "enum": ["FY", "Q1", "Q2", "Q3", "Q4", "annual", "quarter"]}, "example": "FY", "description": "Reporting period. `annual` = `FY`; `quarter` returns the quarterly series (all quarters, newest first)."}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "default": 5}, "description": "Max periods returned."}, {"name": "as_of", "in": "query", "required": false, "schema": {"type": "string", "format": "date"}, "example": "2024-01-01", "description": "Point-in-time: only data known (filed) on or before this date. No look-ahead bias."}], "responses": {"200": {"description": "OK", "content": {"application/json": {"example": [{"symbol": "AAPL", "fiscalYear": 2025, "totalAssets": 331233000000.0, "totalLiabilities": 248493000000.0, "totalStockholdersEquity": 82740000000.0, "source": {"accession": "0000320193-25-000079"}}], "schema": {"type": "array", "items": {"type": "object", "properties": {"symbol": {"type": "string", "nullable": true, "description": "Ticker."}, "cik": {"type": "string", "nullable": true, "description": "SEC CIK."}, "date": {"type": "string", "nullable": true, "description": "Period end date (YYYY-MM-DD)."}, "fiscalYear": {"type": "integer", "description": "Fiscal year (calendar year the period ends in)."}, "period": {"type": "string", "nullable": true, "description": "FY or Q1..Q4."}, "reportedCurrency": {"type": "string", "nullable": true, "description": "Always USD."}, "filingDate": {"type": "string", "nullable": true, "description": "When the source filing was filed."}, "form": {"type": "string", "nullable": true, "description": "Source form (10-K/10-Q; 'derived' for computed Q4 flows)."}, "source": {"type": "object", "description": "Provenance: the exact SEC filing this value came from.", "properties": {"accession": {"type": "string", "nullable": true, "description": "SEC accession number of the source filing."}, "accessions": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}, "description": "All retained source filings, including additive amendments."}, "filed": {"type": "string", "nullable": true, "description": "Date the source filing was filed (YYYY-MM-DD)."}, "filing_url": {"type": "string", "nullable": true, "description": "EDGAR URL of the source filing index."}, "filing_urls": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}}, "doc_url": {"type": "string", "nullable": true, "description": "Direct URL of the source document, when applicable."}}}, "cashAndCashEquivalents": {"type": "number", "nullable": true, "description": "Cash and equivalents, USD."}, "shortTermInvestments": {"type": "number", "nullable": true, "description": "Short term investments, USD."}, "netReceivables": {"type": "number", "nullable": true, "description": "Accounts receivable, USD."}, "inventory": {"type": "number", "nullable": true, "description": "Inventory, USD."}, "totalCurrentAssets": {"type": "number", "nullable": true, "description": "Current assets, USD."}, "propertyPlantEquipmentNet": {"type": "number", "nullable": true, "description": "Property plant equipment, USD."}, "totalAssets": {"type": "number", "nullable": true, "description": "Total assets, USD."}, "accountPayables": {"type": "number", "nullable": true, "description": "Accounts payable, USD."}, "totalCurrentLiabilities": {"type": "number", "nullable": true, "description": "Current liabilities, USD."}, "longTermDebt": {"type": "number", "nullable": true, "description": "Long term debt, USD."}, "totalLiabilities": {"type": "number", "nullable": true, "description": "Total liabilities, USD."}, "totalStockholdersEquity": {"type": "number", "nullable": true, "description": "Parent-only stockholders' equity, EXCLUDING noncontrolling interests (derived consolidated\u2212NCI when needed)."}, "totalDebt": {"type": "number", "nullable": true, "description": "Short-term + long-term debt + finance leases. EXCLUDES operating leases (traditional definition; some providers include them)."}}}}}}}}}}, "/companies/{ticker}/cash-flow/": {"get": {"tags": ["Financial Statements"], "summary": "Cash flow statement", "description": "Cash flow, standard camelCase field names (capex negative). Each period carries a `source` block.", "parameters": [{"name": "ticker", "in": "path", "required": true, "schema": {"type": "string"}, "example": "AAPL", "description": "Stock ticker (case-insensitive)."}, {"name": "period", "in": "query", "required": false, "schema": {"type": "string", "enum": ["FY", "Q1", "Q2", "Q3", "Q4", "annual", "quarter"]}, "example": "FY", "description": "Reporting period. `annual` = `FY`; `quarter` returns the quarterly series (all quarters, newest first)."}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "default": 5}, "description": "Max periods returned."}, {"name": "as_of", "in": "query", "required": false, "schema": {"type": "string", "format": "date"}, "example": "2024-01-01", "description": "Point-in-time: only data known (filed) on or before this date. No look-ahead bias."}], "responses": {"200": {"description": "OK", "content": {"application/json": {"example": [{"symbol": "AAPL", "fiscalYear": 2025, "netCashProvidedByOperatingActivities": 109571000000.0, "capitalExpenditure": -12030000000.0, "freeCashFlow": 97541000000.0, "source": {"accession": "0000320193-25-000079"}}], "schema": {"type": "array", "items": {"type": "object", "properties": {"symbol": {"type": "string", "nullable": true, "description": "Ticker."}, "cik": {"type": "string", "nullable": true, "description": "SEC CIK."}, "date": {"type": "string", "nullable": true, "description": "Period end date (YYYY-MM-DD)."}, "fiscalYear": {"type": "integer", "description": "Fiscal year (calendar year the period ends in)."}, "period": {"type": "string", "nullable": true, "description": "FY or Q1..Q4."}, "reportedCurrency": {"type": "string", "nullable": true, "description": "Always USD."}, "filingDate": {"type": "string", "nullable": true, "description": "When the source filing was filed."}, "form": {"type": "string", "nullable": true, "description": "Source form (10-K/10-Q; 'derived' for computed Q4 flows)."}, "source": {"type": "object", "description": "Provenance: the exact SEC filing this value came from.", "properties": {"accession": {"type": "string", "nullable": true, "description": "SEC accession number of the source filing."}, "accessions": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}, "description": "All retained source filings, including additive amendments."}, "filed": {"type": "string", "nullable": true, "description": "Date the source filing was filed (YYYY-MM-DD)."}, "filing_url": {"type": "string", "nullable": true, "description": "EDGAR URL of the source filing index."}, "filing_urls": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}}, "doc_url": {"type": "string", "nullable": true, "description": "Direct URL of the source document, when applicable."}}}, "netIncome": {"type": "number", "nullable": true, "description": "Net income attributable to the parent (same basis as diluted EPS), before preferred dividends. Derived consolidated\u2212NCI when the filer tags only consolidated figures."}, "depreciationAndAmortization": {"type": "number", "nullable": true, "description": "Depreciation amortization, USD."}, "stockBasedCompensation": {"type": "number", "nullable": true, "description": "Stock based comp, USD."}, "netCashProvidedByOperatingActivities": {"type": "number", "nullable": true, "description": "Operating cash flow, USD."}, "dividendsPaid": {"type": "number", "nullable": true, "description": "Dividends paid, USD."}, "capitalExpenditure": {"type": "number", "nullable": true, "description": "PP&E capex, NEGATIVE (an outflow, per standard API convention). We store the as-reported figure; capitalized software is not included."}, "freeCashFlow": {"type": "number", "nullable": true, "description": "Operating cash flow \u2212 capex."}}}}}}}}}}, "/companies/{ticker}/metrics/": {"get": {"tags": ["Metrics"], "summary": "Derived metrics", "description": "Margins, returns, liquidity, leverage, per-share \u2014 computed from the same point-in-time facts.", "parameters": [{"name": "ticker", "in": "path", "required": true, "schema": {"type": "string"}, "example": "AAPL", "description": "Stock ticker (case-insensitive)."}, {"name": "period", "in": "query", "required": false, "schema": {"type": "string", "enum": ["FY", "Q1", "Q2", "Q3", "Q4"]}, "example": "FY", "description": "Reporting period."}, {"name": "as_of", "in": "query", "required": false, "schema": {"type": "string", "format": "date"}, "example": "2024-01-01", "description": "Point-in-time: only data known (filed) on or before this date. No look-ahead bias."}, {"name": "fiscal_year", "in": "query", "schema": {"type": "integer"}, "example": 2025}], "responses": {"200": {"description": "OK", "content": {"application/json": {"example": {"company": {"ticker": "AAPL"}, "fiscal_year": 2025, "metrics": {"gross_margin": 0.469, "return_on_equity": 1.52, "net_margin": 0.269}, "source": {"accession": "0000320193-25-000079"}}, "schema": {"type": "object", "properties": {"company": {"type": "object", "properties": {"ticker": {"type": "string", "nullable": true, "description": "Ticker."}, "name": {"type": "string", "nullable": true, "description": "Company name."}, "slug": {"type": "string", "nullable": true, "description": "mlq.ai company page slug."}, "cik": {"type": "string", "nullable": true, "description": "SEC CIK (zero-padded)."}}}, "fiscal_year": {"type": "integer"}, "period": {"type": "string", "nullable": true, "description": "FY or Q1..Q4."}, "metrics": {"type": "object", "description": "~50 derived ratios (margins, returns, leverage, liquidity, per-share, turnover). Price-dependent metrics are null by design (no price feed). Field-by-field definitions: /api/methodology/. Notable: ROIC uses textbook invested capital (debt+equity\u2212cash); debt ratios exclude operating leases; EBITDA = as-filed OI + D&A.", "additionalProperties": {"type": "number", "nullable": true}}, "source": {"type": "object", "description": "Provenance: the exact SEC filing this value came from.", "properties": {"accession": {"type": "string", "nullable": true, "description": "SEC accession number of the source filing."}, "accessions": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}, "description": "All retained source filings, including additive amendments."}, "filed": {"type": "string", "nullable": true, "description": "Date the source filing was filed (YYYY-MM-DD)."}, "filing_url": {"type": "string", "nullable": true, "description": "EDGAR URL of the source filing index."}, "filing_urls": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}}, "doc_url": {"type": "string", "nullable": true, "description": "Direct URL of the source document, when applicable."}}}}}}}}}}}, "/companies/{ticker}/facts/": {"get": {"tags": ["Facts"], "summary": "Raw XBRL facts", "description": "Every normalized concept for a company \u2014 provenance on each value.", "parameters": [{"name": "ticker", "in": "path", "required": true, "schema": {"type": "string"}, "example": "AAPL", "description": "Stock ticker (case-insensitive)."}, {"name": "period", "in": "query", "required": false, "schema": {"type": "string", "enum": ["FY", "Q1", "Q2", "Q3", "Q4"]}, "example": "FY", "description": "Reporting period."}, {"name": "as_of", "in": "query", "required": false, "schema": {"type": "string", "format": "date"}, "example": "2024-01-01", "description": "Point-in-time: only data known (filed) on or before this date. No look-ahead bias."}], "responses": {"200": {"description": "OK", "content": {"application/json": {"example": {"company": {"ticker": "AAPL"}, "count": 1, "facts": [{"concept": "revenue", "value": 416161000000.0, "fiscal_year": 2025, "fiscal_period": "FY", "source": {"accession": "0000320193-25-000079"}}]}, "schema": {"type": "object", "properties": {"company": {"type": "object", "properties": {"ticker": {"type": "string", "nullable": true, "description": "Ticker."}, "name": {"type": "string", "nullable": true, "description": "Company name."}, "slug": {"type": "string", "nullable": true, "description": "mlq.ai company page slug."}, "cik": {"type": "string", "nullable": true, "description": "SEC CIK (zero-padded)."}}}, "period": {"type": "string", "nullable": true, "description": "FY/Q1..Q4 or 'all'."}, "as_of": {"type": "string", "nullable": true, "description": "Point-in-time cutoff applied, if any."}, "count": {"type": "integer"}, "facts": {"type": "array", "items": {"type": "object", "properties": {"concept": {"type": "string", "nullable": true, "description": "Canonical concept key (see /api/methodology/ dictionary)."}, "value": {"type": "number", "nullable": true, "description": ""}, "unit": {"type": "string", "nullable": true, "description": "USD, shares, or USD/share."}, "fiscal_year": {"type": "integer"}, "fiscal_period": {"type": "string", "nullable": true, "description": "FY or Q1..Q4."}, "period_end": {"type": "string", "nullable": true, "description": ""}, "form": {"type": "string", "nullable": true, "description": ""}, "filed": {"type": "string", "nullable": true, "description": ""}, "source_tag": {"type": "string", "nullable": true, "description": "The us-gaap XBRL tag (or derivation) the value came from."}, "source": {"type": "object", "description": "Provenance: the exact SEC filing this value came from.", "properties": {"accession": {"type": "string", "nullable": true, "description": "SEC accession number of the source filing."}, "accessions": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}, "description": "All retained source filings, including additive amendments."}, "filed": {"type": "string", "nullable": true, "description": "Date the source filing was filed (YYYY-MM-DD)."}, "filing_url": {"type": "string", "nullable": true, "description": "EDGAR URL of the source filing index."}, "filing_urls": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}}, "doc_url": {"type": "string", "nullable": true, "description": "Direct URL of the source document, when applicable."}}}}}}}}}}}}}}, "/companies/{ticker}/filings/": {"get": {"tags": ["Filings"], "summary": "Company filings", "description": "A company's SEC filing index with deep links.", "parameters": [{"name": "ticker", "in": "path", "required": true, "schema": {"type": "string"}, "example": "AAPL", "description": "Stock ticker (case-insensitive)."}, {"name": "form", "in": "query", "schema": {"type": "string"}, "example": "10-K"}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 50}}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "default": 0}, "description": "Pagination offset into the full result set (use with limit; `count` is the total)."}], "responses": {"200": {"description": "OK", "content": {"application/json": {"example": {"company": {"ticker": "AAPL"}, "count": 1, "returned": 1, "offset": 0, "results": [{"form": "10-K", "filed": "2025-10-31", "accession": "0000320193-25-000079", "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/"}]}, "schema": {"type": "object", "properties": {"count": {"type": "integer", "description": "TOTAL matching rows (not just returned)."}, "returned": {"type": "integer", "description": "Rows in this page."}, "offset": {"type": "integer", "description": "Pagination offset used."}, "results": {"type": "array", "items": {"type": "object", "properties": {"form": {"type": "string", "nullable": true, "description": "Form type (10-K, 8-K, 4, \u2026)."}, "filed": {"type": "string", "nullable": true, "description": ""}, "report_date": {"type": "string", "nullable": true, "description": ""}, "accession": {"type": "string", "nullable": true, "description": ""}, "description": {"type": "string", "nullable": true, "description": ""}, "items": {"type": "string", "nullable": true, "description": "8-K item codes."}, "primary_doc_url": {"type": "string", "nullable": true, "description": ""}, "filing_url": {"type": "string", "nullable": true, "description": ""}}}}, "company": {"type": "object", "properties": {"ticker": {"type": "string", "nullable": true, "description": "Ticker."}, "name": {"type": "string", "nullable": true, "description": "Company name."}, "slug": {"type": "string", "nullable": true, "description": "mlq.ai company page slug."}, "cik": {"type": "string", "nullable": true, "description": "SEC CIK (zero-padded)."}}}}}}}}}}}, "/companies/{ticker}/insider-trades/": {"get": {"tags": ["Insider Trading"], "summary": "Insider transactions", "description": "Form 4 insider buys/sells for a company, newest first. Each row carries a `source` block.", "parameters": [{"name": "ticker", "in": "path", "required": true, "schema": {"type": "string"}, "example": "AAPL", "description": "Stock ticker (case-insensitive)."}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 100}}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "default": 0}, "description": "Pagination offset into the full result set (use with limit; `count` is the total)."}], "responses": {"200": {"description": "OK", "content": {"application/json": {"example": {"count": 412, "returned": 1, "offset": 0, "results": [{"symbol": "AAPL", "transactionDate": "2025-10-03", "reportingName": "COOK TIMOTHY D", "reportingTitle": "CEO", "transactionType": "S", "acquiredDisposed": "D", "shares": 100000.0, "pricePerShare": 255.0, "value": 25500000.0, "source": {"accession": "0000320193-25-000110"}}]}, "schema": {"type": "object", "properties": {"count": {"type": "integer", "description": "TOTAL matching rows (not just returned)."}, "returned": {"type": "integer", "description": "Rows in this page."}, "offset": {"type": "integer", "description": "Pagination offset used."}, "results": {"type": "array", "items": {"type": "object", "properties": {"symbol": {"type": "string", "nullable": true, "description": "Issuer ticker."}, "filingDate": {"type": "string", "nullable": true, "description": "Form 4 filing date."}, "transactionDate": {"type": "string", "nullable": true, "description": "Trade date."}, "reportingName": {"type": "string", "nullable": true, "description": "Insider name."}, "reportingTitle": {"type": "string", "nullable": true, "description": "Officer title, when reported."}, "isDirector": {"type": "boolean"}, "isOfficer": {"type": "boolean"}, "isTenPercentOwner": {"type": "boolean"}, "securityTitle": {"type": "string", "nullable": true, "description": "Security transacted."}, "transactionType": {"type": "string", "nullable": true, "description": "Form 4 code: P=buy, S=sell, A=grant, M=exercise, G=gift, F=tax."}, "acquiredDisposed": {"type": "string", "nullable": true, "description": "A or D."}, "isDerivative": {"type": "boolean"}, "shares": {"type": "number", "nullable": true, "description": "Shares in this line."}, "pricePerShare": {"type": "number", "nullable": true, "description": ""}, "value": {"type": "number", "nullable": true, "description": "shares \u00d7 price."}, "sharesOwnedAfter": {"type": "number", "nullable": true, "description": "Holdings after the transaction."}, "source": {"type": "object", "description": "Provenance: the exact SEC filing this value came from.", "properties": {"accession": {"type": "string", "nullable": true, "description": "SEC accession number of the source filing."}, "accessions": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}, "description": "All retained source filings, including additive amendments."}, "filed": {"type": "string", "nullable": true, "description": "Date the source filing was filed (YYYY-MM-DD)."}, "filing_url": {"type": "string", "nullable": true, "description": "EDGAR URL of the source filing index."}, "filing_urls": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}}, "doc_url": {"type": "string", "nullable": true, "description": "Direct URL of the source document, when applicable."}}}}}}}}}}}}}}, "/companies/{ticker}/institutional-ownership/": {"get": {"tags": ["Institutional (13F)"], "summary": "Institutional ownership (by stock)", "description": "Funds holding this ticker as of the latest 13F period, one row per fund (multi-manager rows summed), largest first. Equity rows only by default \u2014 `include_options=true` adds put/call/note rows, labeled via `putCall`/`sharesType` (option-underlying shares and note principal are never mixed into equity share counts).", "parameters": [{"name": "ticker", "in": "path", "required": true, "schema": {"type": "string"}, "example": "AAPL", "description": "Stock ticker (case-insensitive)."}, {"name": "period", "in": "query", "required": false, "schema": {"type": "string", "format": "date"}, "example": "2025-03-31", "description": "13F report quarter end. Defaults to the latest available complete period."}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 100}}, {"name": "include_options", "in": "query", "schema": {"type": "boolean", "default": false}, "description": "Include put/call and principal (PRN) rows as separate labeled rows."}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "default": 0}, "description": "Pagination offset into the full result set (use with limit; `count` is the total)."}], "responses": {"200": {"description": "OK", "content": {"application/json": {"example": {"symbol": "AAPL", "periodOfReport": "2025-03-31", "count": 5817, "returned": 1, "offset": 0, "results": [{"symbol": "AAPL", "periodOfReport": "2025-03-31", "investorName": "VANGUARD GROUP INC", "investorCik": "0000102909", "shares": 1380000000.0, "value": 306000000000.0, "sharesType": "SH", "putCall": "", "source": {"accession": "0000102909-25-000123"}}]}, "schema": {"type": "object", "properties": {"count": {"type": "integer", "description": "TOTAL matching rows (not just returned)."}, "returned": {"type": "integer", "description": "Rows in this page."}, "offset": {"type": "integer", "description": "Pagination offset used."}, "results": {"type": "array", "items": {"type": "object", "properties": {"symbol": {"type": "string", "nullable": true, "description": ""}, "periodOfReport": {"type": "string", "nullable": true, "description": "13F quarter end."}, "investorName": {"type": "string", "nullable": true, "description": "Fund name."}, "investorCik": {"type": "string", "nullable": true, "description": "Filer CIK."}, "shares": {"type": "number", "nullable": true, "description": "Shares held (equity rows) / underlying shares (option rows) / principal (PRN)."}, "value": {"type": "number", "nullable": true, "description": "Position value, USD."}, "sharesType": {"type": "string", "nullable": true, "description": "SH (shares) or PRN (principal amount \u2014 notes/bonds)."}, "putCall": {"type": "string", "nullable": true, "description": "'' = equity, 'Put' or 'Call' = option position (underlying share count)."}, "votingAuthority": {"type": "object", "properties": {"sole": {"type": "number", "nullable": true, "description": "Shares with sole voting authority."}, "shared": {"type": "number", "nullable": true, "description": "Shares with shared voting authority."}, "none": {"type": "number", "nullable": true, "description": "Shares with no voting authority."}}}, "source": {"type": "object", "description": "Provenance: the exact SEC filing this value came from.", "properties": {"accession": {"type": "string", "nullable": true, "description": "SEC accession number of the source filing."}, "accessions": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}, "description": "All retained source filings, including additive amendments."}, "filed": {"type": "string", "nullable": true, "description": "Date the source filing was filed (YYYY-MM-DD)."}, "filing_url": {"type": "string", "nullable": true, "description": "EDGAR URL of the source filing index."}, "filing_urls": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}}, "doc_url": {"type": "string", "nullable": true, "description": "Direct URL of the source document, when applicable."}}}}}}, "symbol": {"type": "string", "nullable": true, "description": ""}, "periodOfReport": {"type": "string", "nullable": true, "description": "13F quarter end."}, "availablePeriods": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}}}}}}}}}}, "/funds/{cik}/holdings/": {"get": {"tags": ["Institutional (13F)"], "summary": "Fund holdings (by filer)", "description": "A 13F filer's portfolio as of its latest filing, one row per security (multi-manager rows summed), largest position first. Equity, puts, calls, and notes are separate rows labeled via `putCall`/`sharesType`.", "parameters": [{"name": "cik", "in": "path", "required": true, "schema": {"type": "string"}, "example": "1067983", "description": "The filer's SEC CIK (e.g. Berkshire = 1067983)."}, {"name": "period", "in": "query", "required": false, "schema": {"type": "string", "format": "date"}, "example": "2025-03-31", "description": "13F report quarter end. Defaults to the latest available complete period."}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 100}}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "default": 0}, "description": "Pagination offset into the full result set (use with limit; `count` is the total)."}], "responses": {"200": {"description": "OK", "content": {"application/json": {"example": {"investorName": "BERKSHIRE HATHAWAY INC", "investorCik": "1067983", "periodOfReport": "2025-03-31", "count": 29, "returned": 1, "offset": 0, "results": [{"symbol": "AAPL", "issuerName": "APPLE INC", "cusip": "037833100", "shares": 300000000.0, "value": 66000000000.0, "sharesType": "SH", "putCall": "", "source": {"accession": "0001067983-25-000050"}}]}, "schema": {"type": "object", "properties": {"count": {"type": "integer", "description": "TOTAL matching rows (not just returned)."}, "returned": {"type": "integer", "description": "Rows in this page."}, "offset": {"type": "integer", "description": "Pagination offset used."}, "results": {"type": "array", "items": {"type": "object", "properties": {"symbol": {"type": "string", "nullable": true, "description": "Ticker when the CUSIP maps to a covered company, else null."}, "issuerName": {"type": "string", "nullable": true, "description": "Issuer name as filed."}, "cusip": {"type": "string", "nullable": true, "description": ""}, "figi": {"type": "string", "nullable": true, "description": "OpenFIGI identifier when supplied in the filing."}, "shares": {"type": "number", "nullable": true, "description": ""}, "value": {"type": "number", "nullable": true, "description": "USD (normalized: pre-2023 filings were $thousands)."}, "sharesType": {"type": "string", "nullable": true, "description": "SH or PRN."}, "putCall": {"type": "string", "nullable": true, "description": "'' equity / Put / Call \u2014 separate labeled rows."}, "investmentDiscretion": {"type": "string", "nullable": true, "description": "SOLE, DFND, or OTR as filed."}, "otherManager": {"type": "string", "nullable": true, "description": "Other included-manager sequence number(s), as filed."}, "votingAuthority": {"type": "object", "properties": {"sole": {"type": "number", "nullable": true, "description": "Shares with sole voting authority."}, "shared": {"type": "number", "nullable": true, "description": "Shares with shared voting authority."}, "none": {"type": "number", "nullable": true, "description": "Shares with no voting authority."}}}, "source": {"type": "object", "description": "Provenance: the exact SEC filing this value came from.", "properties": {"accession": {"type": "string", "nullable": true, "description": "SEC accession number of the source filing."}, "accessions": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}, "description": "All retained source filings, including additive amendments."}, "filed": {"type": "string", "nullable": true, "description": "Date the source filing was filed (YYYY-MM-DD)."}, "filing_url": {"type": "string", "nullable": true, "description": "EDGAR URL of the source filing index."}, "filing_urls": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}}, "doc_url": {"type": "string", "nullable": true, "description": "Direct URL of the source document, when applicable."}}}}}}, "investorName": {"type": "string", "nullable": true, "description": ""}, "investorCik": {"type": "string", "nullable": true, "description": ""}, "periodOfReport": {"type": "string", "nullable": true, "description": ""}, "availablePeriods": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}}}}}}}}}}, "/funds/{cik}/periods/": {"get": {"tags": ["Institutional (13F)"], "summary": "Available fund periods", "description": "Every available 13F report period for a filer, newest first.", "parameters": [{"name": "cik", "in": "path", "required": true, "schema": {"type": "string"}}], "responses": {"200": {"description": "OK", "content": {"application/json": {"example": {"investorName": "BERKSHIRE HATHAWAY INC", "investorCik": "1067983", "count": 13, "periods": ["2026-03-31", "2025-12-31"]}, "schema": {"type": "object", "properties": {"investorName": {"type": "string", "nullable": true, "description": ""}, "investorCik": {"type": "string", "nullable": true, "description": ""}, "count": {"type": "integer"}, "periods": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}}}}}}}}}}, "/funds/{cik}/changes/": {"get": {"tags": ["Institutional (13F)"], "summary": "Fund position changes", "description": "Position-level changes between a selected 13F quarter and the immediately prior available quarter.", "parameters": [{"name": "cik", "in": "path", "required": true, "schema": {"type": "string"}}, {"name": "period", "in": "query", "required": false, "schema": {"type": "string", "format": "date"}, "example": "2025-03-31", "description": "13F report quarter end. Defaults to the latest available complete period."}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 100}}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "default": 0}, "description": "Pagination offset into the full result set (use with limit; `count` is the total)."}], "responses": {"200": {"description": "OK", "content": {"application/json": {"example": {"investorName": "BERKSHIRE HATHAWAY INC", "currentPeriod": "2025-12-31", "previousPeriod": "2025-09-30", "count": 1, "returned": 1, "offset": 0, "results": [{"symbol": "AAPL", "changeType": "decreased", "currentShares": 200000000, "previousShares": 300000000, "sharesChange": -100000000}]}, "schema": {"type": "object", "properties": {"count": {"type": "integer", "description": "TOTAL matching rows (not just returned)."}, "returned": {"type": "integer", "description": "Rows in this page."}, "offset": {"type": "integer", "description": "Pagination offset used."}, "results": {"type": "array", "items": {"type": "object", "properties": {"symbol": {"type": "string", "nullable": true, "description": ""}, "issuerName": {"type": "string", "nullable": true, "description": ""}, "cusip": {"type": "string", "nullable": true, "description": ""}, "putCall": {"type": "string", "nullable": true, "description": ""}, "sharesType": {"type": "string", "nullable": true, "description": ""}, "changeType": {"type": "string", "nullable": true, "description": "new, exited, increased, decreased, or unchanged."}, "currentShares": {"type": "number", "nullable": true, "description": ""}, "previousShares": {"type": "number", "nullable": true, "description": ""}, "sharesChange": {"type": "number", "nullable": true, "description": ""}, "currentValue": {"type": "number", "nullable": true, "description": ""}, "previousValue": {"type": "number", "nullable": true, "description": ""}, "valueChange": {"type": "number", "nullable": true, "description": ""}}}}, "investorName": {"type": "string", "nullable": true, "description": ""}, "investorCik": {"type": "string", "nullable": true, "description": ""}, "currentPeriod": {"type": "string", "nullable": true, "description": ""}, "previousPeriod": {"type": "string", "nullable": true, "description": ""}, "availablePeriods": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}}, "currentSource": {"type": "object", "description": "Provenance: the exact SEC filing this value came from.", "properties": {"accession": {"type": "string", "nullable": true, "description": "SEC accession number of the source filing."}, "accessions": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}, "description": "All retained source filings, including additive amendments."}, "filed": {"type": "string", "nullable": true, "description": "Date the source filing was filed (YYYY-MM-DD)."}, "filing_url": {"type": "string", "nullable": true, "description": "EDGAR URL of the source filing index."}, "filing_urls": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}}, "doc_url": {"type": "string", "nullable": true, "description": "Direct URL of the source document, when applicable."}}}, "previousSource": {"type": "object", "description": "Provenance: the exact SEC filing this value came from.", "properties": {"accession": {"type": "string", "nullable": true, "description": "SEC accession number of the source filing."}, "accessions": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}, "description": "All retained source filings, including additive amendments."}, "filed": {"type": "string", "nullable": true, "description": "Date the source filing was filed (YYYY-MM-DD)."}, "filing_url": {"type": "string", "nullable": true, "description": "EDGAR URL of the source filing index."}, "filing_urls": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}}, "doc_url": {"type": "string", "nullable": true, "description": "Direct URL of the source document, when applicable."}}}}}}}}}}}, "/feed/": {"get": {"tags": ["Feed"], "summary": "Scored filings feed", "description": "The EDGAR firehose, materiality-scored. Filter by tier/category/form/ticker/min_score/since; tracked=true limits to companies in our universe.", "parameters": [{"name": "tier", "in": "query", "schema": {"type": "string", "enum": ["high", "medium", "low"]}}, {"name": "category", "in": "query", "schema": {"type": "string"}, "description": "Form family: annual/quarterly/current/ownership/13f/beneficial/prospectus/proxy/other."}, {"name": "form", "in": "query", "schema": {"type": "string"}, "example": "8-K"}, {"name": "ticker", "in": "query", "schema": {"type": "string"}}, {"name": "tracked", "in": "query", "schema": {"type": "boolean"}, "description": "true = only filings by companies in our tracked universe."}, {"name": "min_score", "in": "query", "schema": {"type": "integer"}, "description": "Minimum materiality score (0-100)."}, {"name": "since", "in": "query", "schema": {"type": "string", "format": "date"}}, {"name": "sort", "in": "query", "schema": {"type": "string", "enum": ["recent", "material"]}, "description": "material = most material first (materiality also accepted)."}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 50}}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "default": 0}, "description": "Pagination offset into the full result set (use with limit; `count` is the total)."}], "responses": {"200": {"description": "OK", "content": {"application/json": {"example": {"count": 184223, "returned": 1, "offset": 0, "results": [{"form": "8-K", "filed": "2025-10-31", "filer": {"ticker": "AAPL", "name": "Apple"}, "materiality": {"score": 80, "tier": "high", "reason": "Results of operations (earnings)"}}]}, "schema": {"type": "object", "properties": {"count": {"type": "integer", "description": "TOTAL matching rows (not just returned)."}, "returned": {"type": "integer", "description": "Rows in this page."}, "offset": {"type": "integer", "description": "Pagination offset used."}, "results": {"type": "array", "items": {"type": "object", "properties": {"accession": {"type": "string", "nullable": true, "description": ""}, "form": {"type": "string", "nullable": true, "description": ""}, "category": {"type": "string", "nullable": true, "description": "annual/quarterly/current/ownership/13f/\u2026"}, "items": {"type": "string", "nullable": true, "description": "8-K item codes."}, "filed": {"type": "string", "nullable": true, "description": ""}, "filer": {"type": "object", "properties": {"name": {"type": "string", "nullable": true, "description": ""}, "cik": {"type": "string", "nullable": true, "description": ""}, "ticker": {"type": "string", "nullable": true, "description": "Set when the filer is in our tracked universe."}, "tracked": {"type": "boolean"}}}, "materiality": {"type": "object", "properties": {"score": {"type": "integer", "description": "0-100 rule-based materiality."}, "tier": {"type": "string", "nullable": true, "description": "high/medium/low."}, "reason": {"type": "string", "nullable": true, "description": ""}}}, "source_url": {"type": "string", "nullable": true, "description": ""}, "filing_url": {"type": "string", "nullable": true, "description": ""}}}}}}}}}}}}, "/congress-trades/": {"get": {"tags": ["Congress"], "summary": "Congressional stock trades", "description": "Every disclosed buy/sell by a member of Congress (STOCK Act), newest first, with the source filing. Filter by ticker / member / chamber / type / state / since.", "parameters": [{"name": "ticker", "in": "query", "schema": {"type": "string"}, "example": "NVDA"}, {"name": "member", "in": "query", "schema": {"type": "string"}, "example": "Pelosi"}, {"name": "chamber", "in": "query", "schema": {"type": "string", "enum": ["House", "Senate"]}}, {"name": "type", "in": "query", "schema": {"type": "string", "enum": ["purchase", "sale", "exchange"]}}, {"name": "state", "in": "query", "schema": {"type": "string"}, "example": "CA"}, {"name": "owner", "in": "query", "schema": {"type": "string"}, "description": "Who holds the asset: self / spouse / joint / dependent."}, {"name": "since", "in": "query", "schema": {"type": "string", "format": "date"}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 100}}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "default": 0}, "description": "Pagination offset into the full result set (use with limit; `count` is the total)."}], "responses": {"200": {"description": "OK", "content": {"application/json": {"example": {"count": 2305, "returned": 1, "offset": 0, "results": [{"chamber": "House", "member": "Matthew Robert Van Epps", "state": "TN", "ticker": "NVDA", "transaction_type": "sale", "transaction_date": "2026-06-16", "disclosure_date": "2026-06-18", "amount_range": "$1,001 - $15,000", "amount_min": 1001, "amount_max": 15000, "source": {"doc_id": "20034567", "url": "https://disclosures-clerk.house.gov/..."}}]}, "schema": {"type": "object", "properties": {"count": {"type": "integer", "description": "TOTAL matching rows (not just returned)."}, "returned": {"type": "integer", "description": "Rows in this page."}, "offset": {"type": "integer", "description": "Pagination offset used."}, "results": {"type": "array", "items": {"type": "object", "properties": {"id": {"type": "string", "nullable": true, "description": "Stable row id."}, "chamber": {"type": "string", "nullable": true, "description": "House (Senate planned)."}, "member": {"type": "string", "nullable": true, "description": ""}, "state": {"type": "string", "nullable": true, "description": ""}, "district": {"type": "string", "nullable": true, "description": ""}, "party": {"type": "string", "nullable": true, "description": "Not yet populated."}, "ticker": {"type": "string", "nullable": true, "description": ""}, "asset_name": {"type": "string", "nullable": true, "description": "As printed on the PTR."}, "asset_type": {"type": "string", "nullable": true, "description": ""}, "transaction_type": {"type": "string", "nullable": true, "description": "purchase/sale/exchange."}, "partial": {"type": "boolean"}, "owner": {"type": "string", "nullable": true, "description": "self/spouse/joint/dependent."}, "transaction_date": {"type": "string", "nullable": true, "description": ""}, "disclosure_date": {"type": "string", "nullable": true, "description": ""}, "amount_range": {"type": "string", "nullable": true, "description": "STOCK Act ranges, not exact amounts."}, "amount_min": {"type": "number", "nullable": true, "description": ""}, "amount_max": {"type": "number", "nullable": true, "description": ""}, "cap_gains_over_200": {"type": "boolean"}, "source": {"type": "object", "description": "Provenance: the exact SEC filing this value came from.", "properties": {"accession": {"type": "string", "nullable": true, "description": "SEC accession number of the source filing."}, "accessions": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}, "description": "All retained source filings, including additive amendments."}, "filed": {"type": "string", "nullable": true, "description": "Date the source filing was filed (YYYY-MM-DD)."}, "filing_url": {"type": "string", "nullable": true, "description": "EDGAR URL of the source filing index."}, "filing_urls": {"type": "array", "items": {"type": "string", "nullable": true, "description": ""}}, "doc_url": {"type": "string", "nullable": true, "description": "Direct URL of the source document, when applicable."}}}}}}}}}}}}}}, "/interconnection-queue/": {"get": {"tags": ["Interconnection Queue"], "summary": "Interconnection queue", "description": "Generation / storage / large-load interconnection requests across the 7 US ISOs, largest capacity first. Each row carries its source.", "parameters": [{"name": "iso", "in": "query", "schema": {"type": "string", "enum": ["PJM", "MISO", "CAISO", "NYISO", "SPP", "ISONE", "ERCOT"]}}, {"name": "state", "in": "query", "schema": {"type": "string"}, "example": "TX"}, {"name": "fuel", "in": "query", "schema": {"type": "string"}, "example": "Natural Gas"}, {"name": "status", "in": "query", "schema": {"type": "string"}}, {"name": "load_type", "in": "query", "schema": {"type": "string"}, "example": "generation"}, {"name": "operator", "in": "query", "schema": {"type": "string"}}, {"name": "data_center", "in": "query", "schema": {"type": "boolean"}, "description": "Only requests inferred to be data-center load."}, {"name": "min_mw", "in": "query", "schema": {"type": "number"}, "example": 100}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 100}}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "default": 0}, "description": "Pagination offset into the full result set (use with limit; `count` is the total)."}], "responses": {"200": {"description": "OK", "content": {"application/json": {"example": {"count": 152, "returned": 1, "results": [{"id": "pjm-ac1-067", "iso": "PJM", "queue_number": "AC1-067", "state": "IL", "fuel": "Natural Gas", "load_type": "generation", "status": "Active", "capacity_mw": 1200, "data_center": true, "source": {"api": "pjm", "url": "https://www.pjm.com/planning/services-requests/interconnection-queues"}}]}, "schema": {"type": "object", "properties": {"count": {"type": "integer", "description": "TOTAL matching rows (not just returned)."}, "returned": {"type": "integer", "description": "Rows in this page."}, "offset": {"type": "integer", "description": "Pagination offset used."}, "results": {"type": "array", "items": {"type": "object", "properties": {"id": {"type": "string", "nullable": true, "description": "Stable row id."}, "iso": {"type": "string", "nullable": true, "description": "PJM/MISO/CAISO/NYISO/SPP/ISONE/ERCOT."}, "queue_number": {"type": "string", "nullable": true, "description": "The ISO's queue position id."}, "project_name": {"type": "string", "nullable": true, "description": ""}, "interconnecting_entity": {"type": "string", "nullable": true, "description": ""}, "operator": {"type": "string", "nullable": true, "description": ""}, "developer": {"type": "string", "nullable": true, "description": ""}, "company_id": {"type": "string", "nullable": true, "description": "Set when mapped to a covered company."}, "state": {"type": "string", "nullable": true, "description": ""}, "county": {"type": "string", "nullable": true, "description": ""}, "poi_location": {"type": "string", "nullable": true, "description": "Point of interconnection."}, "transmission_owner": {"type": "string", "nullable": true, "description": ""}, "fuel": {"type": "string", "nullable": true, "description": ""}, "load_type": {"type": "string", "nullable": true, "description": "generation/load/storage."}, "technology": {"type": "string", "nullable": true, "description": ""}, "status": {"type": "string", "nullable": true, "description": "Active/Withdrawn/In service/\u2026"}, "study_phase": {"type": "string", "nullable": true, "description": ""}, "capacity_mw": {"type": "number", "nullable": true, "description": "Requested capacity, MW."}, "projected_cod": {"type": "string", "nullable": true, "description": "Projected commercial operation date."}, "queue_date": {"type": "string", "nullable": true, "description": ""}, "data_center": {"type": "boolean", "description": "Inferred data-center load."}, "source": {"type": "object", "description": "ISO source feed + document."}}}}}}}}}}}}, "/interconnection-queue/changes/": {"get": {"tags": ["Interconnection Queue"], "summary": "Queue changes feed", "description": "Status / capacity / timeline / fuel transitions in the queue, newest first \u2014 the 'what changed' stream.", "parameters": [{"name": "iso", "in": "query", "schema": {"type": "string"}}, {"name": "change", "in": "query", "schema": {"type": "string", "enum": ["status", "capacity", "timeline", "fuel"]}}, {"name": "since", "in": "query", "schema": {"type": "string", "format": "date"}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 100}}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "default": 0}, "description": "Pagination offset into the full result set (use with limit; `count` is the total)."}], "responses": {"200": {"description": "OK", "content": {"application/json": {"example": {"count": 11132, "returned": 1, "results": [{"iso": "ERCOT", "queue_id": "ercot-21inr0326", "change": "status", "changed_fields": ["status", "capacity_mw"], "project_name": "Dove Run Solar", "previous": {"status": "Active", "capacity_mw": 120.86}, "current": {"status": "Withdrawn"}}]}, "schema": {"type": "object", "properties": {"count": {"type": "integer", "description": "TOTAL matching rows (not just returned)."}, "returned": {"type": "integer", "description": "Rows in this page."}, "offset": {"type": "integer", "description": "Pagination offset used."}, "results": {"type": "array", "items": {"type": "object", "properties": {"iso": {"type": "string", "nullable": true, "description": ""}, "queue_id": {"type": "string", "nullable": true, "description": ""}, "recorded_at": {"type": "string", "nullable": true, "description": "When we detected the change."}, "change": {"type": "string", "nullable": true, "description": "status/capacity/timeline/fuel."}, "changed_fields": {"type": "string", "nullable": true, "description": ""}, "project_name": {"type": "string", "nullable": true, "description": ""}, "previous": {"type": "object", "description": "Field values before the change."}, "current": {"type": "object", "description": "Snapshot after the change."}}}}}}}}}}}}, "/operating-generators/": {"get": {"tags": ["Power Generators"], "summary": "Operating power generators", "description": "The as-built US generator fleet (EIA-860, every plant >= 1 MW), largest capacity first. Defaults to operating; pass status= or all=1 for the full lifecycle. The operating counterpart to the interconnection queue (planned).", "parameters": [{"name": "state", "in": "query", "schema": {"type": "string"}, "example": "TX"}, {"name": "fuel", "in": "query", "schema": {"type": "string"}, "example": "Natural Gas"}, {"name": "status", "in": "query", "schema": {"type": "string", "enum": ["Operating", "Planned", "Under Construction", "Standby", "Retired", "Cancelled"]}}, {"name": "utility", "in": "query", "schema": {"type": "string"}}, {"name": "operator", "in": "query", "schema": {"type": "string"}}, {"name": "ba", "in": "query", "schema": {"type": "string"}, "description": "Balancing authority code."}, {"name": "min_mw", "in": "query", "schema": {"type": "number"}, "example": 100}, {"name": "all", "in": "query", "schema": {"type": "boolean"}, "description": "Include all statuses, not just operating."}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 100}}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "default": 0}, "description": "Pagination offset into the full result set (use with limit; `count` is the total)."}], "responses": {"200": {"description": "OK", "content": {"application/json": {"example": {"count": 24662, "returned": 1, "results": [{"id": "eia-6008-1", "plant_name": "Palo Verde", "state": "AZ", "fuel": "Nuclear", "nameplate_capacity_mw": 1414.0, "status": "Operating", "operating_year": 1986, "utility_name": "Arizona Public Service Co", "source": {"api": "eia-860-annual", "url": "https://www.eia.gov/electricity/data/eia860/"}}]}, "schema": {"type": "object", "properties": {"count": {"type": "integer", "description": "TOTAL matching rows (not just returned)."}, "returned": {"type": "integer", "description": "Rows in this page."}, "offset": {"type": "integer", "description": "Pagination offset used."}, "results": {"type": "array", "items": {"type": "object", "properties": {"id": {"type": "string", "nullable": true, "description": ""}, "plant_code": {"type": "string", "nullable": true, "description": "EIA plant code."}, "generator_id": {"type": "string", "nullable": true, "description": ""}, "plant_name": {"type": "string", "nullable": true, "description": ""}, "utility_name": {"type": "string", "nullable": true, "description": ""}, "operator": {"type": "string", "nullable": true, "description": ""}, "state": {"type": "string", "nullable": true, "description": ""}, "county": {"type": "string", "nullable": true, "description": ""}, "latitude": {"type": "number", "nullable": true, "description": ""}, "longitude": {"type": "number", "nullable": true, "description": ""}, "balancing_authority": {"type": "string", "nullable": true, "description": ""}, "nerc_region": {"type": "string", "nullable": true, "description": ""}, "fuel": {"type": "string", "nullable": true, "description": ""}, "technology": {"type": "string", "nullable": true, "description": ""}, "nameplate_capacity_mw": {"type": "number", "nullable": true, "description": ""}, "summer_capacity_mw": {"type": "number", "nullable": true, "description": ""}, "winter_capacity_mw": {"type": "number", "nullable": true, "description": ""}, "status": {"type": "string", "nullable": true, "description": "Operating/Planned/Retired/Under Construction/Standby/Cancelled."}, "operating_year": {"type": "number", "nullable": true, "description": ""}, "planned_retirement_year": {"type": "number", "nullable": true, "description": ""}, "retirement_year": {"type": "number", "nullable": true, "description": ""}, "source": {"type": "object", "description": "EIA-860 vintage + URL."}}}}}}}}}}}}, "/permits/": {"get": {"tags": ["Permits"], "summary": "Data-center permits", "description": "Data-center construction + air permits across 150+ US jurisdictions, newest first.", "parameters": [{"name": "state", "in": "query", "schema": {"type": "string"}, "example": "VA"}, {"name": "county", "in": "query", "schema": {"type": "string"}}, {"name": "jurisdiction", "in": "query", "schema": {"type": "string"}}, {"name": "operator", "in": "query", "schema": {"type": "string"}, "example": "Microsoft"}, {"name": "category", "in": "query", "schema": {"type": "string"}}, {"name": "status", "in": "query", "schema": {"type": "string"}}, {"name": "since", "in": "query", "schema": {"type": "string", "format": "date"}}, {"name": "q", "in": "query", "schema": {"type": "string"}, "description": "Free-text search."}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 100}}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "default": 0}, "description": "Pagination offset into the full result set (use with limit; `count` is the total)."}], "responses": {"200": {"description": "OK", "content": {"application/json": {"example": {"count": 4264, "returned": 1, "results": [{"id": "atlanta-ga-fire-inspect-26-02539", "permit_number": "FIRE-INSPECT-26-02539", "jurisdiction": "Atlanta, GA", "county": "Fulton County", "state": "GA", "operator": "Digital Realty", "category": "commercial", "status": "Ready to Invoice", "opened_date": "2026-06-02", "application_name": "DIGITAL REALTY - 250 Williams ST", "source": {"api": "atlanta-ga-accela-globalsearch", "url": null}}]}, "schema": {"type": "object", "properties": {"count": {"type": "integer", "description": "TOTAL matching rows (not just returned)."}, "returned": {"type": "integer", "description": "Rows in this page."}, "offset": {"type": "integer", "description": "Pagination offset used."}, "results": {"type": "array", "items": {"type": "object", "properties": {"id": {"type": "string", "nullable": true, "description": ""}, "permit_number": {"type": "string", "nullable": true, "description": ""}, "permit_type": {"type": "string", "nullable": true, "description": ""}, "category": {"type": "string", "nullable": true, "description": "construction/air/\u2026"}, "status": {"type": "string", "nullable": true, "description": ""}, "facility_phase": {"type": "string", "nullable": true, "description": ""}, "application_name": {"type": "string", "nullable": true, "description": ""}, "applicant": {"type": "string", "nullable": true, "description": ""}, "operator": {"type": "string", "nullable": true, "description": "Normalized operator (e.g. Microsoft)."}, "project_name": {"type": "string", "nullable": true, "description": ""}, "company_id": {"type": "string", "nullable": true, "description": ""}, "jurisdiction": {"type": "string", "nullable": true, "description": ""}, "county": {"type": "string", "nullable": true, "description": ""}, "state": {"type": "string", "nullable": true, "description": ""}, "property_address": {"type": "string", "nullable": true, "description": ""}, "construction_value": {"type": "number", "nullable": true, "description": "Stated construction value, USD (may repeat across permit rows of one project)."}, "total_square_feet": {"type": "number", "nullable": true, "description": ""}, "power_mw": {"type": "number", "nullable": true, "description": ""}, "opened_date": {"type": "string", "nullable": true, "description": ""}, "finaled_date": {"type": "string", "nullable": true, "description": ""}, "description_of_work": {"type": "string", "nullable": true, "description": ""}, "source": {"type": "object", "description": "Jurisdiction portal + URL."}}}}}}}}}}}}, "/data-centers/": {"get": {"tags": ["Data Centers"], "summary": "Verified data-center directory", "description": "Data-center facilities worldwide, largest first by power capacity. Every row is verified against an operator source (site page or spec sheet). power_mw is published on ~39% of facilities \u2014 null means unpublished, not zero.", "parameters": [{"name": "country", "in": "query", "schema": {"type": "string"}, "example": "USA"}, {"name": "state", "in": "query", "schema": {"type": "string"}}, {"name": "city", "in": "query", "schema": {"type": "string"}}, {"name": "region", "in": "query", "schema": {"type": "string"}, "example": "North America"}, {"name": "operator", "in": "query", "schema": {"type": "string"}, "example": "Equinix"}, {"name": "company_id", "in": "query", "schema": {"type": "string"}}, {"name": "status", "in": "query", "schema": {"type": "string"}, "example": "operational"}, {"name": "facility_type", "in": "query", "schema": {"type": "string"}, "example": "colocation"}, {"name": "min_mw", "in": "query", "schema": {"type": "number"}, "description": "Only facilities with published power_mw at or above this."}, {"name": "ai_ready", "in": "query", "schema": {"type": "boolean"}}, {"name": "q", "in": "query", "schema": {"type": "string"}, "description": "Free-text search."}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 100}}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "integer", "default": 0}, "description": "Pagination offset into the full result set (use with limit; `count` is the total)."}], "responses": {"200": {"description": "OK", "content": {"application/json": {"example": {"count": 5634, "returned": 1, "results": [{"id": "vantage-tx1-albany", "name": "Shackelford County (TX1)", "operator": "Vantage", "operator_slug": "vantage", "company_id": "vantage-data-centers", "status": "under_construction", "facility_type": "colocation", "tier": null, "location": {"street_address": "Highway 604 and Highway 351", "city": "Albany", "state": "Texas", "postal_code": null, "country": "USA", "region": "North America", "lat": 32.7234, "lng": -99.2975}, "power_mw": 1400.0, "power_density_kw": 250.0, "ai_ready": true, "verified_at": "2026-06-03T11:35:27.392079+00:00", "source": {"name": "Vantage Data Centers", "url": "https://vantage-dc.com/data-center-campus/texas-albany/", "spec_sheet": null}}]}, "schema": {"type": "object", "properties": {"count": {"type": "integer", "description": "TOTAL matching rows (not just returned)."}, "returned": {"type": "integer", "description": "Rows in this page."}, "offset": {"type": "integer", "description": "Pagination offset used."}, "results": {"type": "array", "items": {"type": "object", "properties": {"id": {"type": "string", "nullable": true, "description": ""}, "name": {"type": "string", "nullable": true, "description": ""}, "operator": {"type": "string", "nullable": true, "description": "Normalized operator (e.g. Equinix)."}, "operator_slug": {"type": "string", "nullable": true, "description": ""}, "company_id": {"type": "string", "nullable": true, "description": ""}, "status": {"type": "string", "nullable": true, "description": "operational / under_construction / planned / verified / \u2026"}, "facility_type": {"type": "string", "nullable": true, "description": "colocation / hyperscale / \u2026"}, "tier": {"type": "string", "nullable": true, "description": "Uptime tier, where published."}, "location": {"type": "object", "description": "Address, country/region, and lat/lng where known."}, "power_mw": {"type": "number", "nullable": true, "description": "Critical IT load in MW. Published on ~39% of facilities; null means unknown, not zero."}, "power_density_kw": {"type": "number", "nullable": true, "description": "Per-rack density, kW."}, "generator_capacity_kw": {"type": "number", "nullable": true, "description": ""}, "renewable_energy_pct": {"type": "number", "nullable": true, "description": ""}, "sqft": {"type": "number", "nullable": true, "description": "Whitespace area."}, "total_building_sqft": {"type": "number", "nullable": true, "description": ""}, "year_opened": {"type": "number", "nullable": true, "description": ""}, "ai_ready": {"type": "boolean", "nullable": true, "description": "Tri-state: null means not assessed, not False."}, "liquid_cooling": {"type": "boolean", "nullable": true, "description": "Tri-state: null means unknown."}, "cooling_redundancy": {"type": "string", "nullable": true, "description": "e.g. N+1"}, "ups_redundancy": {"type": "string", "nullable": true, "description": "e.g. 2N"}, "uptime_sla": {"type": "string", "nullable": true, "description": ""}, "certifications": {"type": "array", "items": {"type": "string"}}, "cloud_onramps": {"type": "array", "items": {"type": "string"}}, "internet_exchanges": {"type": "array", "items": {"type": "string"}}, "verified_at": {"type": "string", "nullable": true, "description": "When we last verified this record against its source."}, "source": {"type": "object", "description": "Operator page / spec sheet the record was verified from."}}}}}}}}}}}}}}