{"uid":"cap_rHumbUou8eCyEG03D4D6V","slug":"korea-filings-search-korean-disclosures-by-ticker-5eb4c005","name":"Korea Filings — Search Korean Disclosures by Ticker","description":"AI summaries for the most recent DART filings of a Korean ticker","url":"https://api.koreafilings.com/v1/disclosures/by-ticker?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["ticker"],"properties":{"limit":{"type":"integer","description":"Max filings to return (1–50, default 5). Final price is 0.005 × limit USDC."},"ticker":{"type":"string","description":"Six-digit KRX ticker (e.g. 005930 for Samsung Electronics). Resolve from a company name first via the free /v1/companies?q={name} endpoint."}}},"responseSchema":{"type":"json","example":{"rcptNo":"20260424900874","eventType":"OTHER","summaryEn":"AI-generated English summary of the disclosure.","sectorTags":["Capital Goods"],"tickerTags":["095440"],"generatedAt":"2026-04-24T09:00:00Z","actionableFor":["traders"],"importanceScore":7}},"example":{"request":{"limit":5,"ticker":"005930"},"response":{"count":5,"ticker":"005930","delivered":5,"summaries":[{"rcptNo":"20260608800918","eventType":"MAJOR_SHAREHOLDER_TRANSACTION","sectorTags":[],"tickerTags":["005930"],"generatedAt":"2026-06-08T08:05:46.238965Z","actionableFor":["traders"],"importanceScore":5},{"rcptNo":"20260608000002","eventType":"MAJOR_SHAREHOLDER_FILING","sectorTags":[],"tickerTags":["005930"],"generatedAt":"2026-06-07T23:21:26.570236Z","actionableFor":["traders"],"importanceScore":3},{"rcptNo":"20260605000586","eventType":"MAJOR_SHAREHOLDER_FILING","sectorTags":[],"tickerTags":["005930"],"generatedAt":"2026-06-05T08:04:58.204849Z","actionableFor":["traders"],"importanceScore":3},{"rcptNo":"20260605000073","eventType":"MAJOR_SHAREHOLDER_FILING","sectorTags":[],"tickerTags":["005930"],"generatedAt":"2026-06-05T00:54:59.320753Z","actionableFor":["traders"],"importanceScore":3},{"rcptNo":"20260605000061","eventType":"MAJOR_SHAREHOLDER_FILING","sectorTags":[],"tickerTags":["005930"],"generatedAt":"2026-06-05T00:46:45.271776Z","actionableFor":["traders"],"importanceScore":3}],"chargedFor":5}},"exampleRequest":{"limit":5,"ticker":"005930"},"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JNEgYgV3auoJYQ2L5PhEk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieve AI-summarized DART filings for a KRX-listed company by its six-digit ticker, paying per call in USDC via x402 on Base","exampleAgentPrompt":"Pull the 10 most recent DART filings for Samsung Electronics (ticker 005930) from Korea Filings and give me English summaries of each one.","exampleUseCases":null,"resultDescription":"Returns a JSON object per filing including: receipt number, event type classification, an AI-generated English summary of the disclosure, sector tags, ticker tags, an importance score (1–10), a list of who the filing is actionable for (e.g. traders), and a timestamp of when the summary was generated. Up to 50 filings can be returned per call; the cost scales at $0.005 USDC per filing requested.","failureModes":["Invalid or non-existent KRX ticker returns an error or empty results","Limit value outside 1–50 range causes a validation error","Payment failure via x402 results in a 402 Payment Required response","No recent filings available for the ticker returns an empty array","Network or DART upstream outage causes a 503 or timeout"],"whenToPreferThis":"Use this endpoint when you need English-language, AI-summarized DART filings for a specific KRX-listed company identified by its six-digit ticker. It is the right choice for autonomous agents that want structured, actionable Korean disclosure data without API key registration, paying only for what they consume via micropayment on Base. It is preferable to raw DART scraping because it returns pre-parsed, English-summarized, importance-scored results ready for downstream reasoning.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T06:36:32.345Z","isFirstParty":false,"canonicalSlug":"korea-filings-search-korean-disclosures-by-ticker-5eb4c005"}