# Korea DART Company Financials

> Korea DART Company Financials is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-12).

Retrieves normalized income statement, balance sheet, and cash flow data from Korean DART filings for a given company and fiscal year, mapped to a clean English-labeled schema with XBRL citations.

## Facts

- Endpoint: GET https://payai.agentstools.dev/korea/financials?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/korea-dart-company-financials-93eac6b5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qOol_FVO4A76rfsnNbL50

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability korea-dart-company-financials-93eac6b5
```

Example prompt: Pull the consolidated annual income statement, balance sheet, and cash flow for Samsung Electronics (ticker 005930) for fiscal year 2023 from Korean DART filings, with English labels.

## When to prefer this

Choose this endpoint when you need machine-readable, English-normalized financial statement data from official Korean regulatory filings (DART) for a specific company and year. It is superior to scraping raw DART HTML or working with untranslated Korean XBRL, and ideal when you need clean, citable income/balance/cashflow data for analysis, comparison, or agent-driven financial research on Korean equities.

## Known failure modes

- Company not found in DART if name, ticker, or corp code is invalid or misspelled
- Year before 2015 returns an error (minimum year enforced)
- Filing not available for the requested period or report type (e.g. quarterly data not filed)
- DART upstream outage or rate limiting causes timeout
- Separate vs consolidated basis not available for all companies
- Non-listed or unlisted companies may lack DART filings

## How this service works

Normalized company financials from Korea DART filings. Give a ticker, corp code or name plus a year and get income statement, balance sheet and cash flow lines mapped to one clean schema with English labels, each value cited to its XBRL account id and filing. Compact cited JSON instead of raw Korean statements.

## Output

A compact JSON object containing normalized financial statement lines (income statement, balance sheet, and/or cash flow) for the requested company and year. Each line item has an English label, numeric value, XBRL account ID, and a citation to the source DART filing, structured in a single clean schema regardless of which Korean company was queried.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "year"
     ],
     "properties": {
      "name": {
       "type": "string",
       "description": "Company name in English or Korean"
      },
      "year": {
       "type": "integer",
       "minimum": 2015,
       "description": "Business (fiscal) year, 2015 or later"
      },
      "basis": {
       "enum": [
        "consolidated",
        "separate"
       ],
       "type": "string",
       "description": "Statement basis, default consolidated"
      },
      "report": {
       "enum": [
        "annual",
        "half",
        "q1",
        "q3"
       ],
       "type": "string",
       "description": "Report period, default annual"
      },
      "ticker": {
       "type": "string",
       "description": "6-digit Korean stock code, e.g. 005930"
      },
      "corp_code": {
       "type": "string",
       "description": "8-digit DART corp code, e.g. 00126380"
      },
      "statements": {
       "type": "array",
       "items": {
        "enum": [
         "income",
         "balance",
         "cashflow"
        ],
        "type": "string"
       },
       "description": "Optional filter of which statements to return"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/korea-dart-company-financials-93eac6b5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)