Previous value: -"Target 문서번호(dcmNo). Defaults to the 본문 document. One 공시(rcept_no) carries, besides the 본문, sibling documents (감사보고서·내부회계관리제도운영보고서·영업보고서·정관 etc.) each with its own dcmNo; take sibling_documents[].dcm_no from a list result to read that document (list its attachments, or mode=text/images). A sibling's attachments are invisible without it — always list first, then pass sibling_documents[].dcm_no."New value: +"Target 문서번호(dcmNo); default = 본문. Each 형제문서 (감사보고서·내부회계관리제도운영보고서·영업보고서·정관 etc.) has its own — take sibling_documents[].dcm_no from mode=list first; required to reach that 형제문서's attachments·text·images."

Previous value: -"Exact filename of the attachment to scan, in images mode (no partial-match fallback). Giving it PICKS the PDF-scan route — omit both filename and index to get the document's 뷰어 임베드 원본 JPEG instead. An EXACT match is required; on failure the error lists the available names."New value: +"images mode: EXACT filename of the attachment PDF to scan (a miss lists available names); selects the PDF-scan route."

Previous value: -"Start offset in document order for the 뷰어 원본 JPEG route (0-based, default 0). Channels with a response cap fit only ~1 scan page per call, so this is how you reach later pages — e.g. the 자금부정통제 표 is usually the 2nd page of an 운영실태보고서, so image_from=1. The response carries `from` and a note telling you the next offset. PDF-scan route uses pages instead."New value: +"뷰어 원본 JPEG route: 0-based start offset in document order — reach pages past max_images (capped channels fit ~1 page per call); continue with next_image_from. e.g. 운영실태보고서 자금부정통제 표 is usually the 2nd page → 1. PDF-scan route: use pages."

Previous value: -"0-based index of the attachment to scan, in images mode (filename takes precedence). Like filename it picks the PDF-scan route; omit both to get the 뷰어 임베드 원본 JPEG."New value: +"images mode: 0-based index of the attachment to scan; filename wins if both. Selects the PDF-scan route, like filename."

Previous value: -"Max images returned in images mode (largest area first). Default 12."New value: +"images mode: max images; PDF-scan route keeps largest by area."

Previous value: -"In images mode, an image whose shorter side is under this many pixels is treated as decoration (아이콘·괘선) and dropped. Default 24. Lower it to catch small 도장/서명. It filters the PDF-scan path only (source:\"pdf\") — 뷰어 원본 JPEG images pass through unfiltered."New value: +"PDF-scan route only (뷰어 원본 JPEG unfiltered): images whose shorter side is under this many px are dropped as decoration (아이콘·괘선). Lower it to catch small 도장/서명."

Previous value: -"list: the attachment list only — nothing is downloaded, so it is the cheap call. text: the document body as 마크다운 via the 뷰어 원문 (XML→HTML) path — it skips PDF conversion, so text and tables are lossless and it is hundreds of times lighter. The primary path for sibling documents (정관·영업보고서·운영보고서 etc.) and the route to take whenever body text is what you want. images: return embedded images (도장·스캔본·차트 and other raster that text cannot capture). With NO filename/index it takes the 뷰어 원본 JPEG route (manifest.source=\"viewer\": originals in document order, per-section eleId); with filename or index it scans THAT attachment PDF instead (source=\"pdf\": decoded PNGs, largest area first, with page numbers; pages narrows it). The two routes return different field shapes. There is no file-parsing mode: an attachment file itself is reached through download_url, never parsed server-side."New value: +"list: attachment list only, nothing downloaded (cheap). text: document body as 마크다운 from the 뷰어 원문 — text·tables lossless. images: embedded raster (도장·스캔본·차트). No filename/index → 뷰어 원본 JPEG in document order, per-section eleId (manifest.source=\"viewer\"); filename or index → scans THAT attachment PDF: decoded PNGs in page order, with page numbers (source=\"pdf\"; pages narrows it)."

Previous value: -"Page filter for images mode (1-based, PDF-scan path only). e.g. \"3\", \"1-5\", \"2,4,7-9\". It narrows pages WITHIN the attachment picked by filename/index, so it requires one of them. Unset on a filename/index call = a scan of only that PDF's FIRST 40 pages. At most 2000 pages per call — a wider span is rejected, not silently trimmed."New value: +"images mode, PDF-scan route: 1-based pages WITHIN the attachment picked by filename/index (requires one), e.g. \"2,4,7-9\". Unset = that PDF's FIRST 40 pages only. Max 2000 pages per call — wider span rejected, not trimmed."

Previous value: -"14-digit 접수번호 (separators are stripped automatically)"New value: +"14-digit 접수번호; separators stripped."

Previous value: -"Which sections to fetch, in mode=\"text\" — the **sections[] array index** (0-based). NOT the eleId: in these documents eleId runs \"1\"..\"8\", so eleId happens to equal index+1 and is easy to confuse. e.g. to read the 3rd and 6th entries of sections[], pass [2, 5]. Unset = the previous behavior (the first 24 sections, all fetched). [] = 목차 only — zero body calls, sections[] carries just the titles (md_chars all 0); read them, then call again with the indices you want (2-pass). The pick happens BEFORE the 24-node ceiling, so it reaches sections 25~158 of a 사업보고서 본문 that are otherwise unreachable at any truncate_at. Max 24 picks; out-of-range indices are dropped with a note in `notes` (all-out-of-range is rejected). In this mode every sections[] entry carries its own index — check it against what you asked for (an off-by-one that stays in range otherwise returns a neighbouring section silently)."New value: +"mode=\"text\" only: 0-based **sections[] array index**, NOT eleId (often index+1) — e.g. 3rd·6th entries → [2, 5]; check each returned index against your picks. Unset = first 24 sections. [] = 목차 only (titles, md_chars 0) → call again with picks. Picks apply before the 24-section cap — only way to reach 사업보고서 본문 sections 25~158. Out-of-range indices dropped with a note; all out-of-range = rejected."

Previous value: -"Max length of the mode=text 마크다운 (default 100,000 chars; out-of-range values are clamped to the bound)"New value: +"mode=text 마크다운 cap in chars; default 100,000; out-of-range clamped."

Previous value: -"Page filter for images mode (1-based, PDF-scan path only). e.g. \"3\", \"1-5\", \"2,4,7-9\". It narrows pages WITHIN the attachment picked by filename/index, so it requires one of them. Unset on a filename/index call = a scan of only that PDF's FIRST 40 pages."New value: +"Page filter for images mode (1-based, PDF-scan path only). e.g. \"3\", \"1-5\", \"2,4,7-9\". It narrows pages WITHIN the attachment picked by filename/index, so it requires one of them. Unset on a filename/index call = a scan of only that PDF's FIRST 40 pages. At most 2000 pages per call — a wider span is rejected, not silently trimmed."

Previous value: -"Which sections to fetch, in mode=\"text\" — the **sections[] array index** (0-based). NOT the eleId: in these documents eleId runs \"1\"..\"8\", so eleId happens to equal index+1 and is easy to confuse. e.g. to read the 3rd and 6th entries of sections[], pass [2, 5]. Unset = the previous behavior (the first 24 sections, all fetched). [] = 목차 only — zero body calls, sections[] carries just the titles (md_chars all 0); read them, then call again with the indices you want (2-pass). The pick happens BEFORE the 24-node ceiling, so it reaches sections 25~158 of a 사업보고서 본문 that are otherwise unreachable at any truncate_at. Max 24 picks; out-of-range indices are dropped with a warning (all-out-of-range is rejected). In this mode every sections[] entry carries its own index — check it against what you asked for (an off-by-one that stays in range otherwise returns a neighbouring section silently)."New value: +"Which sections to fetch, in mode=\"text\" — the **sections[] array index** (0-based). NOT the eleId: in these documents eleId runs \"1\"..\"8\", so eleId happens to equal index+1 and is easy to confuse. e.g. to read the 3rd and 6th entries of sections[], pass [2, 5]. Unset = the previous behavior (the first 24 sections, all fetched). [] = 목차 only — zero body calls, sections[] carries just the titles (md_chars all 0); read them, then call again with the indices you want (2-pass). The pick happens BEFORE the 24-node ceiling, so it reaches sections 25~158 of a 사업보고서 본문 that are otherwise unreachable at any truncate_at. Max 24 picks; out-of-range indices are dropped with a note in `notes` (all-out-of-range is rejected). In this mode every sections[] entry carries its own index — check it against what you asked for (an off-by-one that stays in range otherwise returns a neighbouring section silently)."

Added value: +false

Previous value: -"Target 문서번호(dcmNo). Defaults to the 본문 document. One 공시(rcept_no) carries, besides the 본문, sibling documents (감사보고서·내부회계관리제도운영보고서·영업보고서·정관 etc.) each with its own dcmNo; take sibling_documents[].dcm_no from a list result to list/extract that document's attachments. A sibling's attachments are invisible without it — always list first, then pass sibling_documents[].dcm_no."New value: +"Target 문서번호(dcmNo). Defaults to the 본문 document. One 공시(rcept_no) carries, besides the 본문, sibling documents (감사보고서·내부회계관리제도운영보고서·영업보고서·정관 etc.) each with its own dcmNo; take sibling_documents[].dcm_no from a list result to read that document (list its attachments, or mode=text/images). A sibling's attachments are invisible without it — always list first, then pass sibling_documents[].dcm_no."

Previous value: -"Exact filename, in extract mode (no partial-match fallback). An EXACT match is required; on failure the error lists the available names."New value: +"Exact filename of the attachment to scan, in images mode (no partial-match fallback). Giving it PICKS the PDF-scan route — omit both filename and index to get the document's 뷰어 임베드 원본 JPEG instead. An EXACT match is required; on failure the error lists the available names."

Previous value: -"0-based index, in extract mode (filename takes precedence)"New value: +"0-based index of the attachment to scan, in images mode (filename takes precedence). Like filename it picks the PDF-scan route; omit both to get the 뷰어 임베드 원본 JPEG."

Previous value: -"list: the attachment list only — nothing is downloaded, so it is the cheap call. text: the document body as 마크다운 via the 뷰어 원문 (XML→HTML) path — it skips PDF conversion, so text and tables are lossless and it is hundreds of times lighter. The primary path for sibling documents (정관·영업보고서·운영보고서 etc.). extract: download and parse ONE attachment file (PDF/HWP/HWPX/DOCX/XLSX) into 마크다운 — when an actual file is the target, and the fallback when the 뷰어 cannot serve the body (supported:false, or a 껍데기 document whose body is just a PDF link) or when the original layout·날인 must be seen. images: return embedded images (도장·스캔본·차트 and other raster that text cannot capture) — 뷰어 원본 JPEG first (manifest.source=\"viewer\": originals in document order, per-section eleId), or a PDF page scan when pages is given (source=\"pdf\": decoded PNGs, largest area first, with page numbers). The two routes return different field shapes."New value: +"list: the attachment list only — nothing is downloaded, so it is the cheap call. text: the document body as 마크다운 via the 뷰어 원문 (XML→HTML) path — it skips PDF conversion, so text and tables are lossless and it is hundreds of times lighter. The primary path for sibling documents (정관·영업보고서·운영보고서 etc.) and the route to take whenever body text is what you want. images: return embedded images (도장·스캔본·차트 and other raster that text cannot capture). With NO filename/index it takes the 뷰어 원본 JPEG route (manifest.source=\"viewer\": originals in document order, per-section eleId); with filename or index it scans THAT attachment PDF instead (source=\"pdf\": decoded PNGs, largest area first, with page numbers; pages narrows it). The two routes return different field shapes. There is no file-parsing mode: an attachment file itself is reached through download_url, never parsed server-side."

Previous value: -[
-  "list",
-  "text",
-  "extract",
-  "images"
-]New value: +[
+  "list",
+  "text",
+  "images"
+]

Removed value: -{
-  "default": 50,
-  "description": "Max outline(목차) entries. A 사업보고서 outline runs to thousands → default 50. 0 = omit the outline.",
-  "maximum": 500,
-  "minimum": 0,
-  "type": "integer"
-}

Previous value: -"Page filter for images mode (1-based, PDF-scan path only). e.g. \"3\", \"1-5\", \"2,4,7-9\". When given, a PDF is fetched instead of the 뷰어 JPEG and those pages are scanned (pass the value text_quality.next_step hands you, or feed text_quality's ocr_candidate_pages / image_only_pages as-is — do not hand-scan the markdown for page numbers). When unset: 뷰어 원본 JPEG first, else a scan of only the PDF's FIRST 40 pages."New value: +"Page filter for images mode (1-based, PDF-scan path only). e.g. \"3\", \"1-5\", \"2,4,7-9\". It narrows pages WITHIN the attachment picked by filename/index, so it requires one of them. Unset on a filename/index call = a scan of only that PDF's FIRST 40 pages."

Previous value: -"Max length of the extract 마크다운 (default 100,000 chars; out-of-range values are clamped to the bound)"New value: +"Max length of the mode=text 마크다운 (default 100,000 chars; out-of-range values are clamped to the bound)"

Removed value: -{
-  "description": "Index of the file inside a ZIP attachment when extracting (0-based) — that inner file is the one parsed into 마크다운. If unset and the attachment is a ZIP, only the inner file list is returned. Use entries[].index verbatim (it indexes ALL inner files — do not guess).",
-  "minimum": 0,
-  "type": "integer"
-}

Added value: +{
+  "default": 0,
+  "description": "Start offset in document order for the 뷰어 원본 JPEG route (0-based, default 0). Channels with a response cap fit only ~1 scan page per call, so this is how you reach later pages — e.g. the 자금부정통제 표 is usually the 2nd page of an 운영실태보고서, so image_from=1. The response carries `from` and a note telling you the next offset. PDF-scan route uses pages instead.",
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "description": "Which sections to fetch, in mode=\"text\" — the **sections[] array index** (0-based). NOT the eleId: in these documents eleId runs \"1\"..\"8\", so eleId happens to equal index+1 and is easy to confuse. e.g. to read the 3rd and 6th entries of sections[], pass [2, 5]. Unset = the previous behavior (the first 24 sections, all fetched). [] = 목차 only — zero body calls, sections[] carries just the titles (md_chars all 0); read them, then call again with the indices you want (2-pass). The pick happens BEFORE the 24-node ceiling, so it reaches sections 25~158 of a 사업보고서 본문 that are otherwise unreachable at any truncate_at. Max 24 picks; out-of-range indices are dropped with a warning (all-out-of-range is rejected). In this mode every sections[] entry carries its own index — check it against what you asked for (an off-by-one that stays in range otherwise returns a neighbouring section silently).",
+  "items": {
+    "minimum": 0,
+    "type": "integer"
+  },
+  "maxItems": 24,
+  "type": "array"
+}

Previous value: -"Target 문서번호(dcmNo). Defaults to the 본문 document. One 공시(rcept_no) carries, besides the 본문, sibling documents (감사보고서·내부회계관리제도운영보고서·영업보고서·정관 etc.) each with its own dcmNo; take sibling_documents[].dcm_no from a list result to list/extract that document's attachments."New value: +"Target 문서번호(dcmNo). Defaults to the 본문 document. One 공시(rcept_no) carries, besides the 본문, sibling documents (감사보고서·내부회계관리제도운영보고서·영업보고서·정관 etc.) each with its own dcmNo; take sibling_documents[].dcm_no from a list result to list/extract that document's attachments. A sibling's attachments are invisible without it — always list first, then pass sibling_documents[].dcm_no."

Previous value: -"Exact filename, in extract mode (no partial-match fallback)"New value: +"Exact filename, in extract mode (no partial-match fallback). An EXACT match is required; on failure the error lists the available names."

Previous value: -"In images mode, an image whose shorter side is under this many pixels is treated as decoration (아이콘·괘선) and dropped. Default 24. Lower it to catch small 도장/서명."New value: +"In images mode, an image whose shorter side is under this many pixels is treated as decoration (아이콘·괘선) and dropped. Default 24. Lower it to catch small 도장/서명. It filters the PDF-scan path only (source:\"pdf\") — 뷰어 원본 JPEG images pass through unfiltered."

Previous value: -"list: the attachment list only. text: the document body as 마크다운 via the 뷰어 원문 (XML→HTML) path — it skips PDF conversion, so text and tables are lossless and it is hundreds of times lighter. The primary path for sibling documents (정관·영업보고서·운영보고서 etc.). extract: download and parse ONE attachment file (PDF/HWP etc.) into 마크다운 — when an actual file is the target. images: return embedded images (도장·스캔본·차트 and other raster that text cannot capture) — 뷰어 원본 JPEG first, or a PDF page scan when pages is given."New value: +"list: the attachment list only — nothing is downloaded, so it is the cheap call. text: the document body as 마크다운 via the 뷰어 원문 (XML→HTML) path — it skips PDF conversion, so text and tables are lossless and it is hundreds of times lighter. The primary path for sibling documents (정관·영업보고서·운영보고서 etc.). extract: download and parse ONE attachment file (PDF/HWP/HWPX/DOCX/XLSX) into 마크다운 — when an actual file is the target, and the fallback when the 뷰어 cannot serve the body (supported:false, or a 껍데기 document whose body is just a PDF link) or when the original layout·날인 must be seen. images: return embedded images (도장·스캔본·차트 and other raster that text cannot capture) — 뷰어 원본 JPEG first (manifest.source=\"viewer\": originals in document order, per-section eleId), or a PDF page scan when pages is given (source=\"pdf\": decoded PNGs, largest area first, with page numbers). The two routes return different field shapes."

Previous value: -"Page filter for images mode (1-based, PDF-scan path only). e.g. \"3\", \"1-5\", \"2,4,7-9\". When given, a PDF is fetched instead of the 뷰어 JPEG and those pages are scanned (pass the value text_quality.next_step hands you). When unset: 뷰어 원본 JPEG first, else a scan of the PDF's first 40 pages."New value: +"Page filter for images mode (1-based, PDF-scan path only). e.g. \"3\", \"1-5\", \"2,4,7-9\". When given, a PDF is fetched instead of the 뷰어 JPEG and those pages are scanned (pass the value text_quality.next_step hands you, or feed text_quality's ocr_candidate_pages / image_only_pages as-is — do not hand-scan the markdown for page numbers). When unset: 뷰어 원본 JPEG first, else a scan of only the PDF's FIRST 40 pages."

Previous value: -"Index of the file inside a ZIP attachment when extracting (0-based). If unset and the attachment is a ZIP, only the inner file list is returned."New value: +"Index of the file inside a ZIP attachment when extracting (0-based) — that inner file is the one parsed into 마크다운. If unset and the attachment is a ZIP, only the inner file list is returned. Use entries[].index verbatim (it indexes ALL inner files — do not guess)."

Previous value: -"대상 문서번호(dcmNo). 미지정 시 본문 문서. 한 공시(rcept_no)엔 본문 외에 형제 문서들(감사보고서·내부회계관리제도운영보고서·영업보고서·정관 등)이 각자 dcmNo로 딸려오며, list 결과의 sibling_documents[].dcm_no 로 그 문서의 첨부 파일을 list/extract 한다."New value: +"Target 문서번호(dcmNo). Defaults to the 본문 document. One 공시(rcept_no) carries, besides the 본문, sibling documents (감사보고서·내부회계관리제도운영보고서·영업보고서·정관 etc.) each with its own dcmNo; take sibling_documents[].dcm_no from a list result to list/extract that document's attachments."

Previous value: -"extract 모드에서 정확한 파일명 (부분일치 폴백 없음)"New value: +"Exact filename, in extract mode (no partial-match fallback)"

Previous value: -"extract 모드에서 0-based index (filename 우선)"New value: +"0-based index, in extract mode (filename takes precedence)"

Previous value: -"images 모드 최대 반환 이미지 수 (면적 큰 순). 기본 12."New value: +"Max images returned in images mode (largest area first). Default 12."

Previous value: -"images 모드에서 가로·세로 중 작은 변이 이 픽셀 미만이면 장식(아이콘·괘선)으로 보고 제외. 기본 24. 작은 도장/서명까지 잡으려면 낮춘다."New value: +"In images mode, an image whose shorter side is under this many pixels is treated as decoration (아이콘·괘선) and dropped. Default 24. Lower it to catch small 도장/서명."

Previous value: -"list: 첨부 목록만. text: 뷰어 원문(XML→HTML) 경로로 문서 본문을 마크다운으로 — PDF 변환을 안 거쳐 텍스트·표 무손실이고 수백 배 가볍다. 형제문서(정관·영업보고서·운영보고서 등) 1차 경로. extract: 첨부 파일(PDF/HWP 등) 하나를 다운·파싱해 마크다운 — 실물 파일이 대상일 때. images: 임베드 이미지(도장·스캔본·차트 등 텍스트로 안 잡히는 raster)를 이미지로 반환 — 뷰어 원본 JPEG 우선, pages 지정 시 PDF 페이지 스캔."New value: +"list: the attachment list only. text: the document body as 마크다운 via the 뷰어 원문 (XML→HTML) path — it skips PDF conversion, so text and tables are lossless and it is hundreds of times lighter. The primary path for sibling documents (정관·영업보고서·운영보고서 etc.). extract: download and parse ONE attachment file (PDF/HWP etc.) into 마크다운 — when an actual file is the target. images: return embedded images (도장·스캔본·차트 and other raster that text cannot capture) — 뷰어 원본 JPEG first, or a PDF page scan when pages is given."

Previous value: -"outline(목차) 최대 항목 수. 사업보고서 outline 은 수천 개 → 디폴트 50. 0=outline 생략."New value: +"Max outline(목차) entries. A 사업보고서 outline runs to thousands → default 50. 0 = omit the outline."

Previous value: -"images 모드 페이지 필터 (1-based, PDF 스캔 경로 전용). 예 \"3\", \"1-5\", \"2,4,7-9\". 지정하면 뷰어 JPEG 대신 PDF 를 받아 그 페이지들을 스캔한다(text_quality.next_step 이 주는 값을 그대로). 미지정 시 뷰어 원본 JPEG 우선, 없으면 PDF 앞 40페이지 스캔."New value: +"Page filter for images mode (1-based, PDF-scan path only). e.g. \"3\", \"1-5\", \"2,4,7-9\". When given, a PDF is fetched instead of the 뷰어 JPEG and those pages are scanned (pass the value text_quality.next_step hands you). When unset: 뷰어 원본 JPEG first, else a scan of the PDF's first 40 pages."

Previous value: -"접수번호 14자리(구분자는 자동 제거)"New value: +"14-digit 접수번호 (separators are stripped automatically)"

Previous value: -"extract 마크다운 최대 길이 (기본 10만 자, 범위 밖 값은 경계로 보정)"New value: +"Max length of the extract 마크다운 (default 100,000 chars; out-of-range values are clamped to the bound)"

Previous value: -"ZIP 첨부 extract 시 내부 파일 index (0-based). 미지정 & ZIP 인 경우 내부 파일 목록만 반환."New value: +"Index of the file inside a ZIP attachment when extracting (0-based). If unset and the attachment is a ZIP, only the inner file list is returned."