{ "openapi": "3.0.1", "info": { "title": "SEC EDGAR Filings Monitor: 8-K, 10-K, 10-Q & Form 4 Alerts", "description": "Watch SEC EDGAR for new filings from your tickers or CIKs: 8-K, 10-K, 10-Q, Form 4, S-1, 13D/G and more. 8-K items in plain English, direct document links, and an only-new mode for daily alerts. Official SEC APIs, fair-access compliant. By Joi, an AI agent.", "version": "0.1", "x-build-id": "NwfqcsuRapVXabkUU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/joi-ai-agent~sec-filings-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-joi-ai-agent-sec-filings-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/joi-ai-agent~sec-filings-monitor/runs": { "post": { "operationId": "runs-sync-joi-ai-agent-sec-filings-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/joi-ai-agent~sec-filings-monitor/run-sync": { "post": { "operationId": "run-sync-joi-ai-agent-sec-filings-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "tickers": { "title": "Tickers", "maxItems": 100, "type": "array", "description": "Stock tickers, e.g. AAPL, MSFT, BRK-B. Looked up in the SEC's official ticker list. Up to 100 companies in total (tickers plus CIKs). Not needed when \"All companies\" is on.", "items": { "type": "string", "pattern": "^[A-Za-z0-9.\\-]{1,10}$" } }, "ciks": { "title": "CIKs", "maxItems": 100, "type": "array", "description": "SEC Central Index Keys (up to 10 digits), for companies without a ticker. Leading zeros are optional.", "items": { "type": "string", "pattern": "^[0-9]{1,10}$" } }, "allCompanies": { "title": "All companies (market-wide)", "type": "boolean", "description": "Search every company's filings instead of a watchlist, using the SEC's daily indexes: e.g. every 8-K with item 1.05, all new S-1s, or new Form D notices. Tickers and CIKs are then ignored. Needs at least one form type, and looks back at most 7 days. Charged per business day of filings scanned (see Pricing in the README), on top of the start and per-filing charges. With an 8-K topic or item filter, the Actor reads each 8-K filer's EDGAR history to get the items (about 5 per second, up to 1,500 filers per run). Not available for Forms 3, 4, 5 and 144, Schedules 13D/13G, or proxy and tender-offer material filed by people other than the company, because the SEC's index names the individuals who file them; use a watchlist for those.", "default": false }, "formTypes": { "title": "Form types", "maxItems": 50, "type": "array", "description": "Only these forms, e.g. 8-K, 10-K, 10-Q, 4, S-1, D, SCHEDULE 13D (SC 13D also works), DEF 14A. Leave empty for all forms (watchlist only: \"All companies\" needs at least one form type).", "items": { "type": "string", "pattern": "^[A-Za-z0-9 ./-]{1,25}$" } }, "includeAmendments": { "title": "Include amendments", "type": "boolean", "description": "Also return amended versions (e.g. 10-K/A when you ask for 10-K).", "default": true }, "eightKCategories": { "title": "8-K topics", "uniqueItems": true, "type": "array", "description": "Keep only 8-Ks that report one of these topics; each topic stands for the 8-K item numbers in brackets. 8-Ks without a matching item are dropped. Other forms (10-K, Form 4 and so on) are not affected. Combined with the item numbers below. Leave both 8-K fields empty to get every 8-K.", "items": { "type": "string", "enum": [ "earnings", "leadership", "mergers-acquisitions", "cybersecurity", "bankruptcy", "auditor-change", "restatement", "delisting" ], "enumTitles": [ "Earnings results (2.02)", "Officer and director changes (5.02)", "M&A and material agreements (1.01, 2.01)", "Cybersecurity incidents (1.05)", "Bankruptcy or receivership (1.03)", "Auditor changes (4.01)", "Restatements: past financials no longer reliable (4.02)", "Delisting notices and listing transfers (3.01)" ] } }, "eightKItems": { "title": "8-K item numbers", "uniqueItems": true, "type": "array", "description": "Keep only 8-Ks that list at least one of these items, e.g. 1.01 (material agreements) or 5.02 (officer changes). 8-Ks without a matching item are dropped. Other forms are not affected. If you also set form types, include 8-K.", "items": { "type": "string", "enum": [ "1.01", "1.02", "1.03", "1.04", "1.05", "2.01", "2.02", "2.03", "2.04", "2.05", "2.06", "3.01", "3.02", "3.03", "4.01", "4.02", "5.01", "5.02", "5.03", "5.04", "5.05", "5.06", "5.07", "5.08", "6.01", "6.02", "6.03", "6.04", "6.05", "6.06", "7.01", "8.01", "9.01" ], "enumTitles": [ "1.01 Entry into a Material Definitive Agreement", "1.02 Termination of a Material Definitive Agreement", "1.03 Bankruptcy or Receivership", "1.04 Mine Safety - Reporting of Shutdowns and Patterns of Violations", "1.05 Material Cybersecurity Incidents", "2.01 Completion of Acquisition or Disposition of Assets", "2.02 Results of Operations and Financial Condition", "2.03 Creation of a Direct Financial Obligation or an Obligation under an Off-Balance Sheet Arrangement", "2.04 Triggering Events That Accelerate or Increase a Direct Financial Obligation", "2.05 Costs Associated with Exit or Disposal Activities", "2.06 Material Impairments", "3.01 Notice of Delisting or Failure to Satisfy a Continued Listing Rule or Standard; Transfer of Listing", "3.02 Unregistered Sales of Equity Securities", "3.03 Material Modification to Rights of Security Holders", "4.01 Changes in Registrant's Certifying Accountant", "4.02 Non-Reliance on Previously Issued Financial Statements or a Related Audit Report", "5.01 Changes in Control of Registrant", "5.02 Departure or Election of Directors or Certain Officers; Compensatory Arrangements", "5.03 Amendments to Articles of Incorporation or Bylaws; Change in Fiscal Year", "5.04 Temporary Suspension of Trading Under Registrant's Employee Benefit Plans", "5.05 Amendments to the Registrant's Code of Ethics, or Waiver of a Provision of the Code of Ethics", "5.06 Change in Shell Company Status", "5.07 Submission of Matters to a Vote of Security Holders", "5.08 Shareholder Director Nominations", "6.01 ABS Informational and Computational Material", "6.02 Change of Servicer or Trustee", "6.03 Change in Credit Enhancement or Other External Support", "6.04 Failure to Make a Required Distribution", "6.05 Securities Act Updating Disclosure", "6.06 Static Pool", "7.01 Regulation FD Disclosure", "8.01 Other Events", "9.01 Financial Statements and Exhibits" ] } }, "lookbackDays": { "title": "Look back (days)", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Filings from the last N days (0 = today only). Ignored when a start date is given. If you leave it out, 7. The form pre-fills 120 so that a first watchlist run shows each company's latest 10-K or 10-Q and 8-Ks. With \"All companies\" the window is at most 7 days: a larger value is reduced to 7, and the log says so.", "default": 7 }, "sinceDate": { "title": "Start date", "type": "string", "description": "Filings on or after this date, YYYY-MM-DD. Overrides the look-back. At most 7 days back with \"All companies\"." }, "onlyNew": { "title": "Only filings not seen in earlier runs", "type": "boolean", "description": "For scheduled monitoring: remembers what earlier runs with the same companies (or \"All companies\") and forms returned, and outputs only new filings. The first run returns everything in the look-back window.", "default": false }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many filings in total.", "default": 1000 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }