Plan: Free and above · Credits: 1 per call
What You Can Use China Disclosures For
See what an A-share company filed and when. Find every profit pre-announcement a company made since 2023. Link a periodic report to the PDF it was published as. Trace a figure from Mainland China Financials back to the announcement that carried it. For when a periodic report first became public, Mainland China Report Timing answers directly, one row per period, instead of making you find the announcement.A Midnight Timestamp Is Not a Time
Type Codes Are the Filer’s Own Numbers
announcement_types holds the site’s own numeric codes, returned verbatim. No code-to-name table is published, so a name here would be our reading rather than the filer’s.
The useful ones:
One announcement carries several codes, so
announcement_type matches any announcement carrying that code — not announcements of that kind only.
One Report, Several Filings
A periodic report is usually filed as several separate announcements: the main text, the summary and sometimes an English version. Each is its own row with its ownannouncement_id.
Key China Disclosure Fields
Each row carriesannouncement_id, company_id, the six-digit sec_code, the Chinese short name sec_name, the market (sse for Shanghai, for example), announce_date, announced_at, has_clock_time, the Chinese title, announcement_types, filing_url for the PDF, and adjunct_size_kb.
China Disclosures Language
Titles are in Simplified Chinese and are not translated.China Disclosures Coverage
Coverage runs from 2023-01-03, updated daily.coverage.history_status on the response is backfilled_from_2023_01.
China Disclosures Date Convention
date_gte and date_lte filter on announce_date, the Beijing calendar day of the announcement.
China Disclosures Sources
Announcements come from cninfo, the disclosure site the Chinese securities regulator designates — the companies’ own filings.GET /v1/companies/{company_id}/cn/disclosures
Announcements for one mainland-listed company, newest first.string
required
A six-digit security code (
600519), a suffixed ticker (600519.SS, 000333.SZ, 920680.BJ), an ISIN or a company_id.string
Earliest announcement date (Beijing calendar day),
YYYY-MM-DD. date_lte sets the ceiling.string
One numeric type code, for example
012111 for a profit pre-announcement. Matches announcements carrying that code.integer
default:"50"
Rows per page, between 1 and 200. Page through with
cursor.