{ "openapi": "3.0.1", "info": { "title": "SEC EDGAR Filings — 10-K, 10-Q, 8-K, 13F & Full-Text Search", "description": "SEC filings for any EDGAR registrant by ticker, CIK or company name, plus full-text search across all filings since 2001. Form type, dates, 8-K item codes, accession number, document/index/txt/XBRL-viewer links, company profile (former names, addresses, filer category).", "version": "0.1", "x-build-id": "l5dnTEP7LBpQJyQsK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yadroo~sec-edgar-filings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yadroo-sec-edgar-filings", "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/yadroo~sec-edgar-filings/runs": { "post": { "operationId": "runs-sync-yadroo-sec-edgar-filings", "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/yadroo~sec-edgar-filings/run-sync": { "post": { "operationId": "run-sync-yadroo-sec-edgar-filings", "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": { "mode": { "title": "Mode", "enum": [ "submissions", "fullTextSearch" ], "type": "string", "description": "Default \"submissions\": list filings per company given in tickers / companyNameContains. \"fullTextSearch\": requires \"query\"; searches all filings (2001+) and returns matching filings with document links; tickers/companyNameContains then act as an optional CIK restriction.", "default": "submissions" }, "tickers": { "title": "Tickers or CIKs", "type": "array", "description": "US exchange tickers (AAPL, NVDA, BRK-B) or SEC CIK numbers (up to 10 digits, leading zeros optional). One company per entry. Tickers are resolved via https://www.sec.gov/files/company_tickers.json — only exchange-listed issuers have tickers; use the CIK for funds, insiders, private issuers. Unknown entries produce an item with \"error\" and a warning.", "items": { "type": "string" } }, "companyNameContains": { "title": "Company name contains", "type": "array", "description": "Resolve companies by name fragment (case-insensitive match against SEC company titles, e.g. \"Palantir\", \"Coinbase Global\"). Exact title match wins; otherwise the first match is used and other candidates are listed in the log as a warning. Prefer tickers/CIKs when you know them.", "items": { "type": "string" } }, "includeCompanyProfile": { "title": "Include company profile item", "type": "boolean", "description": "If true, emits one extra item of type \"company\" per resolved company before its filings: former names, business/mailing addresses, EIN, filer category (e.g. \"Large accelerated filer\"), SIC, exchanges, fiscal year end, phone, website, total filings indexed.", "default": false }, "forms": { "title": "Form types (free text)", "type": "array", "description": "Form types as free text, e.g. [\"10-K\",\"10-Q\",\"8-K\"]. Common aliases are normalized (\"10k\" → \"10-K\", \"def14a\" → \"DEF 14A\", \"13F\" → \"13F-HR\", \"10-KA\" → \"10-K/A\"). Merged with \"formTypes\". Empty = all forms. Full dictionary in README.", "items": { "type": "string" } }, "formTypes": { "title": "Form types (pick from list)", "type": "array", "description": "Same as \"forms\" but as a multi-select of the most common EDGAR form types with titles. Values are merged with \"forms\". Use \"forms\" for anything not in this list.", "items": { "type": "string", "enum": [ "3", "4", "5", "144", "10-K", "10-K/A", "10-KT", "10-Q", "10-Q/A", "8-K", "8-K/A", "20-F", "20-F/A", "40-F", "6-K", "10-D", "11-K", "NT 10-K", "NT 10-Q", "NT 20-F", "ARS", "S-1", "S-1/A", "S-3", "S-3/A", "S-3ASR", "S-4", "S-4/A", "S-8", "S-11", "F-1", "F-1/A", "F-3", "F-4", "F-10", "424B1", "424B2", "424B3", "424B4", "424B5", "424B7", "FWP", "DEF 14A", "DEFA14A", "DEFM14A", "PRE 14A", "PREM14A", "DEF 14C", "PX14A6G", "13F-HR", "13F-HR/A", "13F-NT", "SC 13D", "SC 13D/A", "SC 13G", "SC 13G/A", "SC TO-T", "SC TO-I", "SC 14D9", "SC 13E3", "3/A", "4/A", "D", "D/A", "C", "C/A", "C-U", "C-AR", "1-A", "1-K", "1-SA", "N-CSR", "N-CSRS", "N-PORT", "N-PX", "N-1A", "N-2", "485BPOS", "497K", "X-17A-5", "ABS15G", "CORRESP", "UPLOAD", "EFFECT", "REGDEX", "IRANNOTICE", "SD", "PX14A6N" ], "enumTitles": [ "3 — Initial statement of insider beneficial ownership", "4 — Insider transaction report (2 business days)", "5 — Annual insider ownership statement", "144 — Notice of proposed sale of restricted securities", "10-K — Annual report (US domestic)", "10-K/A — Annual report amendment", "10-KT — Transition annual report", "10-Q — Quarterly report", "10-Q/A — Quarterly report amendment", "8-K — Current report (material events)", "8-K/A — Current report amendment", "20-F — Annual report (foreign private issuer)", "20-F/A — Foreign annual report amendment", "40-F — Annual report (Canadian issuer, MJDS)", "6-K — Report of foreign private issuer", "10-D — Asset-backed issuer distribution report", "11-K — Employee stock plan annual report", "NT 10-K — Notification of late 10-K", "NT 10-Q — Notification of late 10-Q", "NT 20-F — Notification of late 20-F", "ARS — Annual report to security holders", "S-1 — IPO / general registration statement", "S-1/A — S-1 amendment", "S-3 — Shelf registration (seasoned issuer)", "S-3/A — S-3 amendment", "S-3ASR — Automatic shelf registration (WKSI)", "S-4 — Registration for M&A / exchange offers", "S-4/A — S-4 amendment", "S-8 — Employee benefit plan registration", "S-11 — Real estate company registration", "F-1 — Foreign issuer IPO registration", "F-1/A — F-1 amendment", "F-3 — Foreign issuer shelf registration", "F-4 — Foreign issuer M&A registration", "F-10 — Canadian issuer registration (MJDS)", "424B1 — Prospectus (new facts, Rule 424(b)(1))", "424B2 — Prospectus (pricing supplement)", "424B3 — Prospectus (substantive changes)", "424B4 — Final IPO prospectus", "424B5 — Prospectus supplement (shelf takedown)", "424B7 — Prospectus (selling security holder info)", "FWP — Free writing prospectus", "DEF 14A — Definitive proxy statement", "DEFA14A — Additional definitive proxy soliciting materials", "DEFM14A — Definitive merger proxy statement", "PRE 14A — Preliminary proxy statement", "PREM14A — Preliminary merger proxy statement", "DEF 14C — Definitive information statement", "PX14A6G — Exempt shareholder solicitation notice", "13F-HR — Institutional holdings report (quarterly)", "13F-HR/A — 13F-HR amendment", "13F-NT — 13F notice (holdings reported by another manager)", "SC 13D — Beneficial ownership >5% (active)", "SC 13D/A — SC 13D amendment", "SC 13G — Beneficial ownership >5% (passive)", "SC 13G/A — SC 13G amendment", "SC TO-T — Third-party tender offer statement", "SC TO-I — Issuer tender offer statement", "SC 14D9 — Tender offer solicitation/recommendation", "SC 13E3 — Going-private transaction statement", "3/A — Form 3 amendment", "4/A — Form 4 amendment", "D — Notice of exempt offering (Reg D private placement)", "D/A — Form D amendment", "C — Regulation Crowdfunding offering statement", "C/A — Form C amendment", "C-U — Crowdfunding progress update", "C-AR — Crowdfunding annual report", "1-A — Regulation A offering statement", "1-K — Regulation A annual report", "1-SA — Regulation A semiannual report", "N-CSR — Certified shareholder report (funds)", "N-CSRS — Semiannual certified shareholder report (funds)", "N-PORT — Monthly portfolio holdings (funds)", "N-PX — Proxy voting record (funds)", "N-1A — Open-end fund registration", "N-2 — Closed-end fund registration", "485BPOS — Post-effective amendment (funds)", "497K — Summary prospectus (funds)", "X-17A-5 — Broker-dealer annual audited report", "ABS-15G — Asset-backed securities report", "CORRESP — Correspondence with SEC staff", "UPLOAD — SEC staff comment letter", "EFFECT — Notice of effectiveness", "REGDEX — Regulation D exemption (legacy)", "IRANNOTICE — Iran-related disclosure notice", "SD — Specialized disclosure (conflict minerals)", "PX14A6N — Exempt solicitation (non-management)" ] } }, "since": { "title": "Filed since (YYYY-MM-DD)", "type": "string", "description": "Only filings filed on or after this date (inclusive). In submissions mode older paged submission files are fetched automatically when needed. In fullTextSearch mode this is used as startDate if startDate is empty. Empty = no lower bound." }, "until": { "title": "Filed until (YYYY-MM-DD)", "type": "string", "description": "Only filings filed on or before this date (inclusive). In fullTextSearch mode used as endDate if endDate is empty. Empty = today." }, "itemCodes": { "title": "8-K item codes", "type": "array", "description": "Submissions mode only: keep 8-K / 8-K/A filings that report at least one of these items (e.g. 2.02 earnings, 5.02 executive changes, 1.05 cybersecurity incident, 1.03 bankruptcy). Accepts \"202\" or \"Item 2.02\" too. Ignored (with a warning) in fullTextSearch mode. Dictionary in README.", "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 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", "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 (Restatement)", "5.01 — Changes in Control of Registrant", "5.02 — Departure/Election of Directors or Officers; Compensatory Arrangements", "5.03 — Amendments to Articles of Incorporation or Bylaws; Change in Fiscal Year", "5.04 — Temporary Suspension of Trading Under Employee Benefit Plans", "5.05 — Amendments to or Waiver of 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" ] } }, "limitPerCompany": { "title": "Max filings per company", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Submissions mode: newest-first cap per company after filters. Default 20, max 1000. The global \"maxItems\" still applies.", "default": 20 }, "query": { "title": "Search query", "type": "string", "description": "Required in fullTextSearch mode. Exact phrase in double quotes (\"going concern\"), plain words are ANDed, supports OR, -negation and trailing * wildcards. Examples: \"\\\"material weakness\\\"\", \"\\\"ransomware\\\" AND \\\"Item 1.05\\\"\", \"Anthropic OR OpenAI\"." }, "startDate": { "title": "Search start date (YYYY-MM-DD)", "type": "string", "description": "fullTextSearch: earliest filing date. Falls back to \"since\". Empty = full history (2001+)." }, "endDate": { "title": "Search end date (YYYY-MM-DD)", "type": "string", "description": "fullTextSearch: latest filing date. Falls back to \"until\". Empty = today." }, "entityName": { "title": "Entity name filter", "type": "string", "description": "fullTextSearch: restrict to filers whose name contains this text (EFTS \"entityName\" parameter), e.g. \"Bank\". For exact companies prefer tickers/CIKs." }, "sics": { "title": "SIC codes", "type": "array", "description": "fullTextSearch: 4-digit SIC industry codes of the filer, e.g. [\"7372\"] software, [\"6022\"] state commercial banks, [\"2834\"] pharma preparations. Full list: https://www.sec.gov/search-filings/standard-industrial-classification-sic-code-list", "items": { "type": "string" } }, "locationCodes": { "title": "Location codes", "type": "array", "description": "fullTextSearch: US state / country codes of the filer, e.g. [\"CA\",\"NY\"] or EDGAR country codes (e.g. \"X0\" Canada... see https://www.sec.gov/submit-filings/filer-support-resources/edgar-state-country-codes). Combined with \"locationType\".", "items": { "type": "string" } }, "locationType": { "title": "Location type", "enum": [ "located", "incorporated" ], "type": "string", "description": "fullTextSearch: whether locationCodes refer to the business address (located) or the state/country of incorporation (incorporated).", "default": "located" }, "maxItems": { "title": "Max items (total)", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard cap on dataset items across all companies / search pages (including company profile and error items). Default 200. You pay per item, so keep it modest.", "default": 200 }, "fields": { "title": "Fields to keep", "type": "array", "description": "Optional whitelist of top-level output fields, e.g. [\"ticker\",\"form\",\"filingDate\",\"items8k\",\"documentUrl\"]. \"type\", \"id\" and \"error\" are always kept. Empty = all fields.", "items": { "type": "string" } }, "dedupe": { "title": "Deduplicate by accession number", "type": "boolean", "description": "Emit each filing (accession number) once even if it appears for several companies (co-registrants) or several matching documents in full-text search. Set false to get one item per matching document/company.", "default": true } } }, "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 } } }, "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 } } } } } } } } } }