{ "openapi": "3.0.1", "info": { "title": "Korean Company Filings & Financials (DART) — English", "description": "Official financial statements (revenue, operating profit, net income, assets, cash flow), disclosure filings, company profiles and financial ratios for any Korean listed company, straight from DART/OpenDART as English-labeled JSON. Bring your free OpenDART key; pay per record.", "version": "0.1", "x-build-id": "OUsGJHTvLf8bEsEaQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/elpalaiso~dart-korea-filings-financials/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-elpalaiso-dart-korea-filings-financials", "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/elpalaiso~dart-korea-filings-financials/runs": { "post": { "operationId": "runs-sync-elpalaiso-dart-korea-filings-financials", "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/elpalaiso~dart-korea-filings-financials/run-sync": { "post": { "operationId": "run-sync-elpalaiso-dart-korea-filings-financials", "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", "required": [ "mode" ], "properties": { "apiKey": { "title": "OpenDART API key", "type": "string", "description": "Optional. Leave empty to use the Actor's built-in shared key (fair-use cap of 300 requests per run). Add your own free OpenDART key for larger runs." }, "useSampleData": { "title": "Use bundled sample data", "type": "boolean", "description": "Return bundled records for the selected mode without an OpenDART API call or record charge, even when an API key is available.", "default": false }, "mode": { "title": "What to fetch", "enum": [ "company_profile", "filings", "financials", "key_financials", "indicators" ], "type": "string", "description": "company_profile: one profile record per company. filings: disclosure list (with links) for the companies and dates you choose. financials: full financial statements (every account line). key_financials: major accounts (assets, liabilities, equity, revenue, operating profit, net income…) for up to 100 companies per call. indicators: profitability / stability / growth / activity ratios.", "default": "financials" }, "companies": { "title": "Companies", "type": "array", "description": "Identify companies by KRX ticker (6 digits, e.g. 005930), DART corp code (8 digits, e.g. 00126380), or company name in English or Korean (e.g. Samsung Electronics, 삼성전자). Names are matched against DART's master list; ambiguous names return the best match and a warning in the log. Leave empty in 'filings' mode to search all companies within the date range (max 3 months).", "items": { "type": "string" } }, "years": { "title": "Fiscal years", "type": "array", "description": "Fiscal years for financial statements, key financials and indicators (2015 onwards; indicators from 2023 Q3). Example: 2023, 2024.", "items": { "type": "string" } }, "reportCodes": { "title": "Report types", "type": "array", "description": "Which periodic reports to read. 11011 = annual report (사업보고서), 11012 = half-year, 11013 = Q1, 11014 = Q3.", "items": { "type": "string", "enum": [ "11011", "11012", "11013", "11014" ], "enumTitles": [ "Annual report (11011)", "Half-year report (11012)", "Q1 report (11013)", "Q3 report (11014)" ] }, "default": [ "11011" ] }, "fsDiv": { "title": "Consolidated or separate statements", "enum": [ "CFS", "OFS", "both" ], "type": "string", "description": "CFS = consolidated (연결), OFS = separate/individual (개별). 'both' fetches both when available. Applies to 'financials' mode.", "default": "CFS" }, "startDate": { "title": "Filings from (YYYY-MM-DD)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Start of the filing date range for 'filings' mode. Without companies, OpenDART limits the range to 3 months." }, "endDate": { "title": "Filings until (YYYY-MM-DD)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "End of the filing date range for 'filings' mode. Defaults to today." }, "filingTypes": { "title": "Filing categories", "type": "array", "description": "Restrict 'filings' mode to categories. A = periodic reports, B = material events, C = securities offerings, D = ownership/insider, E = other, F = external audit, G = funds, H = asset-backed securities, I = exchange disclosures, J = fair-trade commission.", "items": { "type": "string", "enum": [ "A", "B", "C", "D", "E", "F", "G", "H", "I", "J" ], "enumTitles": [ "A · Periodic reports", "B · Material event reports", "C · Securities offerings", "D · Ownership & insider", "E · Other", "F · External audit", "G · Funds", "H · Asset-backed securities", "I · Exchange disclosures", "J · Fair Trade Commission" ] } }, "filingDetailTypes": { "title": "Filing detail types", "type": "array", "description": "Optional 4-character OpenDART detail codes for 'filings' mode. Examples: A001 = annual report, B001 = material event report, D001 = large shareholding report. Code groups: A001–A005, B001–B003, C001–C011, D001–D005, E001–E010, F001–F005, G001–G003, H001–H006, I001–I006, and J001/J002/J004–J006/J008/J009. Each code is queried separately.", "items": { "type": "string", "pattern": "^[A-J][0-9]{3}$" } }, "market": { "title": "Market", "enum": [ "all", "Y", "K", "N", "E" ], "type": "string", "description": "Restrict 'filings' mode by company market. OpenDART accepts one market per query; choose All markets to omit the filter.", "default": "all" }, "lastReportOnly": { "title": "Only the latest version of amended filings", "type": "boolean", "description": "In 'filings' mode, return only the final version when a report was amended.", "default": true }, "indicatorClasses": { "title": "Indicator classes", "type": "array", "description": "For 'indicators' mode. M210000 profitability, M220000 stability, M230000 growth, M240000 activity.", "items": { "type": "string", "enum": [ "M210000", "M220000", "M230000", "M240000" ], "enumTitles": [ "Profitability (M210000)", "Stability (M220000)", "Growth (M230000)", "Activity (M240000)" ] }, "default": [ "M210000", "M220000", "M230000", "M240000" ] }, "includeKorean": { "title": "Keep Korean labels alongside English", "type": "boolean", "description": "Include the original Korean names (account_nm, report_nm…) next to the English translations.", "default": true }, "maxItems": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Stop after this many records (0 = no limit). Useful for a cheap first test.", "default": 0 }, "requestBudget": { "title": "OpenDART request budget", "minimum": 0, "type": "integer", "description": "Stop cleanly after this many OpenDART HTTP requests while keeping records already saved. With your own key, 0 means unlimited; with the built-in shared key, 0 applies the 300-request fair-use cap. The count includes the company master download and retry attempts.", "default": 0 } } }, "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 } } } } } } } } } }