get_financials

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "corp": {
      "description": "Company — **a single string OR an array** (회사명·종목코드·corp_code). With scope=summary: 1 (single) or 2+ (multi-company comparison). scope=full takes EXACTLY 1 — give 2 or more and only the first is returned, the rest are dropped (there is no multi-company full-statement API) and the drop is reported in `notes`. Compare several companies with scope=summary. A comma list (\"삼성전자,SK하이닉스\") or a bare number (259630) is absorbed too; the legacy key `corps` is accepted. Names/codes that fail to resolve are dropped with a note as long as at least one resolves (all-unresolved still errors). Omit when querying one specific filing by rcept_no instead.",
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "minItems": 1,
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1
          }
        }
      ]
    },
    "rcept_no": {
      "description": "14-digit 접수번호 — serves that filing AS FILED (구 get_xbrl 흡수). corp+year serves the LATEST version instead; the two can differ after a [기재정정]. **연차(사업보고서) rcept 전용** — 분·반기 XBRL 은 기간 구조(누계·단독)가 달라 corp+report 로 조회하세요(no_data 가 라우팅). Accepts fs_div·sj_div (구 sections 는 sj_div 로 흡수); corp·year·scope must be omitted. Adds 합산 검증(validations) to the response.",
      "type": "string",
      "pattern": "^\\d{14}$"
    },
    "year": {
      "description": "결산 사업연도 (회계연도). When omitted, the most recently PUBLISHED 사업연도 is selected automatically — this absorbs the validation error that used to occur when the caller left year out for a question that never named a year. Confirm the year actually used via year/year_defaulted in the response.",
      "type": "integer",
      "minimum": 2015
    },
    "report": {
      "default": "annual",
      "description": "q1/half/q3/annual",
      "type": "string",
      "enum": [
        "q1",
        "half",
        "q3",
        "annual"
      ]
    },
    "scope": {
      "description": "summary (default): 주요계정, 8~10 rows (fast). full: the whole 재무제표 (BS/IS/CF/CIS/SCE), hundreds~1k rows",
      "type": "string",
      "enum": [
        "summary",
        "full"
      ]
    },
    "fs_div": {
      "description": "With scope=full, selects 연결(CFS)/별도(OFS) (default CFS). The response echoes the basis ACTUALLY used, not the requested one — a CFS→OFS auto-fallback is flagged by fs_div_note. Ignored by scope=summary — summary responses carry no top-level fs_div because consolidation is per-row there. Aliases consolidated/separate·연결/별도 also accepted.",
      "type": "string",
      "enum": [
        "CFS",
        "OFS"
      ]
    },
    "sj_div": {
      "description": "With scope=full, filters 재무제표 종류 (when unset: BS+IS+CIS — a company using the '단일 포괄손익계산서' presentation reports 손익 in CIS only, not IS, so CIS is included by default). BS=재무상태표, IS=손익계산서, CF=현금흐름표, CIS=포괄손익계산서, SCE=자본변동표. To get everything, state [\"BS\",\"IS\",\"CF\",\"CIS\",\"SCE\"] explicitly. A bare string (\"BS\") or comma list (\"BS,IS\") is absorbed into an array.",
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "BS",
          "IS",
          "CF",
          "CIS",
          "SCE"
        ]
      }
    },
    "format": {
      "description": "REMOVED (구 get_xbrl) — any value is rejected. markdown/markdown_full → items[] replaces them (omit this arg); raw → discontinued.",
      "type": "string"
    }
  }
}