Name: Korea DART API: Financials and Distress Scores
Brand: krdart
SKU: api-krdart-krdart-financials
Availability: InStock
Author: API Market

# KRDART Korea DART Financials API

## Overview

The KRDART Korea DART Financials API returns English JSON built on Korea's DART corporate disclosure system, run by the Financial Supervisory Service (FSS), together with pre-computed distress signals for KOSPI and KOSDAQ listed companies. It has 6 endpoints. Search finds a company by Korean name, English name or 6-digit stock ticker and gives you its 8-digit DART `corp_code`. With that code you can pull the company's master record, its financial statements with English account labels for a chosen year and report period, and a distress dashboard that combines the Altman Z-Score (Emerging Markets variant), the Piotroski F-Score, a count of risky filings in the last 90 days and a composite risk score. A separate events endpoint lists recent risky filings across the whole market, such as delisting risk, going-concern doubt and audit opinions, and a health endpoint reports uptime and the size of the company registry.

It is built for quant researchers, funds, cross-border compliance teams and fintech products that need Korean corporate data without reading Korean-language XBRL. Responses are flat JSON objects. Companies carry both `corp_name` (Korean) and `corp_name_eng`, statement lines carry `account_name_ko` next to a snake_case `account_name_en` such as `total_liabilities`, amounts are plain numbers with a `currency` field (`KRW`), and dates are `YYYYMMDD` strings. Distress results come with letter grades (`SAFE`, `GREY`, `DISTRESS`; `STRONG`, `MID`, `WEAK`; `LOW` to `CRITICAL`) so you can filter without working out thresholds yourself.

## Features

*   **6 endpoints**: Health check, company search, company master record, financial statements, distress signals and a market-wide risk-event feed.
*   **Simple inputs**: A Korean name, English name or 6-digit ticker for search, and the 8-digit DART `corp_code` for everything else.
*   **Large registry**: The health endpoint reported 119,448 registered entities in our test. The provider states that statements and distress scores cover about 4,000 KOSPI and KOSDAQ listed companies.
*   **English-labeled statements**: Balance sheet, income statement, cash flow and equity lines with Korean and English account names, current, prior and prior-prior period amounts, and consolidated or separate statement type.
*   **Annual and quarterly reports**: Choose the annual report, the half-year report or the Q1 and Q3 reports with the `reprt` code.
*   **Pre-computed distress scores**: Altman Z-Score (EM), Piotroski F-Score (0 to 9), a 90-day risk-event count and a composite risk score (0 to 100), served from a nightly cache.
*   **Risk-event feed**: Filter the last 1 to 90 days of filings across the market by type: `DELISTING_RISK`, `GOING_CONCERN`, `AUDIT_OPINION`, `MAJOR_SHAREHOLDER`, `COLLATERAL`, `LAWSUIT` or `CAPITAL_REDUCTION`, each with a severity from 1 to 5.
*   **Data source**: Disclosures filed with the FSS DART system. The API publishes derived indicators, event counts and English-normalized summaries, not the original XBRL.
*   **Rate limit**: 10 requests per second on Free, 20 on Pro, 100 on Ultra and 500 on Mega.

## Use Cases

*   **Distress screening**: Pull `/distress/{corp_code}` for each holding in a Korean portfolio and flag anything graded `DISTRESS` or with a `HIGH` or `CRITICAL` composite grade.
*   **Going-concern and delisting alerts**: Call `/events/recent?type=GOING_CONCERN&days=90` or `type=DELISTING_RISK` to see which companies filed those events recently.
*   **Cross-border compliance**: Monitor Korean subsidiaries, suppliers or counterparties for audit opinions, collateral pledges, lawsuits and major-shareholder changes.
*   **Quant research**: Collect Altman and Piotroski scores and statement lines by year to test signals against KOSPI and KOSDAQ returns.
*   **English financial dashboards**: Show Korean company financials to analysts who do not read Korean, using `account_name_en` labels.
*   **Ticker and name mapping**: Resolve a 6-digit stock code or English name to the DART `corp_code` and official Korean name.

## API Documentation

### Base URL

All requests go through the API.market gateway at this base URL:

```
https://prod.api.market/api/v1/krdart/krdart-financials
```

### Authentication

Every request needs your API.market key in the `x-api-market-key` header:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Health check

Returns whether the service is up, the number of entities in the DART company registry (`corp_count`) and a server timestamp `ts` in Unix milliseconds.

**Method:** `GET`

**Endpoint:** `/health`

**Parameters:** None.

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/krdart/krdart-financials/health" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK):**

```json
{
  "ok": true,
  "corp_count": 119448,
  "ts": 1792389928084
}
```

#### 2. Search companies

Searches the registry by Korean name, English name or 6-digit stock code and returns matching companies with their `corp_code`, Korean and English names, stock code and `market` (`LISTED` or `UNLISTED`). Listed companies are returned first. Use it to find the `corp_code` the other endpoints need.

**Method:** `GET`

**Endpoint:** `/companies/search`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `q` | query | Korean name, English name, or 6-digit stock code. | string | Yes | - | - |
| `limit` | query | Maximum number of results to return. | integer | No | `20` | 100 |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/krdart/krdart-financials/companies/search?q=samsung&limit=3" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged):**

```json
{
  "query": "samsung",
  "count": 3,
  "results": [
    {
      "corp_code": "00126308",
      "corp_name": "삼성E&A",
      "corp_name_eng": "SAMSUNG E&A CO.,LTD",
      "stock_code": "028050",
      "market": "LISTED"
    },
    {
      "corp_code": "01688896",
      "corp_name": "삼성FN리츠",
      "corp_name_eng": "SamsungFN REIT Co., Ltd.",
      "stock_code": "448730",
      "market": "LISTED"
    }
  ]
}
```

`stock_code` can be `null` for companies without a listed ticker.

#### 3. Get company

Returns the master record for one company: `corp_code`, Korean and English names, stock code, `market` and `modify_date` (the date the record was last changed, `YYYYMMDD`). A `corp_code` that is not in the registry returns `404`.

**Method:** `GET`

**Endpoint:** `/companies/{corp_code}`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `corp_code` | path | 8-digit DART company code, for example `00126380` for Samsung Electronics. Get it from `/companies/search`. | string | Yes | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/krdart/krdart-financials/companies/00126380" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK):**

```json
{
  "corp_code": "00126380",
  "corp_name": "삼성전자",
  "corp_name_eng": "SAMSUNG ELECTRONICS CO,.LTD",
  "stock_code": "005930",
  "market": "LISTED",
  "modify_date": "20251201"
}
```

#### 4. Get financial statements

Returns statement line items for one company, fiscal year and report period, across the balance sheet, income statement, cash flow statement and statement of changes in equity. Each item gives `statement` (`balance_sheet`, `income_statement`, `cash_flow` or `equity`), `fs_type` (`consolidated` or `separate`), the Korean account name in `account_name_ko`, an English snake_case label in `account_name_en`, and amounts for the current, prior and prior-prior periods (`current_amount`, `prior_amount`, `prior_prior_amount`) with their `currency`. Amounts can be `null` when a filing does not report them. The top level repeats the `corp_code`, `fiscal_year` and `report_type` you asked for and gives the item `count`.

**Method:** `GET`

**Endpoint:** `/financials/{corp_code}`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `corp_code` | path | 8-digit DART company code. | string | Yes | - | - |
| `year` | query | Fiscal year, for example `2024`. | integer | No | - | - |
| `reprt` | query | Report period: `11011` annual, `11012` half-year, `11013` Q1, `11014` Q3. | string | No | `11011` | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/krdart/krdart-financials/financials/00126380?year=2024&reprt=11011" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged):**

```json
{
  "corp_code": "00126380",
  "fiscal_year": 2024,
  "report_type": "11011",
  "count": 14,
  "items": [
    {
      "fiscal_year": 2024,
      "report_type": "annual",
      "fs_type": "consolidated",
      "statement": "balance_sheet",
      "account_id": "부채총계",
      "account_name_ko": "부채총계",
      "account_name_en": "total_liabilities",
      "current_amount": 88569470000000,
      "prior_amount": 72069515000000,
      "prior_prior_amount": 50667559000000,
      "currency": "KRW"
    },
    {
      "fiscal_year": 2024,
      "report_type": "annual",
      "fs_type": "consolidated",
      "statement": "balance_sheet",
      "account_id": "비유동부채",
      "account_name_ko": "비유동부채",
      "account_name_en": "non_current_liabilities",
      "current_amount": 8411494000000,
      "prior_amount": 30294414000000,
      "prior_prior_amount": 4581512000000,
      "currency": "KRW"
    }
  ]
}
```

At the top level `report_type` is the `reprt` code; inside each item it is written out as `annual`, `half`, `q1` or `q3`.

#### 5. Get distress signals

Returns the pre-computed distress dashboard for one company, served from a nightly cache:

*   `altman_z_em`: Altman Z-Score, Emerging Markets variant (Altman 2005). `altman_grade` is `SAFE` above 2.60, `GREY` from 1.10 to 2.60 and `DISTRESS` below 1.10.
*   `piotroski_f`: Piotroski F-Score from 0 to 9, with `piotroski_grade` of `STRONG`, `MID` or `WEAK`.
*   `risk_events_90d`: the number of risky filings in the last 90 days, listed in `recent_events`.
*   `composite_risk`: 0 to 100, higher is riskier, combining the Altman and Piotroski results with recent risky filings. `composite_grade` is `LOW`, `MEDIUM`, `HIGH` or `CRITICAL`.

`fiscal_year` and `report_type` tell you which report the scores were computed from, and `computed_at` is the computation time in Unix seconds. When a score cannot be computed it is `null` and its grade is `N/A`.

**Method:** `GET`

**Endpoint:** `/distress/{corp_code}`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `corp_code` | path | 8-digit DART company code. | string | Yes | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/krdart/krdart-financials/distress/00126380" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK):**

```json
{
  "corp_code": "00126380",
  "fiscal_year": 2025,
  "report_type": "11012",
  "altman_z_em": 8.571013729101125,
  "altman_grade": "SAFE",
  "piotroski_f": 2,
  "piotroski_grade": "MID",
  "risk_events_90d": 0,
  "composite_risk": 10,
  "composite_grade": "LOW",
  "computed_at": 1790478048,
  "recent_events": []
}
```

#### 6. Get recent risk events

Lists risky filings across all companies over the last `days` days. Each event gives `event_type`, a `severity` from 1 to 5, the filing date `event_dt` (`YYYYMMDD`), the original Korean filing title in `detail`, and the company's `corp_code`, Korean and English names and stock code. Leave out `type` to get every event type; the response then shows `"type": "all"`. `from` is the start date of the window.

**Method:** `GET`

**Endpoint:** `/events/recent`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `days` | query | Number of days to look back. | integer | No | `7` | 90 |
| `type` | query | Event type to return: `DELISTING_RISK`, `GOING_CONCERN`, `AUDIT_OPINION`, `MAJOR_SHAREHOLDER`, `COLLATERAL`, `LAWSUIT` or `CAPITAL_REDUCTION`. | string | No | All types | - |
| `limit` | query | Maximum number of events to return. | integer | No | `50` | 500 |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/krdart/krdart-financials/events/recent?days=7&limit=3" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged):**

```json
{
  "from": "20261012",
  "days": 7,
  "type": "all",
  "count": 3,
  "results": [
    {
      "event_type": "DELISTING_RISK",
      "severity": 5,
      "event_dt": "20261016",
      "detail": "투자유의안내              (관리종목지정 우려 예고)",
      "corp_code": "00104786",
      "corp_name": "미래아이앤지",
      "corp_name_eng": "MiraeING.Co.,Ltd.",
      "stock_code": "007120"
    },
    {
      "event_type": "DELISTING_RISK",
      "severity": 5,
      "event_dt": "20261016",
      "detail": "기타시장안내(관리종목지정우려종목)              (주가 1,000원 미달)",
      "corp_code": "01207716",
      "corp_name": "앱코",
      "corp_name_eng": "ABKO CO., LTD.",
      "stock_code": "129890"
    }
  ]
}
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request succeeded. |
| 400 | Bad Request | A parameter is invalid, for example `corp_code` is not 8 digits, `reprt` is not one of the four report codes, `type` is not a known event type, or `days` or `limit` is out of range. |
| 401 | Unauthorized | The `x-api-market-key` value is invalid or expired. |
| 403 | Forbidden | Your subscription does not include this endpoint. |
| 404 | Not Found | The `corp_code` is not in the DART company registry. |
| 429 | Too Many Requests | You went over your plan's requests-per-second limit, or you have used all the calls in your plan. |
| 500 | Internal Server Error | Something failed while processing the request. Retry after a short delay. |

## Rate Limits

Each plan has its own per-second limit: Free allows 10 requests per second, Pro 20, Ultra 100 and Mega 500. The plans include 3,000, 30,000, 750,000 and 6,500,000 calls respectively, and every call counts as one whichever endpoint you use. Requests above the per-second limit, or after the plan's calls are used up, return `429 Too Many Requests`. Back off before retrying and honour any `Retry-After` header. For a portfolio loop over `/distress/{corp_code}`, pace requests to stay under your plan's limit. In our tests the endpoints answered in about 0.8 to 1.2 seconds.

## FAQ

**How do I find a company's `corp_code`?**

Call `/companies/search?q=` with the Korean name, English name or 6-digit stock ticker. Each result has an 8-digit `corp_code`, for example `00126380` for Samsung Electronics (ticker `005930`). The `corp_code` is DART's own identifier and is different from the stock ticker.

**Which report periods can I request?**

Set `reprt` on `/financials/{corp_code}` to `11011` for the annual report, `11012` for the half-year report, `11013` for Q1 or `11014` for Q3. The default is `11011`. Use `year` to choose the fiscal year.

**Why does the distress endpoint show a different year from the one I asked for in financials?**

Distress scores are computed ahead of time from a report the provider has already processed, and the endpoint takes no year parameter. The `fiscal_year` and `report_type` fields in the response tell you which report was used; in our test Samsung Electronics was scored on its 2025 half-year report (`11012`).

**What do the grades mean?**

`altman_grade` is `SAFE` for an EM Z-Score above 2.60, `GREY` from 1.10 to 2.60 and `DISTRESS` below 1.10. `piotroski_grade` summarises the 0 to 9 F-Score as `STRONG`, `MID` or `WEAK`. `composite_risk` runs from 0 to 100, where higher means riskier, and `composite_grade` is `LOW`, `MEDIUM`, `HIGH` or `CRITICAL`. A grade of `N/A` means the score could not be computed for that company.

**Is everything in English?**

Company names come in both Korean (`corp_name`) and English (`corp_name_eng`), and statement lines have an English `account_name_en` next to the Korean `account_name_ko`. The `detail` field of a risk event is the original Korean filing title; use `event_type` for an English category.

**Where does the data come from and how fresh is it?**

The underlying disclosures come from Korea's FSS DART system. The API publishes derived indicators, event counts and English-normalized summaries; the original XBRL is not redistributed. The provider states that distress scores and the risk-event stream are refreshed nightly.

**Is this investment advice?**

No. All indicators are quantitative signals based on public filings, not recommendations to buy or sell any security.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Korea DART API returning English-labeled financial statements, Altman Z (EM) and Piotroski F scores, and a 90-day risk-event feed for KOSPI and KOSDAQ.

Korea DART API: Financials and Distress Scores

Free