track_korean_filings

{
  "additionalProperties": false,
  "properties": {
    "company_corp_code": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "8-digit DART corp code (single company). Use\n`lookup_corp_code` first to resolve a company name. Omit to query\nall companies. Ignored when `company_corp_codes` (plural) is\nprovided non-empty — the plural list takes precedence."
    },
    "days": {
      "default": 7,
      "type": "integer",
      "description": "how many days back from today (1–30). Ignored when `since` is\nprovided."
    },
    "filing_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "optional one-letter code:\nA=periodic, B=major event, C=issuance, D=shareholding,\nE=other, F=audit, G=fund, H=ABS, I=exchange, J=FTC."
    },
    "limit": {
      "default": 30,
      "type": "integer",
      "description": "max filings to return (≤100). DART returns most-recent first,\nso on a busy window the older end of the range is dropped first.\nNarrow `days` or `filing_type` if you need older items.\nIn batch mode (`company_corp_codes`) `limit` applies PER COMPANY,\nnot to the merged set, so a heavy filer can never crowd a quieter\ncompany out of the results: an empty result for a company means\nthat company genuinely filed nothing in the window. A batch call\ncan therefore return up to `limit × len(company_corp_codes)` rows."
    },
    "translate": {
      "default": true,
      "type": "boolean",
      "description": "True to fill `title_en` via server-side LLM (cached)."
    },
    "summarize": {
      "default": false,
      "type": "boolean",
      "description": "True to fill `summary_en` (≤200 words). Costs more — use\nsparingly. Long-form analysis should be done by the client LLM."
    },
    "license_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "subscription key. Required when KOREANPULSE_REQUIRE_LICENSE=1."
    },
    "company_corp_codes": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "OPTIONAL list of up to 10 corp codes for batch\nmode. When provided non-empty, the tool queries each corp code\nconcurrently (one cache-backed DART call each), merges the\nresults, and sorts newest-first — use this to scan a whole\nwatchlist in one call. More than 10 codes raises a validation\nerror (DART has no batch endpoint; this is N calls, so the cap\nprotects the daily quota). Takes precedence over\n`company_corp_code` (singular) when both are given."
    },
    "since": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "OPTIONAL ISO-8601 date or datetime (e.g. '2026-05-01' or\n'2026-05-01T09:00:00'). When provided it is the cutoff instead of\n`days` — only filings with `filed_at >= since` are returned. Use\nit to fetch only what is new since your last checkpoint.\n`filed_at` is date-granular (KST), so a time component filters at\nday boundaries. A malformed value raises a validation error.\nWhen omitted, the `days` window is used exactly as before."
    },
    "material_only": {
      "default": false,
      "type": "boolean",
      "description": "OPTIONAL. When True, return only filings whose\n`red_flags` list is non-empty (governance/distress-tagged — see\nthe red_flags catalog below). Applies to both single and batch\nqueries. Reuses the existing red-flag tagging; adds no new\nclassification."
    }
  },
  "type": "object"
}