Raw schema
{
"type": "object",
"properties": {
"corp": {
"description": "회사명/종목코드/corp_code. Omit = all companies; a batch then splits the period by month, spends up to 60 DART requests (incomplete=true when hit) and can take tens of seconds. With corp: 1 request, a few hundred ms.",
"type": "string"
},
"start": {
"description": "Start date YYYY-MM-DD. Omitted = `days` back from today; set it for older filings.",
"type": "string"
},
"end": {
"description": "End date (default today)",
"type": "string"
},
"days": {
"description": "Trailing N days from today, used when start is omitted; out-of-range values clamp. Default by preset: 사업·감사 460 / 반기 280 / 분기 180 / 수시·일반 90. Longer windows: start/end.",
"type": "integer",
"minimum": 1,
"maximum": 730
},
"kind": {
"description": "공시유형; omit = all types. Enum order = DART pblntf_ty A~J; that letter or the Korean name (정기공시…) also works.",
"type": "string",
"enum": [
"periodic",
"major",
"issuance",
"holdings",
"other",
"audit",
"fund",
"abs",
"exchange",
"ftc"
]
},
"preset": {
"description": "Batch filter; sets kind and collects every page. 주요사항보고 keys match the EXACT DART 보고 사유 (never a title substring) — one key per 사유 (cb_issuance · cb_treasury_resale …); group aliases capital_change · cb · bw · cps · bond_issuance · treasury · treasury_trust · restructuring · asset_deal · asset_transfer_etc · guarantee_debt · insolvency · overseas union several. large_holding_5pct = all 지분공시.",
"type": "string",
"enum": [
"capital_change",
"cb",
"bw",
"cps",
"bond_issuance",
"treasury",
"treasury_trust",
"restructuring",
"asset_deal",
"asset_transfer_etc",
"guarantee_debt",
"insolvency",
"overseas",
"rights_offering",
"bonus_issue",
"rights_bonus_combo",
"capital_reduction",
"cb_issuance",
"cb_treasury_resale",
"cb_early_acquisition",
"cb_call_designation",
"cb_call_exercise_third_party",
"bw_issuance",
"bw_treasury_resale",
"bw_early_acquisition",
"bw_call_designation",
"bw_call_exercise_third_party",
"cps_call_designation",
"cps_call_exercise_third_party",
"eb_issuance",
"cocobond_issuance",
"hybrid_capital_issuance",
"treasury_acquisition",
"treasury_disposal",
"treasury_trust_contract",
"treasury_trust_cancel",
"treasury_trust_extension",
"company_merger",
"company_split",
"company_split_merger",
"stock_exchange",
"other_corp_stock_acquisition",
"other_corp_stock_transfer",
"tangible_asset_acquisition",
"tangible_asset_transfer",
"noncurrent_asset_acquisition",
"noncurrent_asset_disposal",
"business_acquisition",
"business_transfer",
"business_deal_legacy",
"asset_deal_legacy",
"business_lease_delegation",
"business_lease_delegation_change",
"asset_transfer_other",
"putback_option_contract",
"bond_with_stock_right_acquisition",
"bond_with_stock_right_transfer",
"guarantee_for_others",
"collateral_for_others",
"debt_assumption",
"debt_forgiveness_granted",
"debt_forgiveness_received",
"donation",
"donation_received",
"default_occurrence",
"business_suspension",
"rehabilitation_filing",
"rehabilitation_commencement",
"rehabilitation_discontinuance",
"dissolution_cause",
"bank_management_start",
"bank_management_stop",
"bank_management_end",
"litigation",
"overseas_listing_decision",
"overseas_listing",
"overseas_delisting_decision",
"overseas_delisting",
"foreign_tender_offer",
"foreign_trading_halt",
"large_holding_5pct",
"annual_report",
"half_report",
"quarterly_report",
"audit_report",
"correction_all"
]
},
"final_only": {
"default": false,
"description": "One latest version per event: 원본 replaced by its latest 정정본 (정정공시 NOT excluded) — a duplicate-free set. Windowed by each event's LATEST version date: filed in window but corrected after end = absent.",
"type": "boolean"
},
"include_corrections": {
"default": false,
"description": "Include 정정공시 ([기재정정] etc.) in preset batch; off avoids 원본+정정 double count. correction_all forces true; ignored with final_only. Page mode and bare all_pages always include them. Latest-only: final_only.",
"type": "boolean"
},
"all_pages": {
"default": false,
"description": "Batch-collect the whole period without a preset (same set as page mode, 정정공시 included); limit replaces page/size.",
"type": "boolean"
},
"page": {
"default": 1,
"description": "Page number (page mode = no preset, all_pages=false). Page mode returns raw DART rows; batch rows drop stock_code·rm and add event (주요사항), corrected (= a later 정정 exists), withdrawn.",
"type": "integer",
"minimum": 1
},
"size": {
"default": 20,
"description": "Page size (page mode)",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"limit": {
"default": 500,
"description": "Max rows returned in batch mode (preset or all_pages)",
"type": "integer",
"minimum": 1,
"maximum": 3000
},
"concurrency": {
"default": 5,
"description": "Collector workers. A server-wide cap sets real concurrency, so raising this rarely helps — to cut latency set corp, narrow the period or lower limit.",
"type": "integer",
"minimum": 1,
"maximum": 10
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}