### Install OpenDartReader CLI

Source: https://github.com/financedata/opendartreader/blob/master/README.md

Install or upgrade the OpenDartReader command-line interface using uv tool. This is the recommended method for CLI users.

```bash
uv tool install opendartreader

# 업그레이드
uv tool install --upgrade opendartreader
```

--------------------------------

### Get Company Overview

Source: https://github.com/financedata/opendartreader/blob/master/README.md

Retrieve a summary of a company's basic information using its name. The output is in JSON format by default.

```bash
# 기업 개황 조회 (기본 JSON 출력)
dart company "삼성전자"
```

--------------------------------

### Get All Company Filings for a Date Range

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Retrieve a list of all filings for all companies within a specified date range. This includes regular filings.

```python
dart.list(start='2022-01-01', end='2022-01-10')
```

--------------------------------

### Get Financial Statements for Multiple Companies

Source: https://github.com/financedata/opendartreader/blob/master/README.md

Fetch financial statements for multiple companies simultaneously by providing their stock codes or names, along with the desired year.

```bash
# 재무제표 조회 (여러 기업)
dart finstate "005930, 000660, 005380" 2021
dart finstate "삼성전자, SK하이닉스, 현대자동차" 2025
```

--------------------------------

### List Downloaded Files

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Use the `ls` command in your shell to list files matching a pattern, such as all files starting with '[삼성전자]' in the current directory. This helps verify downloaded files.

```shell
ls "[삼성전자]*"
```

--------------------------------

### Get Financial Statements

Source: https://github.com/financedata/opendartreader/blob/master/README.md

Retrieve financial statement data for a specific company and year. The output is in JSON format.

```bash
# 재무제표 조회 (JSON 출력)
dart finstate "삼성전자" 2023
```

--------------------------------

### Get All Periodic Reports for a Company Since a Specific Year

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Retrieve all periodic reports (including corrected ones) for a specific company from a specified start date. The 'A' kind parameter filters for periodic reports, and 'final=False' includes corrected filings.

```python
# 특정기업(삼성전자) 1999년~이후 모든 정기보고서 (정정된 공시포함)
dart.list('005930', start='1999-01-01', kind='A', final=False)
```

--------------------------------

### Get Company Overview by Name Search

Source: https://github.com/financedata/opendartreader/blob/master/README.md

Search for company overviews using a company name. This command may return multiple results if the name is not unique.

```bash
# 기업명 검색으로 개황 조회 (다수의 회사가 검색 됩니다)
dart company-by-name "삼성전자"
```

--------------------------------

### Get Periodic Reports for a Date Range

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Fetch periodic reports (like annual or quarterly reports) for all companies starting from a specific date. Note that searching without a `corp_code` is limited to a 3-month period.

```python
dart.list(start='2021-01-01', kind='A')
```

--------------------------------

### Get All Filings Including Amendments

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Retrieve all filings, including amended ones, for all companies within a specified date range. Use `final=False` to include amendments.

```python
dart.list(start='2022-01-01', end='2022-01-10', final=False)
```

--------------------------------

### Get Sub-Document Titles and URLs

Source: https://github.com/financedata/opendartreader/blob/master/README.md

List the titles and URLs of sub-documents within a main disclosure. You can also filter these by matching specific text in their titles.

```bash
# 하위 문서 제목과 URL
dart sub-docs 20220308000798
dart sub-docs 20220308000798 --match=감사의견
```

--------------------------------

### Get All Disclosures for a Specific Date

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Retrieves a list of all disclosures filed on a given date, including time information. This is useful for tracking daily filings.

```python
dart.list_date_ex('2022-01-03')
```

--------------------------------

### Fetch All Financial Statements (Samsung Electronics 2021)

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Retrieves all financial statements for a given company and year. Use this to get a comprehensive view of a company's financial health.

```python
df = dart.finstate_all('005930', 2021)

print('row count', len(df))
df.head()
```

--------------------------------

### Get Major Shareholders

Source: https://github.com/financedata/opendartreader/blob/master/README.md

Retrieve information about a company's major shareholders. This provides insights into the ownership structure of the company.

```bash
# 주요 주주 조회
dart shareholders "삼성전자"
```

--------------------------------

### List Disclosures for a Company (Default JSON)

Source: https://github.com/financedata/opendartreader/blob/master/README.md

Search for disclosures related to a specific company. By default, it retrieves disclosures from the past year. Specify start and end dates for custom ranges.

```bash
# 공시 검색 (삼성전자) 기간을 지정하지 않으면 지난 1년간 공시목록
dart list "삼성전자"

# 공시 검색 (삼성전자, 2024년 이후 전체) - 기본 JSON 출력
dart list "삼성전자" --start "2026-01-01"
```

--------------------------------

### Get Specific Report Item

Source: https://github.com/financedata/opendartreader/blob/master/README.md

Extract specific information, such as 'Dividends', from a company's annual report for a given year. This allows targeted data retrieval.

```bash
# 사업보고서 특정 항목 조회
dart report "삼성전자" "배당" 2023
```

--------------------------------

### list() - Search Disclosures (Individual Company)

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Search for reports of a specified company. You can specify the period and the type of report. The `start` and `end` parameters accept various date formats including datetime objects.

```APIDOC
## list() - Search Disclosures (Individual Company)

### Description
Search for reports of a specified company. You can specify the period and the type of report. The `start` and `end` parameters accept various date formats including datetime objects.

### Method Signature
```python
dart.list(corp, start=None, end=None, kind='', kind_detail='', final=True)
```

### Parameters
*   **corp** (str) - The name or code of the company to search for.
*   **start** (str or datetime, optional) - The start date for the search period. Defaults to None.
*   **end** (str or datetime, optional) - The end date for the search period. Defaults to None.
*   **kind** (str, optional) - The type of report to filter by. Defaults to ''.
*   **kind_detail** (str, optional) - The detailed type of report to filter by. Defaults to ''.
*   **final** (bool, optional) - Whether to retrieve only final reports. Defaults to True.

### Usage Example
```python
# Get all disclosures for Samsung Electronics since its listing
disclosures = dart.list('삼성전자')
print(disclosures.head())
```

### Response Example (DataFrame)
```
     corp_code corp_name stock_code corp_cls              report_nm  \
0     00126380      삼성전자     005930        Y    임원ㆍ주요주주특정증권등소유상황보고서   
1     00126380      삼성전자     005930        Y    임원ㆍ주요주주특정증권등소유상황보고서   
2     00126380      삼성전자     005930        Y    임원ㆍ주요주주특정증권등소유상황보고서   
3     00126380      삼성전자     005930        Y         최대주주등소유주식변동신고서   
4     00126380      삼성전자     005930        Y      기업설명회(IR)개최(안내공시)   

            rcept_no  flr_nm  rcept_dt rm  
0     20221018000007     이동하  20221018     
1     20221018000004     박훈철  20221018     
2     20221017000310     박태훈  20221017     
3     20221011800602    삼성전자  20221011  유  
4     20221007800064    삼성전자  20221007  유  

[5 rows x 9 columns]
```
```

--------------------------------

### Get Specific Company Disclosures by Date Range

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Retrieve a list of disclosures for a specific company within a given date range. Supports various date formats.

```python
dart.list('005930', start='2022-04-28', end='2022-04-28')
```

--------------------------------

### Get Attached Files Dictionary

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_reference_manual.ipynb

Retrieves a dictionary of attached files for a specific report, mapping file names to their URLs. Requires the report's reception number.

```python
dart.attach_files(rcp_no)
```

--------------------------------

### Get Attached File Information

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Call `dart.attach_files(rcp_no)` to retrieve a dictionary containing the titles and URLs of attached files. This is useful for understanding available files before downloading.

```python
# 첨부 파일 제목과 URL
files = dart.attach_files(rcp_no)
files
```

--------------------------------

### Iterate Through Attached Document Titles and URLs

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Use `dart.attach_docs(rcp_no)` to get a DataFrame of attached documents. Iterate through its rows to print the 'title' and 'url' for each document.

```python
for ix, row in dart.attach_docs(rcp_no).iterrows():
    print(row['title'])
    print(row['url'])
```

--------------------------------

### Retrieve All Disclosures for a Specific Day

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Call the `list` function with `start` and `end` dates to retrieve all disclosures made by any company on that specific day. Note that the search range is limited to 3 months when no company is specified.

```python
dart.list(start='20200701', end='20200701')
```

--------------------------------

### Get Securities Registration Statement Types

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_reference_manual.ipynb

Retrieves a list of available types for securities registration statements. This function helps identify the categories of financial documents related to securities.

```python
dart.regstate(corp, key_word, start=None, end=None)
```

--------------------------------

### Retrieve Reports for a Specific Company

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Use the `list` function with a company's stock code and a date range to retrieve all its periodic reports. Specify `kind='A'` to get the final reports.

```python
dart.list('005930', start='1999-01-01', kind='A')
```

--------------------------------

### Fetch Major Event Reports with OpenDartReader

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Use the `dart.event` function to retrieve major event reports for a corporation. Specify the corporation code or name, the event type, and optionally a start and end year.

```python
dart.event('052220', '영업정지', '2019') # iMBC(052220)
```

```python
dart.event('라이트론', '회생절차', '2019') # 라이트론(069540)
```

```python
dart.event('휴림네트웍스', '유상증자') # 휴림네트웍스(192410)
```

```python
dart.event('미원상사', '무상증자') # 미원상사(084990)
```

```python
dart.event('헬릭스미스', '유무상증자') # 헬릭스미스(084990)
```

```python
dart.event('미원상사', '감자') # 미원상사(084990)
```

```python
dart.event('한국조선해양', '소송', '2019') # 한국조선해양(009540)
```

```python
dart.event('035720', '해외상장결정', '2017') # 카카오(035720)
```

```python
dart.event('017810', '전환사채발행') # 풀무원(017810)
```

```python
dart.event('키다리스튜디오', '신주인수권부사채발행') #  키다리스튜디오(020120)
```

```python
dart.event('이스트소프트', '교환사채발행') # 이스트소프트(047560)
```

--------------------------------

### List Disclosures with Pretty Output

Source: https://github.com/financedata/opendartreader/blob/master/README.md

Retrieve a list of disclosures for a company and display them in a human-readable format. Useful for quick checks and manual review.

```bash
# 공시 검색 (삼성전자, 2025년 전체) - 사람이 보기 좋은 형식
dart list "삼성전자" --start "2025-01-01" --end "2025-12-31" --pretty
```

--------------------------------

### Download Disclosure Document (HTML)

Source: https://github.com/financedata/opendartreader/blob/master/README.md

Download the full text of a disclosure document, saving it as an HTML file. Use the document's unique identifier.

```bash
# 공시 서류 원문 다운로드 (.html 저장)
dart document 20220816001711
```

--------------------------------

### Download Financial Document

Source: https://github.com/financedata/opendartreader/blob/master/README.md

Downloads a financial document from a given URL to a specified filename. Ensure the URL and filename are correctly provided.

```python
url = 'http://dart.fss.or.kr/pdf/download/excel.do?rcp_no=20220308000798&dcm_no=8446647&lang=ko'
fn = '[삼성전자]사업보고서_재무제표(2022.03.08)_ko.xls'
dart.download(url, fn)
```

--------------------------------

### Download All Attached Files

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

First, retrieve the file information using `dart.attach_files(rcp_no)`. Then, iterate through the resulting dictionary and use `dart.download(url, title)` to save each file to your local system.

```python
# 첨부 파일 모두 다운로드 하기

files = dart.attach_files(rcp_no)
for title, url in files.items():
    print(title)
    print(url)
    dart.download(url, title)
```

--------------------------------

### Download All Attachments for a Report

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_reference_manual.ipynb

Iterates through all attached files for a given report reception number, prints their titles and URLs, and downloads each file to the current directory.

```python
# 첨부 파일 모두 다운로드 하기

rcp_no = '20220308000798' # 삼성전자 2021년 사업보고서

files = dart.attach_files(rcp_no)
for title, url in files.items():
    print(title)
    print(url)
    dart.download(url, title)
```

--------------------------------

### List All Disclosures for a Specific Day

Source: https://github.com/financedata/opendartreader/blob/master/README.md

Fetch all disclosures submitted on a particular day across all companies. The `--pretty` flag ensures human-readable output.

```bash
# 2026-05-04 하루 동안 모든 기업의 공시 목록
dart list --start "2026-5-4" --end "2026-5-4" --pretty
```

--------------------------------

### Download All Attachment Files

Source: https://github.com/financedata/opendartreader/blob/master/README.md

Iterates through attachment files for a given report number, prints their URLs and filenames, and then downloads each file. Requires a valid report number.

```python
for k in dart.attach_files('20221111000817'):
    url, fn = atts[k], k
    print(url, fn)
    dart.download(url, fn)
```

--------------------------------

### Download All Attached Files

Source: https://github.com/financedata/opendartreader/blob/master/README.md

Download all files attached to a specific disclosure, identified by its unique report identifier. This is useful for retrieving supplementary materials.

```bash
# 첨부 파일 모두 다운로드
dart attach-files 20221111000817
```

--------------------------------

### Download All Disclosure Documents

Source: https://github.com/financedata/opendartreader/blob/master/README.md

Download all associated disclosure documents for a given report identifier, saving each as a separate HTML file.

```bash
# 공시 서류 원문 모두 다운로드 (다수의 .html 저장)
dart document-all 20220816001711
```

--------------------------------

### Configure DART API Key

Source: https://github.com/financedata/opendartreader/blob/master/README.md

Set your DART API key either in a .env file in your project or as an environment variable. This is required for authentication with the DART API.

```dotenv
DART_API_KEY="your_api_key_here"
```

```bash
# API 키 설정 (환경변수)
export DART_API_KEY="your_api_key_here"
```

--------------------------------

### List Disclosures by Presenter and Type

Source: https://github.com/financedata/opendartreader/blob/master/README.md

Search for disclosures submitted by a specific presenter (e.g., a company or institution) within a date range and by disclosure type. Supported types include '정기공시', '주요사항보고', etc.

```bash
# 제출자명으로 목록 검색
# type: "정기공시","주요사항보고", "발행공시", "지분공시", "기타공시", "외부감사관련", "펀드공시", "자산유동화", "거래소공시", "공정위공시" (Regular Disclosure, Major Event Report, Issuance Disclosure, Equity Disclosure, Other Disclosure, External Audit Related, Fund Disclosure, Asset Securitization, Exchange Disclosure, Fair Trade Commission Disclosure)
dart list-presenter 국민연금공단 --start 2026-01-01 --end 2026-04-30 --type 지분공시
dart list-presenter 삼성전자 --start 2026-01-01 --type 주요사항보고
```

--------------------------------

### Create OpenDartReader Object

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Initialize the OpenDartReader object with your API key obtained from the Open DART website. The API key is a 40-character string of alphanumeric characters.

```python
import OpenDartReader

api_key = 'c19d19f2fae8006979b6e3670c8e8afe9d7d44cf'

dart = OpenDartReader(api_key)
```

--------------------------------

### download() - Save URL to File

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_reference_manual.ipynb

Saves a file from a given URL to a specified file path. This is useful for downloading attached documents.

```APIDOC
## download() - Save URL to File

### Description
Saves a file from a given URL to a specified file path. This is useful for downloading attached documents.

### Method
`dart.download(url, fn)`

### Parameters
* `url` (string): The URL of the file to download.
* `fn` (string): The file path where the downloaded file will be saved.

### Example Usage
```python
# Download all attached files for a specific report
rcp_no = '20220308000798' # Example receipt number for Samsung Electronics 2021 Business Report

files = dart.attach_files(rcp_no)
for title, url in files.items():
    print(f"Downloading: {title}")
    dart.download(url, title)
```
```

--------------------------------

### Retrieve Business Report Summary

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_reference_manual.ipynb

Fetches key information from a business report for a specified company, year, and report type. Requires company code, keyword, and business year.

```python
dart.report(corp, key_word, bsns_year, reprt_code='11011')
```

--------------------------------

### Load Excel File and List Sheet Names

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Use `pandas.ExcelFile` to open an Excel file. The `.sheet_names` attribute then provides a list of all sheet names within that file, which is useful for identifying which sheet to read.

```python
import pandas as pd

xl = pd.ExcelFile('[삼성전자]사업보고서_재무제표(2022.03.08)_ko.xls')
xl.sheet_names
```

--------------------------------

### Retrieve Document Lists for a Report

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Fetches lists of individual documents (sub_docs), attached documents (attach_docs), and attached files (attach_files) for a specific report using its reception number. This is essential for detailed analysis of a particular filing.

```python
rcp_no = '20220308000798' # 삼성전자 2021년 사업보고서
```

--------------------------------

### Retrieve All Financial Statements

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Fetches all financial statements for a given company and year. Supports both consolidated and separate financial statements.

```APIDOC
## finstate_all

### Description
Retrieves all financial statements for a specified company and year. The `reprt_code` parameter can be used to filter by report type (e.g., '11011' for business reports).

### Method
`dart.finstate_all(corp_code: str, year: int, reprt_code: str = '11011', fs_div: str = 'CFS')`

### Parameters
*   **corp_code** (str) - The company code or name.
*   **year** (int) - The fiscal year for which to retrieve financial statements.
*   **reprt_code** (str, optional) - The report code. Defaults to '11011' (business report).
*   **fs_div** (str, optional) - Financial statement division. Defaults to 'CFS' (consolidated financial statements).

### Response Example
```json
{
  "example": "DataFrame containing financial statement data"
}
```
```

--------------------------------

### regstate() - Registration Statement

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_reference_manual.ipynb

Retrieves information about registration statements. This function allows users to query specific types of registration statements.

```APIDOC
## regstate() - Registration Statement

### Description
Retrieves information about registration statements. This function allows users to query specific types of registration statements.

### Method
`dart.regstate(corp, key_word, start=None, end=None)`

### Parameters
* `corp` (string): The stock code of the target company.
* `key_word` (string): The type of registration statement to query. Available keywords include: '주식의포괄적교환이전', '합병', '증권예탁증권', '채무증권', '지분증권', '분할'.
* `start` (string, optional): Start date for the query.
* `end` (string, optional): End date for the query.
```

--------------------------------

### OpenDartReader Object Creation

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Instantiate the OpenDartReader object using your obtained API key. The API key can be acquired from the Open DART authentication key application page.

```APIDOC
## OpenDartReader Object Creation

### Description
Instantiate the OpenDartReader object using your obtained API key. The API key can be acquired from the Open DART authentication key application page.

### Code
```python
import OpenDartReader

api_key = 'YOUR_API_KEY'
dart = OpenDartReader(api_key)
```
```

--------------------------------

### Download URL to File

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_reference_manual.ipynb

Saves a file from a given URL to a specified local file path. This is useful for downloading attachments obtained from other OpenDartReader functions.

```python
retrieve(url, fn)
```

--------------------------------

### list_date_ex() - List of Reports for a Specific Date

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_reference_manual.ipynb

Retrieves a list of reports for a specific date, including the time of disclosure. This is an enhanced version of list_date().

```APIDOC
## list_date_ex() - List of Reports for a Specific Date

### Description
Retrieves a list of reports for a specific date, including the time of disclosure. This is an enhanced version of list_date().

### Method
`dart.list_date_ex(date)`

### Parameters
* `date` (string or datetime): The date to specify. If not provided, it defaults to the current date.

### Return Value
Returns the query results as a DataFrame. The columns include:
* `corp_code`: Unique code.
* `corp_name`: Company name.
* `corp_cls`: Corporate classification (Y: KOSPI, K: KOSDAQ, N: KONEX, E: ETC).
* `report_nm`: Report name.
* `rcept_no`: Receipt number.
* `flr_nm`: Name of the filing entity.
* `rcept_dt`: Filing date (includes time information).
* `rm`: Remarks.
```

--------------------------------

### attach_files() - List of Attached Files

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_reference_manual.ipynb

Retrieves a dictionary of attached files for a specific disclosure report, mapping file names to their URLs.

```APIDOC
## attach_files() - List of Attached Files

### Description
Retrieves a dictionary of attached files for a specific disclosure report, mapping file names to their URLs.

### Method
`dart.attach_files(rcp_no)`

### Parameters
* `rcp_no` (string): The receipt number of the disclosure report.

### Return Value
Returns a dictionary where keys are file names and values are their corresponding URLs (`{file_name: url}`).
```

--------------------------------

### Save Financial Statement XBRL XML File

Source: https://github.com/financedata/opendartreader/blob/master/README.md

Download the original XBRL XML file for a financial statement using its unique report identifier. This is useful for detailed analysis of raw financial data.

```bash
# 재무제표 XBRL 원본 파일 저장
dart finstate-xml 20220308000798
```

--------------------------------

### List Reports with Timestamp

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_reference_manual.ipynb

Retrieves a list of reports for a specific date, including the time of filing. Useful for tracking when disclosures were made.

```python
dart.list_date_ex(date)
```

--------------------------------

### sub_docs() - List of Sub-Documents

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_reference_manual.ipynb

Retrieves a list of sub-documents for a specific disclosure report. Useful for navigating hierarchical document structures.

```APIDOC
## sub_docs() - List of Sub-Documents

### Description
Retrieves a list of sub-documents for a specific disclosure report. Useful for navigating hierarchical document structures.

### Method
`dart.sub_docs(rcp_no, match)`

### Parameters
* `rcp_no` (string): The receipt number of the disclosure report.
* `match` (string): A search term to sort the sub-documents by relevance.

### Return Value
Returns a DataFrame with columns (`title`, `url`).
```

--------------------------------

### Search Reports by Presenter Name

Source: https://github.com/financedata/opendartreader/blob/master/README.md

Searches for financial reports submitted by a specific presenter within a date range and for a given report type. Ensure the presenter name, dates, and report type are accurate.

```python
dart.list_presenter('국민연금공단', start='2026-01-01', end='2026-05-01', report_type='지분공시')
```

--------------------------------

### Fetch and Print Document Titles and URLs

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Use the `sub_docs` function to retrieve a list of sub-documents for a given report number. Iterate through the resulting DataFrame to print the title and URL of each document.

```python
for ix, row in dart.sub_docs(rcp_no).iterrows():
    print(row['title'])
    print(row['url'])
```

--------------------------------

### Fetch Executive and Major Shareholder Ownership Reports

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Retrieves ownership reports specifically for executives and major shareholders. Accepts company code, name, or unique ID. Useful for tracking insider and significant stakeholder changes.

```python
df = dart.major_shareholders_exec('삼성전자') # 종목코드, 종목명, 고유번호 모두 가능

print('row count', len(df))
df.head()
```

--------------------------------

### report() - Business Report Key Information

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_reference_manual.ipynb

Retrieves key information from business reports. This function allows users to query specific details within a company's business report based on keywords.

```APIDOC
## report()

### Description
Retrieves key information from business reports. This function allows users to query specific details within a company's business report based on keywords.

### Method
`dart.report(corp, key_word, bsns_year, reprt_code='11011')`

### Parameters
* `corp` (string): The stock code of the target company. Can also accept unique ID or company name.
* `key_word` (string): Specifies the content to query. Refer to the 'key_word Items' section below. Examples: '증자', '배당', '자기주식', '최대주주', '최대주주변동', '소액주주', '임원', '직원', '임원개인보수', '임원전체보수', '개인별보수', '타법인출자'.
* `bsns_year` (string or integer): The business year.
* `reprt_code` (string): Report code ('11013' for Q1 report, '11012' for semi-annual report, '11014' for Q3 report, '11011' for business report).

### Key Word Items
| No. | Parameter String | Description |
|---|---|---|
| 1. | '증자' | Capital increase (reduction) status |
| 2. | '배당' | Matters related to dividends |
| 3. | '자기주식' | Status of acquisition and disposal of own shares |
| 4. | '최대주주' | Status of major shareholders |
| 5. | '최대주주변동' | Changes in major shareholders |
| 6. | '소액주주' | Status of minority shareholders |
| 7. | '임원' | Executive status |
| 8. | '직원' | Employee status |
| 9. | '임원개인보수' | Individual compensation for executives and auditors |
| 10. | '임원전체보수' | Total compensation for executives and auditors |
| 11. | '개인별보수' | Individual compensation payments (top 5 for amounts over 500 million KRW) |
| 12. | '타법인출자' | Investment status in other companies |

### Return Value
Returns the query results as a DataFrame. The columns of the DataFrame may vary depending on the `key_word` item specified.
* `rcept_no`: Receipt number
* `corp_cls`: Corporate classification (Y: KOSPI, K: KOSDAQ, N: KONEX, E: ETC)
* `corp_code`: Unique code
* `corp_name`: Corporate name

For the '배당' (dividends) keyword, additional columns include:
* `se`: Type (e.g., rights offering, conversion).
* `stock_knd`: Stock type.
* `thstrm`: Current period.
* `frmtrm`: Previous period.
* `lwfr`: Period before previous.
```

--------------------------------

### Search Company Disclosures

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Use the list() method to search for reports of a specified company. You can filter by date range and report type. The date format can be flexible.

```python
# 삼성전자 상장이후 모든 공시 목록 (5,600 건+)
dart.list('삼성전자')
```

--------------------------------

### attach_docs() - List of Attached Documents

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_reference_manual.ipynb

Retrieves a list of attached documents for a specific disclosure report. Provides titles and URLs for all attached files.

```APIDOC
## attach_docs() - List of Attached Documents

### Description
Retrieves a list of attached documents for a specific disclosure report. Provides titles and URLs for all attached files.

### Method
`dart.attach_docs(rcp_no, match)`

### Parameters
* `rcp_no` (string): The receipt number of the disclosure report.
* `match` (string): A search term to sort the attached documents by relevance.

### Return Value
Returns a DataFrame with columns (`title`, `url`).
```

--------------------------------

### List Specific Kind of Disclosures

Source: https://github.com/financedata/opendartreader/blob/master/README.md

Filter disclosures by their type, such as 'A' for regular disclosures. This helps in retrieving specific categories of financial reports.

```bash
# 2026년 1분기 정기 공시 목록
dart list --start "2026-01-01" --end "2026-03-31" --kind "A" --pretty
```

--------------------------------

### Fetch Major Shareholders Information

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Retrieves information about major shareholders of a company. Accepts company code, name, or unique ID. Use this to understand ownership structure.

```python
df = dart.major_shareholders('삼성전자') # 종목코드, 종목명, 고유번호 모두 가능

print('row count', len(df))
df.head()
```

--------------------------------

### List Sub-Documents of a Report

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_reference_manual.ipynb

Fetches a list of sub-documents associated with a specific disclosure report, identified by its reception number. Allows searching for specific sub-document titles.

```python
dart.sub_docs(rcp_no, match)
```

--------------------------------

### Retrieve Executive and Major Shareholder Ownership Reports

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Fetches reports detailing ownership by executives and major shareholders.

```APIDOC
## major_shareholders_exec

### Description
Retrieves reports specifically detailing the ownership of executives and major shareholders. This includes information on their roles and stock holdings.

### Method
`dart.major_shareholders_exec(corp_code: str)`

### Parameters
*   **corp_code** (str) - The company code, company name, or unique identifier.

### Response Example
```json
{
  "example": "DataFrame containing executive and major shareholder ownership data"
}
```
```

--------------------------------

### List Attached Documents of a Report

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_reference_manual.ipynb

Retrieves a list of attached documents for a given report reception number. Supports filtering by matching a keyword in the document titles.

```python
dart.attach_docs(rcp_no, match)
```

--------------------------------

### Fetch Major Event Reports

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_reference_manual.ipynb

Retrieves major event reports from a business report. Specify the company code and the type of event to search for.

```python
dart.event(corp, event, start=None, end=None)
```

--------------------------------

### Retrieve Major Shareholders Information

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Fetches information about major shareholders of a company, including their shareholdings and changes.

```APIDOC
## major_shareholders

### Description
Retrieves information on major shareholders for a given company. This includes details like report type, shareholder name, and share quantities.

### Method
`dart.major_shareholders(corp_code: str)`

### Parameters
*   **corp_code** (str) - The company code, company name, or unique identifier.

### Response Example
```json
{
  "example": "DataFrame containing major shareholder data"
}
```
```

--------------------------------

### Find Corporate Code by Stock Symbol or Name

Source: https://github.com/financedata/opendartreader/blob/master/README.md

Obtain the unique corporate code (CIK) for a company using its stock ticker symbol or its name. This code is often required for other DART API calls.

```bash
# 종목코드 혹은 기업명으로 고유번호 얻기
dart find-corp-code 005930
dart find-corp-code 삼성전자
```

--------------------------------

### event() - Major Event Report

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_reference_manual.ipynb

Retrieves major event items from business reports. This function allows users to fetch information on significant corporate events.

```APIDOC
## event() - Major Event Report

### Description
Retrieves major event items from business reports. This function allows users to fetch information on significant corporate events.

### Method
`dart.event(corp, event, start=None, end=None)`

### Parameters
* `corp` (string): The stock code of the target company.
* `event` (string): The type of major event to query. Available events include:
  '부도발생', '영업정지', '회생절차', '해산사유', '유상증자', '무상증자', '유무상증자', '감자', '관리절차개시', '소송', '해외상장결정', '해외상장폐지결정', '해외상장', '해외상장폐지', '전환사채발행', '신주인수권부사채발행', '교환사채발행', '관리절차중단', '조건부자본증권발행', '자산양수도', '타법인증권양도', '유형자산양도', '유형자산양수', '타법인증권양수', '영업양도', '영업양수', '자기주식취득신탁계약해지', '자기주식취득신탁계약체결', '자기주식처분', '자기주식취득', '주식교환', '회사분할합병', '회사분할', '회사합병', '사채권양수', '사채권양도결정'.
* `start` (string, optional): Start date for the query.
* `end` (string, optional): End date for the query.
```

--------------------------------

### Read Specific Sheet from Excel File

Source: https://github.com/financedata/opendartreader/blob/master/docs/OpenDartReader_users_guide.ipynb

Use `pd.read_excel` to read data from a specific sheet in an Excel file. Specify the file path and the `sheet_name`. The `skiprows` argument can be used to ignore header rows if necessary.

```python
pd.read_excel('[삼성전자]사업보고서_재무제표(2022.03.08)_ko.xls', sheet_name='연결 손익계산서', skiprows=6)
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.