Docs/Reference/Filings/List Filings
GET/v1/filingsTier · Free

List Filings

List EDINET filings, filtered by date / company / doc_type.

Each row carries doc_id, doc_type (e.g. 120 annual, 130 semi-annual, 140 quarterly, 150 extraordinary, 220 buyback, 350/360 large-shareholding, 180 voting-results), filing date, fiscal year + period, accounting standard, and the issuer. Use this as the master index when you want to enumerate filings independent of company; pair since= with meta.sync_token for incremental ingest.

Query parameters · 8

Optional filters and modifiers. Pass as URL-encoded ?key=value.

date_fromstring · date | nulloptional

Start date (inclusive)

format date
date_tostring · date | nulloptional

End date (inclusive)

format date
company_codestring | nulloptional

EDINET or securities code

doc_typestring | nulloptional

Document type code

sincestring · date-time | nulloptional

Return filings received after this timestamp (ISO 8601). Use the sync_token from a previous response.

format date-time
limitintegeroptional

Results per page

default 50
offsetintegeroptional

Results to skip (ignored when cursor is set)

default 0
cursorstring | nulloptional

Opaque cursor for keyset pagination

Request headers · 1

Authentication.

Authorizationstringrequired

Production API key. Pass it as Bearer ax_live_…

Returns · 200

The standard { data, meta } envelope. data contains an array of FilingOut.

Envelope

dataFilingOut[]

Array of result objects.

metaMeta

Pagination and request metadata, including request_id, data_as_of, and ontology_version.

ontology_version 2.1.0replay meta.as_of · ?as_of=<token>

FilingOut

doc_idstring

EDINET document ID (e.g. 'S100ABCD'). Globally unique.

edinet_codestring

EDINET submitter code of the filing company.

doc_typestring

EDINET doc type code. 120=annual, 130=semi-annual, 140=quarterly, 150=extraordinary.

doc_type_labelstring | null

Japanese label for doc_type (e.g. '有価証券報告書').

fiscal_yearinteger

Fiscal year the filing covers.

period_startstring · date

First day of the reporting period.

format date
period_endstring · date

Last day of the reporting period.

format date
accounting_standardstring

Accounting standard used: 'Japan GAAP', 'IFRS', or 'US GAAP'.

filed_atstring · date-time | null

When the filing was submitted to EDINET. Null if not available.

format date-time
received_atstring · date-time

When Axiora ingested this filing from EDINET.

format date-time
doc_descriptionstring | null

Description from EDINET (e.g. '有価証券報告書 第120期').

created_atstring · date-time

When this record was created in Axiora.

format date-time

Errors

Standard HTTP status codes plus a typed error.code in the { error: { code, message } } envelope.

Every endpoint returns the same typed error envelope ({ error: { code, message } }). For the full list of codes, see the Errors reference.