{ "openapi": "3.0.1", "info": { "title": "SEC EDGAR Filings API: 10-K, 10-Q & 8-K by Ticker or Date", "description": "Company filings from official SEC data: form type, dates, ticker, exchange, industry, 8-K event items in plain English and direct document links. Track tickers in real time or read each filing day, largest listed companies first. No insider or personal filings.", "version": "0.1", "x-build-id": "mkQLBN6ekFmCjeW7k" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jp-data-lab~sec-edgar-company-filings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jp-data-lab-sec-edgar-company-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/jp-data-lab~sec-edgar-company-filings/runs": { "post": { "operationId": "runs-sync-jp-data-lab-sec-edgar-company-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/jp-data-lab~sec-edgar-company-filings/run-sync": { "post": { "operationId": "run-sync-jp-data-lab-sec-edgar-company-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": { "tickers": { "title": "Tickers or CIKs", "type": "array", "description": "Optional. Stock tickers such as AAPL or BRK.B, or SEC CIK numbers. Returns the filings of these companies, newest first and updated in real time, and Latest filing days is ignored. Leave empty to read all companies by filing day.", "default": [], "items": { "type": "string" } }, "formTypes": { "title": "Form types", "type": "array", "description": "Which forms to return. Leave empty for 10-K, 10-Q, 8-K, 20-F, 40-F, 6-K, S-1 and F-1.", "items": { "type": "string", "enum": [ "10-K", "10-KT", "10-Q", "10-QT", "8-K", "20-F", "40-F", "6-K", "NT 10-K", "NT 10-Q", "NT 20-F", "S-1", "S-3", "S-4", "S-8", "S-11", "F-1", "F-3", "F-4", "424B4", "10-12B", "10-12G", "DEF 14A", "DEFA14A", "DEFM14A", "PRE 14A" ], "enumTitles": [ "10-K annual report", "10-KT transition report", "10-Q quarterly report", "10-QT transition report", "8-K current report", "20-F foreign annual report", "40-F Canadian annual report", "6-K foreign current report", "NT 10-K late annual report notice", "NT 10-Q late quarterly report notice", "NT 20-F late foreign annual report notice", "S-1 registration (IPO)", "S-3 shelf registration", "S-4 merger registration", "S-8 employee plan registration", "S-11 real estate registration", "F-1 foreign registration (IPO)", "F-3 foreign shelf registration", "F-4 foreign merger registration", "424B4 final IPO prospectus", "10-12B exchange registration", "10-12G registration", "DEF 14A proxy statement", "DEFA14A additional proxy material", "DEFM14A merger proxy", "PRE 14A preliminary proxy" ] }, "default": [] }, "includeAmendments": { "title": "Include amendments (/A)", "type": "boolean", "description": "Also return amended filings such as 10-K/A and 8-K/A.", "default": false }, "eightKItems": { "title": "8-K items", "type": "array", "description": "Optional. Keep 8-K filings that report any of these item numbers, for example 2.02 for earnings, 5.02 for director or officer changes, 1.05 for cybersecurity incidents, 1.03 for bankruptcy. Setting this returns 8-K filings only.", "default": [], "items": { "type": "string" } }, "filingDays": { "title": "Latest filing days", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many of the most recent EDGAR filing days to read. Weekends and federal holidays have no filings and are skipped. Ignored when Date from or Tickers is set.", "default": 1 }, "dateFrom": { "title": "Date from", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Optional. First filing date, YYYY-MM-DD. With Tickers this can go back to the company's first electronic filing. Without Tickers it reaches back about one year from Date to." }, "dateTo": { "title": "Date to", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Optional. Last filing date, YYYY-MM-DD. Leave empty for the newest filings." }, "listedOnly": { "title": "Listed companies only", "type": "boolean", "description": "Keep companies that have a ticker in the SEC's list. This drops asset-backed trusts, subsidiaries and other filers without a listed stock. Applies when reading by filing day.", "default": false }, "industries": { "title": "Industries", "type": "array", "description": "Optional. Keep companies whose SEC industry contains any of these words, for example Pharmaceutical or Software. Case-insensitive partial match. Leave empty for all.", "default": [], "items": { "type": "string" } }, "states": { "title": "Business states", "type": "array", "description": "Optional. Two-letter state codes of the company's business address, for example CA, NY, TX. Leave empty for all.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Newest first. You are charged per result.", "default": 100 } } }, "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 } } } } } } } } } }