Plan: Free and above · Credits: 1 per call
What you can use Japan IR website disclosures for
Read a Japanese earnings release in English when the company publishes one. Get the AGM notice with the agenda and director slate, and the notice of what the meeting resolved. See when a company says it will report results or hold a briefing. Follow press releases and dividend announcements from the company’s own site.Subtypes
Named kinds:
Any other
subtype is the website’s own section passed through as found — for example press_release, earnings, filing, dividend or other. counts.by_subtype lists the ones this company has, so you can see what exists before filtering.
What a row is was decided from its title, not from the section of the website it was listed under; site_type keeps the section the site used. Transcripts and slides have their own endpoints: Japan IR Transcripts and Japan IR Presentation Decks.
Japan IR website coverage
Coverage is a fixed set of about 250 Japanese companies whose investor-relations websites are read continuously — not the whole market.coverage.companies_covered gives the current count; coverage.available_from and available_to give the date range for the company you asked about. History reaches the late 1990s where a site keeps an archive, and only recent years for most.
The endpoint covers Japanese companies only: any other company returns 404. If the website source cannot be read, the endpoint returns 503 rather than an empty list.
Key Japan IR website disclosure fields
titleandtitle_language(enorja) — as the site wrote it, untranslated.kindisir_web_disclosure;subtypeis a named kind or the site’s section.page_urlis the page the entry was found on;media_urlsare the linked files.documents— each linked document’sformat(pdforhtml),urlandchars.has_textsays whether any text was extracted; about 30% of website rows have none, which means “not extracted”, not “empty”.
company (company_id, ir_site_tickers, in_ir_web_universe) and counts: matched, in_this_tool, by_subtype, undated_excluded_by_date_filter and truncated_at_source.
Japan IR website date convention
Only a real calendar day becomesdate; date_status is date, datetime, period_label (a fiscal period such as 2012-FY, never turned into a day), ambiguous (such as 01/03/19, not guessed), invalid or missing, and date_as_written keeps the original. Rows come newest first — dated rows, then period-labelled rows, then undated rows. date_gte and date_lte apply to date only, and rows without one are counted in counts.undated_excluded_by_date_filter. See Japan IR Transcripts for the full table.
Pass include_text=true to add each document’s extracted text, capped at max_chars, with text_truncated. Take reported figures from Japan Financials, which reads the tagged values.
GET /v1/companies/{company}/jp/ir-web-disclosures
string
required
Tokyo symbol (
6758.T or 6758), five-digit EDINET security code, EDINET filer code, ADR symbol (SONY), ISIN or company_id of a Japanese company.string
A named kind (
results_summary, agm_convocation, schedule_notice, …) or the site’s own section (press_release, dividend, …).string
Case-insensitive substring of the title, English or Japanese.
string
Earliest
date, YYYY-MM-DD; date_lte sets the ceiling. Undated rows are excluded and counted.string
default:"false"
true adds each document’s extracted text.integer
default:"20000"
Text cap per document when
include_text=true, between 1,000 and 200,000.integer
default:"50"
Rows per page, between 1 and 200. Defaults to 10 when
include_text=true. Page through with cursor, passing back next_cursor unchanged.Related datasets
See also Japan TDnet Disclosures for the exchange’s timely-disclosure wire, Japan EDINET Disclosures for the statutory per-resolution AGM vote count, and Company Calendar (market=JP) for upcoming dates.