Every API here is available over the APIs.io API and to AI agents over MCP.
{
"openapi": "3.1.0",
"info": {
"title": "Edgar & Edgarette SEC Filing Boards",
"version": "2.1.0",
"summary": "The ad-free record of what US public companies file with the SEC: every 8-K event the business day after it is filed, from the settled SEC daily index, an actuarial card for any filer, and a forecast ledger scored in public. No ads, no login, no paywall, no key. CC BY 4.0.",
"description": "The only open source of SEC filings that publishes every corporate event the business day after it is filed, from the settled SEC daily index, reads every filer the way an actuary would, and hashes its forecasts before the outcome is known. No advertising, no trackers, no paywall; the house that publishes it pays for it. Twelve boards built from United States SEC filings, one per 8-K item or form the filer declared, every row linked to its filing on sec.gov. A company card for any SEC filer read from its own audited XBRL facts: revenue, growth, margins, free cash flow, Altman Z, Piotroski F, Beneish M, and an 80% revenue range for next year that is hashed before the outcome is known and scored when the next annual report arrives. Reporting, not investment advice. Every reply carries the licence and a source link per row. DOI 10.5281/zenodo.23672509.",
"termsOfService": "https://www.pops4.com/boards/license",
"contact": {"name": "POPS4 (Hako Shikin LLC)", "email": "jenny@pops4.com", "url": "https://www.pops4.com/boards/for-ai"},
"license": {"name": "CC BY 4.0", "identifier": "CC-BY-4.0", "url": "https://creativecommons.org/licenses/by/4.0/"}
},
"servers": [{"url": "https://www.pops4.com/boards", "description": "Production, Cloudflare edge, no auth"}],
"tags": [
{"name": "boards", "description": "What was filed, by event"},
{"name": "companies", "description": "Who they are, from their own filings"},
{"name": "ledger", "description": "What we said before we knew"},
{"name": "status", "description": "Freshness and counting"}
],
"paths": {
"/all.json": {
"get": {
"operationId": "listBoards", "tags": ["boards"],
"summary": "List every board with its question, scope and row count",
"description": "Start here. Returns the twelve boards, each with key, title, SEC scope and current row count, plus the licence, the field dictionary link and the generation time.",
"responses": {"200": {"description": "Board index", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/BoardIndex"}}}}}
}
},
"/{board}.json": {
"get": {
"operationId": "getBoard", "tags": ["boards"],
"summary": "Rows of one board: which companies filed this event, newest first",
"description": "Opens with the board's question and a dated one-line answer, then rows. Each row is one SEC filing with company facts and a link to the filing on sec.gov. Use limit to fetch the whole board.",
"parameters": [
{"name": "board", "in": "path", "required": true, "schema": {"$ref": "#/components/schemas/BoardKey"}},
{"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "maximum": 5000, "default": 50}, "description": "Rows to return. The reply reports total, returned and truncated."}
],
"responses": {"200": {"description": "Board rows", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Board"}}}}}
}
},
"/{board}.csv": {
"get": {
"operationId": "getBoardCsv", "tags": ["boards"],
"summary": "The same board as CSV",
"parameters": [
{"name": "board", "in": "path", "required": true, "schema": {"$ref": "#/components/schemas/BoardKey"}},
{"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "minimum": 1, "maximum": 5000}}
],
"responses": {"200": {"description": "CSV rows", "content": {"text/csv": {"schema": {"type": "string"}}}}}
}
},
"/ask.json": {
"get": {
"operationId": "getCompanyCard", "tags": ["companies"],
"summary": "Edgar & Edgarette card for any SEC filer, by name, ticker or CIK",
"description": "Returns the card (schema pops4.edgarette.card/1): last filings, audited metrics, Altman Z, Piotroski F, Beneish M, peers, the 80% revenue range and its registry entry, the backtest, and plain-language lines from Edgar (what was filed) and Edgarette (what the numbers say). Add price to get price-based ratios computed from a price you supply; the service stores no prices.",
"parameters": [
{"name": "q", "in": "query", "required": true, "schema": {"type": "string"}, "description": "Company name, ticker or CIK, e.g. PEP or PepsiCo or 77476"},
{"name": "price", "in": "query", "required": false, "schema": {"type": "number"}, "description": "Optional share price you supply, for P/E, P/B, P/S, yield and market value"}
],
"responses": {"200": {"description": "Company card", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/CompanyCard"}}}}}
}
},
"/company/{cik}.json": {
"get": {
"operationId": "getCompanyCardByCik", "tags": ["companies"],
"summary": "The same card by CIK or ticker, as served on the company page",
"parameters": [{"name": "cik", "in": "path", "required": true, "schema": {"type": "string"}, "description": "SEC CIK or ticker"}],
"responses": {"200": {"description": "Company card", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/CompanyCard"}}}}}
}
},
"/brand/{ticker}.json": {
"get": {
"operationId": "getBrandRecord", "tags": ["companies"],
"summary": "Brand record: every name a filer has used with the SEC, with dates, and its brand-moving 8-K filings",
"parameters": [{"name": "ticker", "in": "path", "required": true, "schema": {"type": "string"}}],
"responses": {"200": {"description": "Brand record with a citation line", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}}
}
},
"/watch.json": {
"get": {
"operationId": "watchCompany", "tags": ["companies"],
"summary": "Feed links to follow a company's SEC filings; nothing is stored, no email is sent",
"parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string"}}],
"responses": {"200": {"description": "Atom feed link plus the card", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}}
}
},
"/etf/{ticker}.json": {
"get": {
"operationId": "getEtfHealth", "tags": ["companies"],
"summary": "Look through a US ETF to its latest N-PORT holdings, each matched to its SEC filer, with warning signs and the share of the fund each touches",
"parameters": [{"name": "ticker", "in": "path", "required": true, "schema": {"type": "string"}, "description": "e.g. QQQ, SPY, XLF"}],
"responses": {"200": {"description": "ETF read. Stock funds only; coverage.covered is false for others.", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}}
}
},
"/portfolio.json": {
"get": {
"operationId": "getPortfolioHealthByCik", "tags": ["companies"],
"summary": "Read a 13F filer's whole portfolio through SEC filings",
"parameters": [{"name": "cik", "in": "query", "required": true, "schema": {"type": "string"}, "description": "The 13F filer's CIK or name, e.g. a pension fund"}],
"responses": {"200": {"description": "Portfolio read, schema pops4.edgar.portfolio/1", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}}
},
"post": {
"operationId": "getPortfolioHealth", "tags": ["companies"],
"summary": "Read a pasted portfolio through SEC filings; holdings are never stored",
"requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"holdings": {"type": "array", "items": {"type": "object", "properties": {"ticker": {"type": "string"}, "weight": {"type": "number"}}, "required": ["ticker"]}}}, "required": ["holdings"]}}}},
"responses": {"200": {"description": "Portfolio read", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}}
}
},
"/scorecard.json": {
"get": {
"operationId": "getForecastRegistry", "tags": ["ledger"],
"summary": "Every 80% range logged, its hash, and how it scored",
"responses": {"200": {"description": "Forecast registry", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}}
}
},
"/board-test.json": {
"get": {
"operationId": "getBoardTest", "tags": ["ledger"],
"summary": "The boards' own calls locked at the 6 Oct 2026 close with a SHA-256 receipt, scored against what happened",
"responses": {"200": {"description": "Board test", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}}
}
},
"/status.json": {
"get": {
"operationId": "getStatus", "tags": ["status"],
"summary": "Freshness: state, newest filing, last logged and scored, ledger counts, and today's SHA-256 seal",
"responses": {"200": {"description": "Status", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Status"}}}}}
}
},
"/engagement.json": {
"get": {
"operationId": "getEngagement", "tags": ["status"],
"summary": "People and AI on the boards today, counted separately, never added",
"responses": {"200": {"description": "Counts for the UTC day so far", "content": {"application/json": {"schema": {"type": "object", "properties": {"day": {"type": "string"}, "people": {"type": "integer"}, "ai": {"type": "integer"}}}}}}}
}
},
"/fields.json": {
"get": {
"operationId": "getFieldDictionary", "tags": ["status"],
"summary": "What every board field means and where it is read from",
"responses": {"200": {"description": "Field dictionary", "content": {"application/json": {"schema": {"type": "object", "additionalProperties": true}}}}}
}
}
},
"components": {
"schemas": {
"BoardKey": {
"type": "string",
"enum": ["breaches", "cyber-disclosures", "charter-amendments", "mergers", "agreements", "restructuring", "cmo-moves", "ipo-watch", "annual-meetings", "auditor-watch", "agentic-commerce", "subsea-data"],
"description": "breaches: 8-K Item 1.05 cybersecurity incidents, with a 30-day deadline field. cyber-disclosures: 8.01/7.01 voluntary cyber disclosures. charter-amendments: 5.03 articles, bylaws, renames. mergers: 2.01/5.01 completed acquisitions and control changes. agreements: 1.01 material agreements. restructuring: 2.05 exit and disposal costs. cmo-moves: 5.02 officer departures and appointments. ipo-watch: Form S-1. annual-meetings: DEF 14A. auditor-watch: 4.01/4.02 auditor changes and non-reliance. agentic-commerce: filers saying AI agents buy for their customers. subsea-data: undersea cables and data-centre infrastructure."
},
"BoardIndex": {
"type": "object",
"properties": {
"source": {"type": "string"}, "license": {"type": "string"}, "attribution": {"type": "string"},
"generated": {"type": "string", "format": "date-time"}, "swept": {"type": "integer", "description": "Filings on the boards"},
"fields": {"type": "string", "format": "uri"},
"trackers": {"type": "array", "items": {"type": "object", "properties": {"key": {"$ref": "#/components/schemas/BoardKey"}, "title": {"type": "string"}, "sub": {"type": "string"}, "scope": {"type": "string"}, "rows": {"type": "integer"}}}}
}
},
"Board": {
"type": "object",
"properties": {
"question": {"type": "string"}, "answer": {"type": "string", "description": "Dated one-line answer; read this aloud first"},
"as_of": {"type": "string"}, "newest_filing": {"type": "string"}, "last_7_days": {"type": "integer"},
"how": {"type": "string"}, "source": {"type": "string"}, "license": {"type": "string"}, "attribution": {"type": "string"},
"generated": {"type": "string", "format": "date-time"}, "tracker": {"type": "string"},
"total": {"type": "integer"}, "returned": {"type": "integer"}, "truncated": {"type": "boolean"}, "more": {"type": "string"},
"rows": {"type": "array", "items": {"$ref": "#/components/schemas/Row"}}
}
},
"Row": {
"type": "object",
"description": "One SEC filing. Every value is read from the filing or SEC data; only deadline is computed (Breach Clock).",
"properties": {
"id": {"type": "string", "description": "EDGAR accession number"}, "company": {"type": "string"}, "cik": {"type": "string"},
"form": {"type": "string"}, "items": {"type": "array", "items": {"type": "string"}, "description": "The filer's own 8-K item tags"},
"ticker": {"type": ["string", "null"]}, "exchange": {"type": ["string", "null"]}, "sector": {"type": ["string", "null"]},
"filerCategory": {"type": ["string", "null"]}, "revenue": {"type": ["number", "null"], "description": "Annual revenue USD from the filer's own XBRL facts"},
"revenueFY": {"type": ["integer", "null"]}, "city": {"type": ["string", "null"]}, "hq": {"type": ["string", "null"], "description": "State of operation"},
"state": {"type": ["string", "null"], "description": "State of incorporation"}, "formerName": {"type": ["string", "null"]},
"event": {"type": "string", "description": "Date of the event"}, "filed": {"type": "string", "description": "Date EDGAR accepted the filing"},
"deadline": {"type": ["string", "null"], "description": "Breach Clock only: filed plus 30 days"},
"quote": {"type": ["string", "null"], "description": "One verbatim sentence from the press-release exhibit"},
"source": {"type": "string", "format": "uri", "description": "The filing's index page on sec.gov. Cite this for the fact."},
"profile": {"type": "string", "format": "uri"}
}
},
"CompanyCard": {
"type": "object",
"description": "Schema pops4.edgarette.card/1. Figures as filed. Reporting, not investment advice.",
"properties": {
"ok": {"type": "boolean"}, "cik": {"type": "string"}, "ticker": {"type": ["string", "null"]}, "name": {"type": "string"},
"filings": {"type": "array", "items": {"type": "object", "additionalProperties": true}}, "events12m": {"type": "integer"},
"edgar": {"type": "string", "description": "What was filed, in a line"}, "edgarette": {"type": "string", "description": "What the numbers say, in a line"},
"summary": {"type": "string"}, "metrics": {"type": "object", "additionalProperties": true}, "signals": {"type": "object", "additionalProperties": true},
"harbor": {"type": "object", "additionalProperties": true}, "speedCash": {"type": "object", "additionalProperties": true},
"peers": {"type": "object", "additionalProperties": true}, "backtest": {"type": "object", "additionalProperties": true},
"registry": {"type": "object", "additionalProperties": true}, "card": {"type": "object", "additionalProperties": true},
"sources": {"type": "object", "additionalProperties": true}, "license": {"type": "string"}, "notAdvice": {"type": "string"}, "schema": {"type": "string"}
}
},
"Status": {
"type": "object",
"properties": {
"schema": {"type": "string"}, "generated_at": {"type": "string", "format": "date-time"}, "state": {"type": "string"},
"newestFiling": {"type": "string"}, "lastLogged": {"type": "string"}, "lastScored": {"type": "string"},
"ledger": {"type": "integer"}, "open": {"type": "integer"}, "scored": {"type": "integer"}, "hit": {"type": "integer"}, "miss": {"type": "integer"}, "void": {"type": "integer"},
"method": {"type": "string"}, "seal": {"type": "object", "properties": {"day": {"type": "string"}, "n": {"type": "integer"}, "root": {"type": "string"}, "at": {"type": "string"}, "how": {"type": "string"}}}
}
}
}
}
}