Name: Korea Company Financials & Risk API
Brand: 193market
SKU: api-193market-korea-company-financials-risk
Availability: InStock
Author: API Market

# Korea Company Financials & Risk API

## Overview

The Korea Company Financials & Risk API exposes South Korean corporate registry and financial data as structured JSON. It covers 710,719 companies with 976,744 rows of financial history and 1,428 recorded distress events, keyed on the corporate registration number (CRNO). You can search by name, pull a company record, walk its year-by-year financials, and check whether it has any distress events on file.

It is built for credit teams, procurement and KYB workflows that need to assess a Korean counterparty without reading Korean-language filings. Company names are returned in both Korean and English, and the coverage endpoint tells you exactly how much data stands behind any answer.

## Features

*   **710,719 Companies:** Registry records keyed on the corporate registration number (CRNO).
*   **Financial History:** 976,744 financial rows, filterable by year range with `year_from` and `year_to`.
*   **Distress Events:** 1,428 recorded distress events, queryable per company.
*   **Bilingual Names:** Company names returned in both Korean and English.
*   **Market Filtering:** Narrow a search to a specific market with the `market` parameter.
*   **Published Coverage:** `/v1/coverage` reports exact record counts so you can judge completeness.

## Use Cases

*   **Credit Assessment:** Review multi-year financials before extending terms to a Korean company.
*   **Supplier Due Diligence:** Confirm a supplier is registered and check for distress events.
*   **KYB Onboarding:** Resolve a company by registration number during onboarding.
*   **Market Research:** Analyse financial data across a market segment.

## API Documentation

### Base URL

All API requests for the Korea Company Financials & Risk API should be made to the following base URL:

```
https://prod.api.market/api/v1/193market/korea-company-financials-risk
```

### Authentication

Authentication is handled via an API key. You must include your key in the `x-api-market-key` header of every request:

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

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Service Health

Health check

**Method:** `GET`
**Endpoint:** `/health`

**Example Response (200 OK):**

```json
{
  "ok": true,
  "db_installed": true,
  "built_at": "2026-09-17T12:47:21",
  "counts": {
    "companies": 710719,
    "financial_rows": 976744,
    "distress_events": 1428,
    "financial_crnos": 262475,
    "financial_crnos_missing_company_info": 29897
  },
  "coverage_note": "29897 of 262475 companies with financial data have no name/address on file (금융위 기업기본정보 registry does not list them) -- lookups by crno still return financials, but name search and address will be null. See /v1/coverage."
}
```

#### 2. Search Korean Companies

Search companies by name, crno (법인등록번호) or business registration number

**Method:** `GET`
**Endpoint:** `/v1/companies/search`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `q` | query | Company name (English or Korean), 13-digit crno, or 10-digit business registration number, e.g. Samsung, 삼성전자, or 1101110000086 | `string` | Yes |  |  |
| `market` | query | Filter: KOSPI, KOSDAQ or leave empty for all | `string` | No |  |  |
| `page` | query | Page number, from 1 | `integer` | No | `1` |  |
| `per_page` | query | Results per page, 1-100 | `integer` | No | `20` |  |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/193market/korea-company-financials-risk/v1/companies/search?q=samsung&per_page=2" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK):**

```json
{
  "total": 716,
  "page": 1,
  "per_page": 2,
  "results": [
    {
      "crno": "1301110006246",
      "business_registration_number": "1248100998",
      "name": "SAMSUNG ELECTRONICS CO,.LTD",
      "name_en": "SAMSUNG ELECTRONICS CO,.LTD",
      "name_ko": "삼성전자(주)",
      "address": "경기도 수원시 영통구  삼성로 129 (매탄동)",
      "phone": "02-2255-0114",
      "fax": "031-200-7538",
      "homepage": "www.samsung.com/sec",
      "industry_ko": null,
      "main_business_ko": null,
      "established_on": "1969-01-13",
      "fiscal_year_end_month": "12",
      "market": "유가",
      "market_code": "P",
      "listing": {
        "kospi": {
          "listed_on": null,
          "delisted_on": null
        },
        "kosdaq": {
          "listed_on": null,
          "delisted_on": null
        },
        "krx_other": {
          "listed_on": null,
          "delisted_on": null
        }
      },
      "is_sme": null,
      "main_bank_ko": null,
      "employee_count": 128881,
      "avg_tenure_years": 13.7,
      "avg_annual_salary_krw": 158000000,
      "auditor_ko": "삼정회계법인",
      "audit_opinion_ko": "적정의견",
      "company_info_updated_at": "2025/12/01"
    },
    {
      "crno": "1345
  …
```

#### 3. Get Company by Registration Number

Company profile with its 2 most recent financial years and distress-event counts

**Method:** `GET`
**Endpoint:** `/v1/companies/{crno}`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `crno` | path | — | `string` | Yes |  |  |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/193market/korea-company-financials-risk/v1/companies/1301110006246" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK):**

```json
{
  "result": {
    "crno": "1301110006246",
    "business_registration_number": "1248100998",
    "name": "SAMSUNG ELECTRONICS CO,.LTD",
    "name_en": "SAMSUNG ELECTRONICS CO,.LTD",
    "name_ko": "삼성전자(주)",
    "address": "경기도 수원시 영통구  삼성로 129 (매탄동)",
    "phone": "02-2255-0114",
    "fax": "031-200-7538",
    "homepage": "www.samsung.com/sec",
    "industry_ko": null,
    "main_business_ko": null,
    "established_on": "1969-01-13",
    "fiscal_year_end_month": "12",
    "market": "유가",
    "market_code": "P",
    "listing": {
      "kospi": {
        "listed_on": null,
        "delisted_on": null
      },
      "kosdaq": {
        "listed_on": null,
        "delisted_on": null
      },
      "krx_other": {
        "listed_on": null,
        "delisted_on": null
      }
    },
    "is_sme": null,
    "main_bank_ko": null,
    "employee_count": 128881,
    "avg_tenure_years": 13.7,
    "avg_annual_salary_krw": 158000000,
    "auditor_ko": "삼정회계법인",
    "audit_opinion_ko": "적정의견",
    "company_info_updated_at": "2025/12/01",
    "recent_financials": [
      {
        "year": 2025,
        "basis_ko": "별도요약재무제표",
        "consolidated": false,
        "sales": 238043009000000
  …
```

#### 4. Get Company Financial History

Full yearly financial history for a company (2019-2025)

**Method:** `GET`
**Endpoint:** `/v1/companies/{crno}/financials`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `crno` | path | — | `string` | Yes |  |  |
| `year_from` | query | Earliest year, e.g. 2020 | `integer` | No |  |  |
| `year_to` | query | Latest year, e.g. 2024 | `integer` | No |  |  |
| `page` | query | — | `integer` | No | `1` |  |
| `per_page` | query | 1-100 | `integer` | No | `20` |  |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/193market/korea-company-financials-risk/v1/companies/1301110006246/financials?year_from=2020" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK):**

```json
{
  "crno": "1301110006246",
  "total": 14,
  "page": 1,
  "per_page": 2,
  "results": [
    {
      "year": 2025,
      "basis_ko": "별도요약재무제표",
      "consolidated": false,
      "sales": 238043009000000,
      "operating_profit": 23603619000000,
      "net_income_attributable_to_owners": 33436082000000,
      "net_income": 33686601000000,
      "total_assets": 358902051000000,
      "total_liabilities": 104571968000000,
      "total_equity": 254330083000000,
      "capital": 897514000000,
      "debt_ratio_pct": 41.1166334578,
      "currency": "KRW",
      "as_of": "2025-12-31"
    },
    {
      "year": 2025,
      "basis_ko": "연결요약재무제표",
      "consolidated": true,
      "sales": 333605938000000,
      "operating_profit": 43601051000000,
      "net_income_attributable_to_owners": 49481471000000,
      "net_income": 45206805000000,
      "total_assets": 566942110000000,
      "total_liabilities": 130621773000000,
      "total_equity": 436320337000000,
      "capital": 897514000000,
      "debt_ratio_pct": 29.937126905,
      "currency": "KRW",
      "as_of": "2025-12-31"
    }
  ],
  "attribution": {
    "source": "Financial Services Commission of Korea (금융위원회) — audited-corpor
  …
```

#### 5. Get Company Distress Events

DART filings for this company that signal financial distress

**Method:** `GET`
**Endpoint:** `/v1/companies/{crno}/distress-events`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `crno` | path | — | `string` | Yes |  |  |
| `page` | query | — | `integer` | No | `1` |  |
| `per_page` | query | 1-100 | `integer` | No | `50` |  |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/193market/korea-company-financials-risk/v1/companies/1301110006246/distress-events" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK):**

```json
{
  "crno": "1301110006246",
  "total": 0,
  "page": 1,
  "per_page": 2,
  "results": [],
  "notice": "Regulatory reference data as published by FSC/DART. Informational only; not investment or credit advice.",
  "attribution": {
    "source": "Financial Services Commission of Korea (금융위원회) — audited-corporation financial summaries and company registry; Financial Supervisory Service (금융감독원) DART — distress-signal filings",
    "via": "Public Data Portal of Korea (data.go.kr) datasets 15043459 (financials) and 15043184 (company basics); DART OpenAPI (opendart.fss.or.kr)",
    "license": "No usage restrictions (이용허락범위 제한 없음)",
    "changes": "Field names translated to English keys, dates normalised to ISO 8601, the three sources linked by crno (법인등록번호). Representative/CEO names are never collected or returned (개인정보).",
    "coverage": "Financial summaries cover externally-audited corporations only (외부감사대상), not every Korean company. See /v1/coverage for exact counts, including companies with financials but no name on file.",
    "notice": "Regulatory reference data as published by FSC/DART. Informational only; not investment or credit advice."
  }
}
```

#### 6. Get Dataset Coverage

What this dataset does and does not cover (free)

**Method:** `GET`
**Endpoint:** `/v1/coverage`

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/193market/korea-company-financials-risk/v1/coverage" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK):**

```json
{
  "counts": {
    "companies": 710719,
    "financial_rows": 976744,
    "distress_events": 1428,
    "financial_crnos": 262475,
    "financial_crnos_missing_company_info": 29897
  },
  "coverage_note": "29897 of 262475 companies with financial data have no name/address on file (금융위 기업기본정보 registry does not list them) -- lookups by crno still return financials, but name search and address will be null. See /v1/coverage.",
  "scope": "Financial summaries cover externally-audited corporations (외부감사대상) that filed with the FSC, 2019-2025. Not every registered Korean company has an audited filing.",
  "distress_events_scope": "DART filings of four kinds only: 부도발생(default), 회생절차개시신청(rehabilitation filing), 해산사유발생(dissolution cause), 영업정지(business suspension), from 2015 onward. Absence of an event here is not proof of good standing.",
  "excluded": "Representative/CEO names are never collected or returned.",
  "attribution": {
    "source": "Financial Services Commission of Korea (금융위원회) — audited-corporation financial summaries and company registry; Financial Supervisory Service (금융감독원) DART — distress-signal filings",
    "via": "Public Data Portal of Korea (data.go.kr) datasets 1504
  …
```

#### 7. Get Reference Codes

Market and distress-event code tables (free)

**Method:** `GET`
**Endpoint:** `/v1/codes`

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/193market/korea-company-financials-risk/v1/codes" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK):**

```json
{
  "market": [
    {
      "code": "P",
      "key": "KOSPI",
      "label_ko": "유가"
    },
    {
      "code": "Q",
      "key": "KOSDAQ",
      "label_ko": "코스닥"
    },
    {
      "code": "K",
      "key": "KONEX",
      "label_ko": "코넥스"
    },
    {
      "code": "N",
      "key": "UNLISTED",
      "label_ko": "비상장"
    },
    {
      "code": "E",
      "key": "OTHER",
      "label_ko": "기타"
    }
  ],
  "distress_event_type": [
    {
      "key": "default",
      "label_ko": "부도발생",
      "label_en": "Default"
    },
    {
      "key": "rehabilitation_filing",
      "label_ko": "회생절차개시신청",
      "label_en": "Court rehabilitation filing"
    },
    {
      "key": "dissolution_cause",
      "label_ko": "해산사유발생",
      "label_en": "Dissolution cause arose"
    },
    {
      "key": "business_suspension",
      "label_ko": "영업정지",
      "label_en": "Business suspension"
    }
  ],
  "attribution": {
    "source": "Financial Services Commission of Korea (금융위원회) — audited-corporation financial summaries and company registry; Financial Supervisory Service (금융감독원) DART — distress-signal filings",
    "via": "Public Data Portal of Korea (data.go.kr) datasets 15043459 (financials) and
  …
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| `200` | OK | The request succeeded and data has been returned. |
| `400` | Bad Request | The request contains invalid parameters or a malformed query. Review your request syntax. |
| `401` | Unauthorized | The `x-api-market-key` header is missing or contains an invalid key. |
| `403` | Forbidden | Your API key is valid but the origin rejected the request. |
| `404` | Not Found | The requested endpoint or record does not exist. Verify the URL path and identifier. |
| `429` | Too Many Requests | You have used all the API units included in your plan, or exceeded the per-second rate. See the Rate Limits section. |
| `500` | Internal Server Error | An unexpected server-side error occurred. Retry the request after a brief delay. |
| `503` | Service Unavailable | The service is temporarily unavailable. Retry with exponential backoff. |

## Rate Limits

The Basic plan includes 20 API units, Pro 500, Ultra 5,000 and Mega 25,000, each with a hard limit. When the included units are used up the API returns `429 Too Many Requests` until the plan renews. Paginate with `page` and `per_page` rather than requesting large result sets in one call.

## FAQ

*   **What is a CRNO?**
    The corporate registration number, the primary key for a Korean company across these endpoints. Get one from `/v1/companies/search`, then use it for the company, financials and distress-event lookups.

*   **Can I search in Korean?**
    Yes. `q` accepts Korean or English text, and results carry both name forms.

*   **How do I know how complete the data is?**
    Call `/v1/coverage`. It reports the exact number of companies, financial rows and distress events currently loaded.

*   **How far back do financials go?**
    Use `year_from` and `year_to` to bound the range. The response returns the years actually on file for that company.

## 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.


Financial summaries (2019-2025) and distress signals for 260,000+ Korean companies, as English JSON, straight from FSC/DART government data.

Korea Company Financials & Risk API