{"openapi":"3.1.0","info":{"title":"Axiora API","description":"Verifiable financial intelligence for Japanese equities: shareholding trajectories, signals, activist monitoring, and EDINET-derived company data.\n\n## Verifiability\n\nEvery row is built to be cited and audited. Three guarantees:\n\n**1. Source traceability**. Wherever a row comes from a single filing, the response carries the `doc_id` (EDINET / TDNet) so you can pull the original disclosure. Derived analytics declare themselves via `meta.caveats` and expose `meta.data_as_of` for source freshness.\n\n**2. Reproducibility**. Every derived response echoes a `meta.as_of` token. Capture it, replay later with `?as_of=<token>`, and you get bit-identical rows regardless of how the underlying data has evolved. One token round-trips the exact answer you cited.\n\n**3. Honest gaps**. Where coverage is incomplete (some filings don't have all sections translated yet, English entity names vary in trust level) the response surfaces it: `text_en` is null where untranslated, `name_en_quality` tiers English names as `verified` / `derived` / `machine` / `null`, and `meta.caveats` calls out per-endpoint context such as TDNet vs EDINET sourcing or stock-split-unadjusted history.\n\nSee `/freshness` for current ingest lag and `/coverage` for per-metric completeness.","version":"0.4.0"},"paths":{"/v1/health":{"get":{"tags":["health"],"summary":"Health","description":"Shallow health check: confirms the process is alive.\n\nAlso reports the read snapshot THIS instance is serving. That crosses the\nprocess boundary: the sentinel is a separate job and cannot see the API's\nmemory, so this is how a stale instance: one that never picked up a publish, becomes visible from outside.","operationId":"health_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthCheckOut"}}}}}}},"/v1/health/deep":{"get":{"tags":["health"],"summary":"Health Deep","description":"Deep health check: verifies DB connectivity and ingest evidence.","operationId":"health_deep_v1_health_deep_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeepHealthCheckOut"}}}}}}},"/v2/types":{"get":{"tags":["v2"],"summary":"Get Types","description":"Every entity type and fact type: fields, units, roles, ID scheme, tier.","operationId":"get_types_v2_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TypesOut"}}}}}}},"/v2/facts":{"get":{"tags":["v2"],"summary":"List Facts","description":"Facts of one type, newest known first.","operationId":"list_facts_v2_facts_get","parameters":[{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Fact type (required). See /v2/types.","title":"Type"},"description":"Fact type (required). See /v2/types."},{"name":"entity","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Entity ID, e.g. company:E00883.","title":"Entity"},"description":"Entity ID, e.g. company:E00883."},{"name":"role","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The entity's role in the fact, e.g. issuer.","title":"Role"},"description":"The entity's role in the fact, e.g. issuer."},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"valid_as_of on or after (YYYY-MM-DD).","title":"Since"},"description":"valid_as_of on or after (YYYY-MM-DD)."},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"valid_as_of on or before (YYYY-MM-DD).","title":"Until"},"description":"valid_as_of on or before (YYYY-MM-DD)."},{"name":"as_of","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Point in time: only facts known by then.","title":"As Of"},"description":"Point in time: only facts known by then."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/changes":{"get":{"tags":["v2"],"summary":"List Changes","description":"What became known since a time, newest first, across the types the key may read.","operationId":"list_changes_v2_changes_get","parameters":[{"name":"since","in":"query","required":true,"schema":{"type":"string","description":"Facts that became known after this time (ISO 8601).","title":"Since"},"description":"Facts that became known after this time (ISO 8601)."},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"One fact type; all readable types if omitted.","title":"Type"},"description":"One fact type; all readable types if omitted."},{"name":"entity","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/entities":{"get":{"tags":["v2"],"summary":"List Entities","description":"Entities of one type, optionally filtered by name or code.","operationId":"list_entities_v2_entities_get","parameters":[{"name":"type","in":"query","required":true,"schema":{"type":"string","description":"Entity type: company, holder or filing.","title":"Type"},"description":"Entity type: company, holder or filing."},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Name or code contains.","title":"Q"},"description":"Name or code contains."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/entities/{entity_id}":{"get":{"tags":["v2"],"summary":"Get Entity","description":"One entity, optionally with facts of the listed types.","operationId":"get_entity_v2_entities__entity_id__get","parameters":[{"name":"entity_id","in":"path","required":true,"schema":{"type":"string","maxLength":72,"title":"Entity Id"}},{"name":"include","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated fact types; 50 each.","title":"Include"},"description":"Comma-separated fact types; 50 each."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityOne"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/search":{"get":{"tags":["v2"],"summary":"Search","description":"Find a company or a holder.","operationId":"search_v2_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"description":"Company name or code, or holder name.","title":"Q"},"description":"Company name or code, or holder name."},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"company or holder; both if omitted.","title":"Type"},"description":"company or holder; both if omitted."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/companies/{code}":{"get":{"tags":["v2"],"summary":"Get Company","description":"A company, with what you ask for.","operationId":"get_company_v2_companies__code__get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"title":"Code"}},{"name":"include","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"holders,trends,financials,votes,board,signals","title":"Include"},"description":"holders,trends,financials,votes,board,signals"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityOne"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/holders/{holder_code}":{"get":{"tags":["v2"],"summary":"Get Holder","description":"A holder, with its positions and trends.","operationId":"get_holder_v2_holders__holder_code__get","parameters":[{"name":"holder_code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"title":"Holder Code"}},{"name":"include","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"positions,trends,signals,group_positions","title":"Include"},"description":"positions,trends,signals,group_positions"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityOne"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/positions":{"get":{"tags":["v2"],"summary":"List Positions","description":"Position facts for a company, a holder, or one holder in one company.","operationId":"list_positions_v2_positions_get","parameters":[{"name":"company","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Issuer: EDINET code, securities code or 法人番号.","title":"Company"},"description":"Issuer: EDINET code, securities code or 法人番号."},{"name":"holder","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Holder: EDINET code, LEI or any Axiora holder id.","title":"Holder"},"description":"Holder: EDINET code, LEI or any Axiora holder id."},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Since"}},{"name":"as_of","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FactList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/filings":{"get":{"tags":["v2"],"summary":"List Filings","description":"Filings, newest first.","operationId":"list_filings_v2_filings_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Document ID or description contains.","title":"Q"},"description":"Document ID or description contains."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/filings/{doc_id}":{"get":{"tags":["v2"],"summary":"Get Filing","description":"One filing's metadata and link.","operationId":"get_filing_v2_filings__doc_id__get","parameters":[{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","maxLength":30,"title":"Doc Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityOne"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/identifiers":{"get":{"tags":["identifiers"],"summary":"Resolve Identifier","description":"Resolve an identifier of unknown kind to the entity it names.\n\nAnswers what the identifier IS (`name`, `entity_id`, cross-references) and\nwhere it WORKS (`roles`, and a `links` map from each role to the endpoint\nthat serves it), so a caller holding an unfamiliar string reaches the data\nin one follow-up request instead of probing resources until one answers.","operationId":"resolve_identifier_v1_identifiers_get","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":64,"description":"Any identifier form. Accepted forms: an EDINET code (E12345), a securities code (7203), a 13-digit corporate number (法人番号), or an investor identifier as returned by /v1/investors/search.","title":"Id"},"description":"Any identifier form. Accepted forms: an EDINET code (E12345), a securities code (7203), a 13-digit corporate number (法人番号), or an investor identifier as returned by /v1/investors/search."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_IdentifiersOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/batch/identifiers":{"post":{"tags":["identifiers"],"summary":"Batch Resolve Identifiers","description":"Resolve up to 100 identifiers of any kind in one request.\n\nEvery input is accounted for: identifiers that match no entity are named in\n`meta.unresolved` rather than dropped, so a caller can always reconcile the\nresponse against what they sent.","operationId":"batch_resolve_identifiers_v1_batch_identifiers_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchIdentifiersRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_IdentifiersOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/freshness":{"get":{"tags":["freshness"],"summary":"Get Freshness","description":"How fresh is the data right now.\n\nReturns the observed completion timestamp of the most recent EDINET\ningest run, its public status, the lag in minutes since that result\nbecame visible, and when the next poll is scheduled. Use this to decide\nwhether to trust a near-realtime answer (low lag) or wait for the next\ncycle (high lag, retrying / failed status).\n\nPublic endpoint: no auth required.","operationId":"get_freshness_v1_freshness_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_FreshnessOut_"}}}}}}},"/v1/companies/search":{"get":{"tags":["companies"],"summary":"Search Companies","description":"Search companies by name, former name, securities code, EDINET code, or\n13-digit corporate number (法人番号).\n\nReturns results ranked by match quality: exact code matches first,\nthen prefix matches, then substring matches. A company that renamed is\nfound by its former names too; each result lists them in `former_names`.","operationId":"search_companies_v1_companies_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"description":"Search query","title":"Q"},"description":"Search query"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_CompanySearchOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies":{"get":{"tags":["companies"],"summary":"List Companies","description":"List companies, with optional sector / name / securities_code filters.\n\nReturns one row per company with EDINET code, securities code,\nJapanese + English names (with `name_en_quality` audit tag),\nsector, listing market, and entity_type. Use `since=<timestamp>`\nfor incremental sync: pair with the `sync_token` in `meta`.","operationId":"list_companies_v1_companies_get","parameters":[{"name":"sector","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Sector"}},{"name":"name","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Name"}},{"name":"securities_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":10},{"type":"null"}],"title":"Securities Code"}},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Return companies updated after this timestamp (ISO 8601). Use the sync_token from a previous response.","title":"Since"},"description":"Return companies updated after this timestamp (ISO 8601). Use the sync_token from a previous response."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":50,"title":"Limit"},"description":"Results per page"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Results to skip (ignored when cursor is set)","default":0,"title":"Offset"},"description":"Results to skip (ignored when cursor is set)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor for keyset pagination","title":"Cursor"},"description":"Opaque cursor for keyset pagination"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_CompanyOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}":{"get":{"tags":["companies"],"summary":"Get Company","description":"One company by code (EDINET or securities), optionally expanded.\n\nReturns the company's identifiers, sector, listing, and English-\nname audit fields. Pass `expand=` to inline sub-resources in a\nsingle round-trip: supported: `financials`, `ratios`, `growth`,\n`peers`, `segments`, `translations`, `health_score`. Use\n`expand=all` to grab everything your plan includes.","operationId":"get_company_v1_companies__code__get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"title":"Code"}},{"name":"expand","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated sub-resources to include: financials, ratios, growth, peers, segments, translations, health_score. Use 'all' for everything. Each value needs the plan of the route that serves it on its own: on Free, financials and ratios are included; growth, segments, translations and health_score need Developer. A value is open wherever its own route is open to your key for this company. When it is not: named, 403 TIER_REQUIRED; under 'all', left out and listed in meta.expand_withheld. Peers list each company's identity with its figures null.","title":"Expand"},"description":"Comma-separated sub-resources to include: financials, ratios, growth, peers, segments, translations, health_score. Use 'all' for everything. Each value needs the plan of the route that serves it on its own: on Free, financials and ratios are included; growth, segments, translations and health_score need Developer. A value is open wherever its own route is open to your key for this company. When it is not: named, 403 TIER_REQUIRED; under 'all', left out and listed in meta.expand_withheld. Peers list each company's identity with its figures null."},{"name":"years","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":5,"title":"Years"}},{"name":"peer_limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Max peers to return (default 10)","default":10,"title":"Peer Limit"},"description":"Max peers to return (default 10)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_CompanyExpandedOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/financials":{"get":{"tags":["companies"],"summary":"Get Financials","description":"Historical financials for one company, with full filing-level provenance.\n\nReturns up to `years` of XBRL-parsed financial rows from EDINET\nannual (120), amended annual (130), or quarterly (140) filings.\nEach row carries `source_doc_id`, `accounting_standard` (JP-GAAP /\nIFRS / US-GAAP), and the fiscal period. Pass `fields=` to scope\nto specific metrics, `include=explanations,sources` to fold in\nnull-reason explanations and per-field XBRL element provenance.\nPass `doc_id=` to retrieve one older filing beyond the recent-row window.\n\nThis endpoint does not paginate. Row count is controlled by `years`,\nand `limit` / `offset` / `cursor` are rejected. `meta` accordingly\ncarries no pagination block.","operationId":"get_financials_v1_companies__code__financials_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"title":"Code"}},{"name":"years","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"description":"Number of fiscal years","default":5,"title":"Years"},"description":"Number of fiscal years"},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated field names","title":"Fields"},"description":"Comma-separated field names"},{"name":"doc_type","in":"query","required":false,"schema":{"type":"string","description":"Filing type: 120 (annual), 130 (amended annual), 140 (quarterly)","default":"120","title":"Doc Type"},"description":"Filing type: 120 (annual), 130 (amended annual), 140 (quarterly)"},{"name":"doc_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":30},{"type":"null"}],"description":"Exact EDINET document ID, including older filings","title":"Doc Id"},"description":"Exact EDINET document ID, including older filings"},{"name":"include","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated extras to include. Supports: 'explanations' (null field reasons), 'sources' (XBRL provenance).","title":"Include"},"description":"Comma-separated extras to include. Supports: 'explanations' (null field reasons), 'sources' (XBRL provenance)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_FinancialOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/ratios":{"get":{"tags":["companies"],"summary":"Get Ratios","description":"Computed financial ratios for a company over time.\n\nThese are derived numbers, not filed ones. `meta.data_as_of` reports the\nfreshness of the EDINET ingest they were computed from.","operationId":"get_ratios_v1_companies__code__ratios_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"title":"Code"}},{"name":"years","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":5,"title":"Years"}},{"name":"split_adjusted","in":"query","required":false,"schema":{"type":"boolean","description":"Adjust per-share values (EPS, BPS, DPS) for detected stock splits so the time-series is comparable. Set to false for raw unadjusted values.","default":true,"title":"Split Adjusted"},"description":"Adjust per-share values (EPS, BPS, DPS) for detected stock splits so the time-series is comparable. Set to false for raw unadjusted values."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_RatioOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/growth":{"get":{"tags":["companies"],"summary":"Get Growth","description":"Year-over-year growth rates and multi-year CAGRs.\n\nThese are derived numbers, not filed ones. `meta.data_as_of` reports the\nfreshness of the EDINET ingest they were computed from.","operationId":"get_growth_v1_companies__code__growth_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"title":"Code"}},{"name":"years","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":2,"default":5,"title":"Years"}},{"name":"split_adjusted","in":"query","required":false,"schema":{"type":"boolean","description":"Adjust EPS for detected stock splits before computing growth. Set to false for raw unadjusted values.","default":true,"title":"Split Adjusted"},"description":"Adjust EPS for detected stock splits before computing growth. Set to false for raw unadjusted values."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_GrowthOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/health":{"get":{"tags":["companies"],"summary":"Get Health","description":"Get the health/credit score (0-100) for a company.\n\nReturns a transparent score with component breakdown, flags,\nand industry adjustment.","operationId":"get_health_v1_companies__code__health_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"title":"Code"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_HealthScoreOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/identifiers":{"get":{"tags":["companies"],"summary":"Get Identifiers","description":"Cross-reference identifiers (securities code, ISIN, LEI, JPX code) for a company.\n\nAnswers 200 with nulls plus a `provenance` object rather than 404 when a\ncompany carries no market identifiers. An unlisted filer has no ISIN, and\nthat is a fact about the company, not a gap in coverage: `provenance` says\nwhich of the two a null is. 404 is reserved for a company we do not know.","operationId":"get_identifiers_v1_companies__code__identifiers_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"title":"Code"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_IdentifiersOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/{doc_id}/fund-registration":{"get":{"tags":["filings"],"summary":"Get Fund Registration","description":"Read a fund registration and its official-source amendment relationship.\n\nedinet_code and issuer_name identify the filing issuer or manager. fund_name\nretains the filed fund identity; foreign covers may supply no G-code. Offering\ncaps remain filed text. Each original\nand amendment remains readable by its own document ID.","operationId":"get_fund_registration_v1_filings__doc_id__fund_registration_get","parameters":[{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","maxLength":30,"title":"Doc Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_FundRegistration_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/{doc_id}/internal-control":{"get":{"tags":["filings"],"summary":"Get Internal Control","description":"Read this document's internal-control conclusion and filed source facts.\n\nHistorical documents remain readable by ID. An amendment identifies the source\ndocument it corrects in amends_doc_id. Unknown conclusions carry a parse warning;\nabsence of a parsed report returns NOT_FOUND.","operationId":"get_internal_control_v1_filings__doc_id__internal_control_get","parameters":[{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","maxLength":30,"title":"Doc Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_InternalControlReport_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings":{"get":{"tags":["filings"],"summary":"List Filings","description":"List EDINET filings, filtered by period end / company / doc_type.\n\nEach row carries `doc_id`, `doc_type` (e.g. 120 annual,\n130 amended annual, 160 semi-annual, 140 quarterly, 220 buyback,\n350/360 large-shareholding, 180 voting-results), filing date,\nfiscal year + period, accounting standard, and the issuer. Use\nthis as the master index when you want to enumerate filings\nindependent of company; pair `since=` with `meta.sync_token`\nfor incremental ingest.\n\n`date_from` / `date_to` and the sort order use `period_end`, the\nfiscal period date of the filing (the fiscal year end for annual\nand semi-annual reports), not the filing date. For recent filings,\nuse `since` (receipt time) and check each row's `filed_at`.","operationId":"list_filings_v1_filings_get","parameters":[{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Filter: period_end on or after this date (YYYY-MM-DD, inclusive). period_end is the fiscal period date of the filing (the fiscal year end for annual and semi-annual reports), not the filing date. For recent filings use `since` (receipt time) and check each row's `filed_at`.","title":"Date From"},"description":"Filter: period_end on or after this date (YYYY-MM-DD, inclusive). period_end is the fiscal period date of the filing (the fiscal year end for annual and semi-annual reports), not the filing date. For recent filings use `since` (receipt time) and check each row's `filed_at`."},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Filter: period_end on or before this date (YYYY-MM-DD, inclusive). period_end is the fiscal period date of the filing (the fiscal year end for annual and semi-annual reports), not the filing date. For recent filings use `since` (receipt time) and check each row's `filed_at`.","title":"Date To"},"description":"Filter: period_end on or before this date (YYYY-MM-DD, inclusive). period_end is the fiscal period date of the filing (the fiscal year end for annual and semi-annual reports), not the filing date. For recent filings use `since` (receipt time) and check each row's `filed_at`."},{"name":"company_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"description":"EDINET or securities code","title":"Company Code"},"description":"EDINET or securities code"},{"name":"doc_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":10},{"type":"null"}],"description":"Document type code","title":"Doc Type"},"description":"Document type code"},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Return filings received after this timestamp (ISO 8601). Use the sync_token from a previous response.","title":"Since"},"description":"Return filings received after this timestamp (ISO 8601). Use the sync_token from a previous response."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":50,"title":"Limit"},"description":"Results per page"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Results to skip (ignored when cursor is set)","default":0,"title":"Offset"},"description":"Results to skip (ignored when cursor is set)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor for keyset pagination","title":"Cursor"},"description":"Opaque cursor for keyset pagination"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_FilingOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/calendar":{"get":{"tags":["filings"],"summary":"Filing Calendar","description":"Filing calendar: companies with period_end in the given month.\n\nUseful for knowing which companies' annual reports are expected.\nReturns companies grouped by their fiscal year end date.","operationId":"filing_calendar_v1_filings_calendar_get","parameters":[{"name":"month","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}$","description":"Month in YYYY-MM format (e.g. 2025-06)","title":"Month"},"description":"Month in YYYY-MM format (e.g. 2025-06)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_CalendarEntry_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/{doc_id}":{"get":{"tags":["filings"],"summary":"Get Filing","description":"One filing by EDINET `doc_id`.\n\nReturns the filing's full envelope: issuer, doc_type, fiscal\nperiod, filing date, accounting standard, and consolidated flag.\nThe `doc_id` is the canonical identifier across all our row-level\nreferences: every shareholding, financial, or signal row that\ncites this filing carries the same value.","operationId":"get_filing_v1_filings__doc_id__get","parameters":[{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","maxLength":30,"title":"Doc Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_FilingOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/{doc_id}/translations":{"get":{"tags":["translations"],"summary":"Get Filing Translations","description":"All English-translated narrative sections of one filing.\n\nReturns one row per section (e.g. business description, risk\nfactors, MD&A, holding purpose). Each row carries the section\nname, English text, original character count, the engine that\nproduced the translation, and when it was translated. Pass\n`section=...` to scope to one part of the filing.","operationId":"get_filing_translations_v1_filings__doc_id__translations_get","parameters":[{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","maxLength":30,"title":"Doc Id"}},{"name":"section","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"description":"Filter by section name","title":"Section"},"description":"Filter by section name"},{"name":"as_of","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Freeze the response to a specific point in time. Pass a value previously returned in `meta.as_of` to replay the exact same translations.","title":"As Of"},"description":"Freeze the response to a specific point in time. Pass a value previously returned in `meta.as_of` to replay the exact same translations."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_TranslationOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/translations/search":{"get":{"tags":["translations"],"summary":"Search Translations","description":"Find filings whose translated text matches a query.\n\nSearches every English-translated section across all filings,\nranks by relevance, and returns each\nhit with a highlighted snippet, the source `doc_id`, section\nname, and fiscal year. Filter scope by `section` (e.g. only\nrisk-factor mentions) or `fiscal_year` when needed.\n\nUse it to find narrative disclosures across the universe: e.g.\n\"which issuers mentioned a specific supplier or covenant?\"","operationId":"search_translations_v1_translations_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":200,"description":"Search query","title":"Q"},"description":"Search query"},{"name":"section","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"description":"Filter by section","title":"Section"},"description":"Filter by section"},{"name":"fiscal_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":1900},{"type":"null"}],"description":"Filter by fiscal year","title":"Fiscal Year"},"description":"Filter by fiscal year"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_TranslationSearchResult_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/screen":{"get":{"tags":["screening"],"summary":"Screen Companies","description":"Screen listed companies on financial metrics. ROE, ROA, revenue,\nmargins, P/E.\n\nReturns one row per company matching every filter, with the\ncompany's latest annual filing's financials and computed metrics\n(`metrics.roe`, `metrics.roa`, `metrics.operating_margin`,\n`metrics.net_margin`, `metrics.equity_ratio`, `metrics.pe_ratio`).\n\nSort via `sort=<field>_<asc|desc>` (e.g. `roe_desc`). Pass\n`fiscal_year=` to screen against a specific year instead of\nthe latest filing. By default uses a pre-computed wide table for\ninstant response on the latest year.","operationId":"screen_companies_v1_screen_get","parameters":[{"name":"roe_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Roe Min"}},{"name":"roe_max","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Roe Max"}},{"name":"roa_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Roa Min"}},{"name":"roa_max","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Roa Max"}},{"name":"revenue_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Revenue Min"}},{"name":"revenue_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Revenue Max"}},{"name":"net_income_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Net Income Min"}},{"name":"net_income_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Net Income Max"}},{"name":"operating_income_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Operating Income Min"}},{"name":"operating_income_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Operating Income Max"}},{"name":"sector","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Sector"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","maxLength":50,"default":"revenue_desc","title":"Sort"}},{"name":"fiscal_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":1900},{"type":"null"}],"title":"Fiscal Year"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_ScreenResultOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rankings/{metric}":{"get":{"tags":["rankings"],"summary":"Get Ranking","description":"Rank companies by a financial metric.\n\nReturns top N companies sorted by the chosen metric, with the\nmetric value and basic company info.","operationId":"get_ranking_v1_rankings__metric__get","parameters":[{"name":"metric","in":"path","required":true,"schema":{"type":"string","maxLength":30,"title":"Metric"}},{"name":"sector","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by sector","title":"Sector"},"description":"Filter by sector"},{"name":"fiscal_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Fiscal Year"}},{"name":"order","in":"query","required":false,"schema":{"type":"string","pattern":"^(asc|desc)$","default":"desc","title":"Order"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_RankingResultOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sectors":{"get":{"tags":["sectors"],"summary":"List Sectors","description":"List all sectors with company counts.","operationId":"list_sectors_v1_sectors_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_SectorListItem_"}}}}}}},"/v1/sectors/{sector_name}":{"get":{"tags":["sectors"],"summary":"Get Sector Stats","description":"Aggregate financial statistics for a sector.\n\nReturns median, average, min, max for key metrics across all\ncompanies in the sector.","operationId":"get_sector_stats_v1_sectors__sector_name__get","parameters":[{"name":"sector_name","in":"path","required":true,"schema":{"type":"string","title":"Sector Name"}},{"name":"fiscal_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Fiscal Year"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_SectorStatsOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/compare":{"get":{"tags":["comparison"],"summary":"Compare Companies","description":"Side-by-side financial comparison of multiple companies.\n\nReturns financials and computed ratios for each company,\naligned by fiscal year for easy comparison.","operationId":"compare_companies_v1_compare_get","parameters":[{"name":"codes","in":"query","required":true,"schema":{"type":"string","maxLength":200,"description":"Comma-separated EDINET or securities codes (max 10)","title":"Codes"},"description":"Comma-separated EDINET or securities codes (max 10)"},{"name":"years","in":"query","required":false,"schema":{"type":"integer","maximum":10,"minimum":1,"description":"Number of fiscal years to include","default":1,"title":"Years"},"description":"Number of fiscal years to include"},{"name":"fiscal_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Fiscal Year"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_CompareResultOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/peers":{"get":{"tags":["comparison"],"summary":"Get Peers","description":"Find peer companies (same sector, similar revenue size).\n\nReturns companies in the same sector, ordered by closest\nrevenue to the target company.","operationId":"get_peers_v1_companies__code__peers_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"title":"Code"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_PeerOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/timeseries":{"get":{"tags":["comparison"],"summary":"Get Timeseries","description":"Time-series data for a single metric across one or more companies.\n\nReturns data in a chart-friendly format: one array per company,\neach element being {fiscal_year, value}.","operationId":"get_timeseries_v1_timeseries_get","parameters":[{"name":"codes","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated EDINET or securities codes (max 5)","title":"Codes"},"description":"Comma-separated EDINET or securities codes (max 5)"},{"name":"metric","in":"query","required":false,"schema":{"type":"string","description":"Financial metric to chart","default":"revenue","title":"Metric"},"description":"Financial metric to chart"},{"name":"years","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":2,"default":10,"title":"Years"}},{"name":"split_adjusted","in":"query","required":false,"schema":{"type":"boolean","description":"Adjust per-share metrics (eps, bps, dividends_per_share) for detected stock splits. Set to false for raw values.","default":true,"title":"Split Adjusted"},"description":"Adjust per-share metrics (eps, bps, dividends_per_share) for detected stock splits. Set to false for raw values."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_TimeseriesResultOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bulk/financials.csv":{"get":{"tags":["bulk"],"summary":"Export Financials Csv","description":"Export financial data as CSV.\n\nReturns companies' financial data in a flat CSV format suitable\nfor analysis in pandas, Excel, or any data tool.\nAt least one filter (sector or fiscal_year) is required.","operationId":"export_financials_csv_v1_bulk_financials_csv_get","parameters":[{"name":"sector","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"description":"Filter by sector","title":"Sector"},"description":"Filter by sector"},{"name":"fiscal_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":1900},{"type":"null"}],"description":"Filter by fiscal year","title":"Fiscal Year"},"description":"Filter by fiscal year"},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"description":"Comma-separated fields (default: all)","title":"Fields"},"description":"Comma-separated fields (default: all)"}],"responses":{"200":{"description":"Successful Response","content":{"text/csv":{}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bulk/financials.json":{"get":{"tags":["bulk"],"summary":"Export Financials Json","description":"Export financial data as JSON array.\n\nReturns companies' financial data as a JSON array, one object\nper company-year. At least one filter (sector or fiscal_year) is required.","operationId":"export_financials_json_v1_bulk_financials_json_get","parameters":[{"name":"sector","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"description":"Filter by sector","title":"Sector"},"description":"Filter by sector"},{"name":"fiscal_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":1900},{"type":"null"}],"description":"Filter by fiscal year","title":"Fiscal Year"},"description":"Filter by fiscal year"},{"name":"fields","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"description":"Comma-separated fields (default: all)","title":"Fields"},"description":"Comma-separated fields (default: all)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_BulkFinancialOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/bulk/ownership_trajectories.parquet":{"get":{"tags":["bulk"],"summary":"Export Ownership Trajectories Parquet","description":"Export all ownership trajectories as Parquet.\n\nReturns the full ownership trajectory dataset in Apache Parquet format,\nreadable by pandas, polars, DuckDB, and other data tools.","operationId":"export_ownership_trajectories_parquet_v1_bulk_ownership_trajectories_parquet_get","responses":{"200":{"description":"Successful Response","content":{"application/octet-stream":{}}}}}},"/v1/bulk/ownership_signals.parquet":{"get":{"tags":["bulk"],"summary":"Export Ownership Signals Parquet","description":"Export all ownership signals as Parquet.\n\nReturns the full ownership signals dataset in Apache Parquet format.","operationId":"export_ownership_signals_parquet_v1_bulk_ownership_signals_parquet_get","responses":{"200":{"description":"Successful Response","content":{"application/octet-stream":{}}}}}},"/v1/batch/financials":{"post":{"tags":["bulk"],"summary":"Batch Financials","description":"Fetch financials for multiple companies in one request.\n\nAccepts a mix of EDINET codes and securities codes. Returns up to\n`years` fiscal years per company, most recent first.","operationId":"batch_financials_v1_batch_financials_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchFinancialsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_FinancialOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/waitlist":{"post":{"tags":["waitlist"],"summary":"Join Waitlist","operationId":"join_waitlist_v1_waitlist_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitlistRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_WaitlistJoinOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks":{"get":{"tags":["webhooks"],"summary":"List Webhooks","operationId":"list_webhooks_v1_webhooks_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_WebhookOut_"}}}}}},"post":{"tags":["webhooks"],"summary":"Create Webhook","operationId":"create_webhook_v1_webhooks_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWebhookRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_WebhookCreateOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks/{webhook_id}":{"delete":{"tags":["webhooks"],"summary":"Delete Webhook","operationId":"delete_webhook_v1_webhooks__webhook_id__delete","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"integer","title":"Webhook Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_DeletedOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/usage":{"get":{"tags":["usage"],"summary":"Get Usage","operationId":"get_usage_v1_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_UsageOut_"}}}}}}},"/v1/keys":{"get":{"tags":["keys"],"summary":"List Keys","description":"List all API keys for the authenticated user.","operationId":"list_keys_v1_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListKeysResponse"}}}}}},"post":{"tags":["keys"],"summary":"Create Key","description":"Create a new API key for the authenticated user.","operationId":"create_key_v1_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateKeyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/keys/{key_id}":{"delete":{"tags":["keys"],"summary":"Delete Key","description":"Revoke an API key.","operationId":"delete_key_v1_keys__key_id__delete","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"integer","title":"Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_DeletedOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/sections":{"get":{"tags":["sections"],"summary":"Get Company Sections","description":"Get text sections from a company's annual filing.\n\nReturns the full Japanese text of each section, with English\ntranslations where available. No truncation.","operationId":"get_company_sections_v1_companies__code__sections_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"title":"Code"}},{"name":"fiscal_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":2000},{"type":"null"}],"description":"Fiscal year. Defaults to latest.","title":"Fiscal Year"},"description":"Fiscal year. Defaults to latest."},{"name":"section","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by section key. One of: mda, risk_factors, business_overview, strategy, sustainability, research_and_development, dividend_policy, governance, company_history, employees, critical_contracts, capital_expenditures, accounting_policy, segment_info, financial_instruments, officers, outside_directors, remuneration.","title":"Section"},"description":"Filter by section key. One of: mda, risk_factors, business_overview, strategy, sustainability, research_and_development, dividend_policy, governance, company_history, employees, critical_contracts, capital_expenditures, accounting_policy, segment_info, financial_instruments, officers, outside_directors, remuneration."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_SectionOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/{doc_id}/sections":{"get":{"tags":["sections"],"summary":"Get Filing Sections","description":"Get text sections from a specific filing.\n\nReturns the full Japanese text of each section, with English\ntranslations where available. No truncation.","operationId":"get_filing_sections_v1_filings__doc_id__sections_get","parameters":[{"name":"doc_id","in":"path","required":true,"schema":{"type":"string","maxLength":30,"title":"Doc Id"}},{"name":"section","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by section key. One of: mda, risk_factors, business_overview, strategy, sustainability, research_and_development, dividend_policy, governance, company_history, employees, critical_contracts, capital_expenditures, accounting_policy, segment_info, financial_instruments, officers, outside_directors, remuneration.","title":"Section"},"description":"Filter by section key. One of: mda, risk_factors, business_overview, strategy, sustainability, research_and_development, dividend_policy, governance, company_history, employees, critical_contracts, capital_expenditures, accounting_policy, segment_info, financial_instruments, officers, outside_directors, remuneration."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_SectionOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/sections/available":{"get":{"tags":["sections"],"summary":"List Available Sections","description":"List all section keys with their labels.","operationId":"list_available_sections_v1_sections_available_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_dict_str__Any__"}}}}}}},"/v1/coverage":{"get":{"tags":["coverage"],"summary":"Get Coverage","description":"How much of the universe is covered, broken down by metric.\n\nFor each financial field, returns the percentage of companies\nwith a non-null value at the latest filing year. Use this to:\n\n  - Pick which metrics to filter or screen on (high-coverage\n    fields give bigger samples).\n  - Spot fields that look attractive but only ~30% populated\n    (e.g. capex, segment revenue) before building dashboards.\n  - Track parser improvements over time as coverage rises.\n\nRead alongside `/freshness` to know how recent the data is and\n`/ontology/fields/{name}.null_reasons` to know why specific\nfields are null for some filers.","operationId":"get_coverage_v1_coverage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_CoverageOut_"}}}}}}},"/v1/companies/{code}/buybacks":{"get":{"tags":["buybacks"],"summary":"List Company Buybacks","description":"Get share buyback reports for a company.\n\nReturns monthly buyback status filings from EDINET (doc type 220),\nordered newest first. Each record shows authorized limits, shares\nacquired in the month, cumulative progress, and treasury share holdings.","operationId":"list_company_buybacks_v1_companies__code__buybacks_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"description":"EDINET code (e.g. 'E02497') or securities code (e.g. '8001')","title":"Code"},"description":"EDINET code (e.g. 'E02497') or securities code (e.g. '8001')"},{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Filter: reporting period ends on or after this date (YYYY-MM-DD)","title":"Date From"},"description":"Filter: reporting period ends on or after this date (YYYY-MM-DD)"},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Filter: reporting period ends on or before this date (YYYY-MM-DD)","title":"Date To"},"description":"Filter: reporting period ends on or before this date (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":50,"title":"Limit"},"description":"Results per page"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Results to skip (ignored when cursor is set)","default":0,"title":"Offset"},"description":"Results to skip (ignored when cursor is set)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor for keyset pagination","title":"Cursor"},"description":"Opaque cursor for keyset pagination"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_BuybackOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/buybacks/latest":{"get":{"tags":["buybacks"],"summary":"List Latest Buybacks","description":"Get the latest buyback reports across all companies.\n\nReturns the most recent share buyback status filings, ordered newest\nfirst. Use this to monitor buyback activity across the market or within\na specific sector.","operationId":"list_latest_buybacks_v1_buybacks_latest_get","parameters":[{"name":"sector","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by sector (e.g. '情報・通信業')","title":"Sector"},"description":"Filter by sector (e.g. '情報・通信業')"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":50,"title":"Limit"},"description":"Results per page"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Results to skip (ignored when cursor is set)","default":0,"title":"Offset"},"description":"Results to skip (ignored when cursor is set)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor for keyset pagination","title":"Cursor"},"description":"Opaque cursor for keyset pagination"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_BuybackOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/buybacks/analysis":{"get":{"tags":["buybacks"],"summary":"Get Buyback Analysis Endpoint","description":"Get buyback execution analysis for a company.\n\nReturns per-program completion rates and execution pace metrics. A company\nthat has run no buyback answers 200 with `total_programs: 0`, the same fact\n`/companies/{code}/buybacks` reports as an empty list; 404 means the code\nnames no company we know.","operationId":"get_buyback_analysis_endpoint_v1_companies__code__buybacks_analysis_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"description":"EDINET code or securities code","title":"Code"},"description":"EDINET code or securities code"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_BuybackAnalysisOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/buybacks/accelerations":{"get":{"tags":["buybacks"],"summary":"List Buyback Accelerations","description":"Get market-wide buyback acceleration events.\n\nReturns companies whose buyback execution pace jumped significantly\n(>=10pp completion between consecutive monthly reports). Completion is\nrecomputed from cumulative vs authorized shares, and only rows that pass\nthe same validity gate as /buybacks/analysis are considered, so an\nacceleration reflects real execution rather than a parse artifact.","operationId":"list_buyback_accelerations_v1_buybacks_accelerations_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Max results","default":20,"title":"Limit"},"description":"Max results"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_BuybackAccelerationOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/shareholdings":{"get":{"tags":["shareholdings"],"summary":"List Company Shareholdings","description":"Get large shareholding reports filed about this company (as issuer).\n\nReturns reports from investors who hold ≥5% of the company's shares.\nShows combined totals by default (holder_index=0 rows).","operationId":"list_company_shareholdings_v1_companies__code__shareholdings_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"description":"Securities code (e.g. '7203') or EDINET code (e.g. 'E02144') of the issuer (target company)","title":"Code"},"description":"Securities code (e.g. '7203') or EDINET code (e.g. 'E02144') of the issuer (target company)"},{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Filter: base date on or after (YYYY-MM-DD)","title":"Date From"},"description":"Filter: base date on or after (YYYY-MM-DD)"},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Filter: base date on or before (YYYY-MM-DD)","title":"Date To"},"description":"Filter: base date on or before (YYYY-MM-DD)"},{"name":"report_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by report type: 'initial', 'amendment', or 'correction'","title":"Report Type"},"description":"Filter by report type: 'initial', 'amendment', or 'correction'"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":50,"title":"Limit"},"description":"Results per page"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Results to skip (ignored when cursor is set)","default":0,"title":"Offset"},"description":"Results to skip (ignored when cursor is set)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor for keyset pagination","title":"Cursor"},"description":"Opaque cursor for keyset pagination"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_ShareholdingOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/shareholdings/latest":{"get":{"tags":["shareholdings"],"summary":"List Latest Shareholdings","description":"Get the latest large shareholding reports across all companies.\n\nReturns per-holder rows ordered by base date (newest first).","operationId":"list_latest_shareholdings_v1_shareholdings_latest_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":50,"title":"Limit"},"description":"Results per page"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Results to skip (ignored when cursor is set)","default":0,"title":"Offset"},"description":"Results to skip (ignored when cursor is set)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor for keyset pagination","title":"Cursor"},"description":"Opaque cursor for keyset pagination"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_ShareholdingOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/shareholdings/{shareholding_id}/audit":{"get":{"tags":["shareholdings"],"summary":"Get Shareholding Audit","description":"Full audit bundle for a single shareholding row.\n\nReturns the row's classification with the full provenance chain:\nreal-time view (knowable at filing time), retrospective view\n(revealed by later evidence on the same filer × issuer pair),\nconfidence, the source filing reference,\nand a stable version label for how the row was read, which consumers\ncan pin to.\n\nTo freeze a response: capture `meta.as_of` from one call, then\npass it back as `?as_of=<token>` on later calls: you'll get the\nsame answer regardless of how the data has evolved. Two calls\nthat share the same `as_of` are guaranteed bit-identical.","operationId":"get_shareholding_audit_v1_shareholdings__shareholding_id__audit_get","parameters":[{"name":"shareholding_id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"description":"Row id from /companies/{code}/shareholdings.","title":"Shareholding Id"},"description":"Row id from /companies/{code}/shareholdings."},{"name":"as_of","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":36},{"type":"null"}],"description":"Freeze the response to a specific point in time. Pass a value previously returned in `meta.as_of` to replay the exact same answer. Omit for the live view.","title":"As Of"},"description":"Freeze the response to a specific point in time. Pass a value previously returned in `meta.as_of` to replay the exact same answer. Omit for the live view."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_ShareholdingAuditOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/ownership/trajectories":{"get":{"tags":["ownership"],"summary":"List Company Trajectories","description":"Get all filer trajectories for an issuer.\n\nReturns ownership trajectory data for each filer that holds >=5% of the company.","operationId":"list_company_trajectories_v1_companies__code__ownership_trajectories_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"description":"Securities code (e.g. '7203') or EDINET code (e.g. 'E02144')","title":"Code"},"description":"Securities code (e.g. '7203') or EDINET code (e.g. 'E02144')"},{"name":"trajectory_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter: accumulating, exiting, stable, new_position","title":"Trajectory Type"},"description":"Filter: accumulating, exiting, stable, new_position"},{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Filter: last_base_date on or after","title":"Date From"},"description":"Filter: last_base_date on or after"},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Filter: last_base_date on or before","title":"Date To"},"description":"Filter: last_base_date on or before"},{"name":"as_of","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Freeze the response to a specific point in time. Pass a value previously returned in `meta.as_of` to replay the exact same answer. Omit for the live view.","title":"As Of"},"description":"Freeze the response to a specific point in time. Pass a value previously returned in `meta.as_of` to replay the exact same answer. Omit for the live view."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":50,"title":"Limit"},"description":"Results per page"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Results to skip (ignored when cursor is set)","default":0,"title":"Offset"},"description":"Results to skip (ignored when cursor is set)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor for keyset pagination","title":"Cursor"},"description":"Opaque cursor for keyset pagination"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_TrajectoryOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/ownership/trajectories/{filer_code}":{"get":{"tags":["ownership"],"summary":"Get Filer Trajectory","description":"Get a single filer's trajectory for an issuer, with full point history.","operationId":"get_filer_trajectory_v1_companies__code__ownership_trajectories__filer_code__get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"description":"Securities or EDINET code of the issuer","title":"Code"},"description":"Securities or EDINET code of the issuer"},{"name":"filer_code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"description":"Canonical filer code (from `filer_canonical_code` on the list endpoint)","title":"Filer Code"},"description":"Canonical filer code (from `filer_canonical_code` on the list endpoint)"},{"name":"as_of","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Freeze the response to a specific point in time. Pass a value previously returned in `meta.as_of` to replay the exact same answer.","title":"As Of"},"description":"Freeze the response to a specific point in time. Pass a value previously returned in `meta.as_of` to replay the exact same answer."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_TrajectoryOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/ownership/chart":{"get":{"tags":["ownership"],"summary":"Get Ownership Chart","description":"Chart-ready ownership timeline for a company.\n\nReturns one series per filer with all points sorted by date.\nMerges trajectory data (entity-grouped) with raw shareholding filings\nfor filers not covered by trajectories. Max 15 series.","operationId":"get_ownership_chart_v1_companies__code__ownership_chart_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"description":"Securities code (e.g. '7203') or EDINET code (e.g. 'E02144')","title":"Code"},"description":"Securities code (e.g. '7203') or EDINET code (e.g. 'E02144')"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_OwnershipChartSeriesOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ownership/movers":{"get":{"tags":["ownership"],"summary":"List Ownership Movers","description":"Largest ownership moves market-wide in the last N days.\n\nReturns filers whose stake in any issuer grew or shrank fastest\nover the lookback window: ranked by velocity (percentage-points\nper month). Filter by direction via `trajectory_type`. Use this\nas your daily \"what changed\" feed before drilling into specific\nissuers or filers.","operationId":"list_ownership_movers_v1_ownership_movers_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Look back period in days","default":90,"title":"Days"},"description":"Look back period in days"},{"name":"trajectory_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter: 'accumulating' or 'exiting'","title":"Trajectory Type"},"description":"Filter: 'accumulating' or 'exiting'"},{"name":"min_delta_pct","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum absolute delta percentage","title":"Min Delta Pct"},"description":"Minimum absolute delta percentage"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":50,"title":"Limit"},"description":"Results per page"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Results to skip (ignored when cursor is set)","default":0,"title":"Offset"},"description":"Results to skip (ignored when cursor is set)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor for keyset pagination","title":"Cursor"},"description":"Opaque cursor for keyset pagination"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_OwnershipMoverOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ownership/signals":{"get":{"tags":["ownership"],"summary":"List Ownership Signals","description":"Detected ownership signals market-wide.\n\nA signal is a labelled event derived from a filer's trajectory:\naccumulation streaks, large step-ups/downs, activist escalations,\ncoordinated buying, pace acceleration, purpose drift, etc. Each\nrow carries a `tier` (1=actionable, 2=informational, 3=trivial),\n`confidence`, `detected_date`, and the `doc_id` of the triggering\nfiling.\n\nDefault response excludes tier-3 (trivial threshold-crossing\nevents like new_position / exit_below_5pct). Pass\n`include_trivial=true` for the full feed.\n\nTo freeze a response: capture `meta.as_of` from one call, then\npass it back as `?as_of=<token>` on later calls to replay the\nexact same set of rows.","operationId":"list_ownership_signals_v1_ownership_signals_get","parameters":[{"name":"signal_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter: accumulation_streak, large_step_up, large_step_down, exit_below_5pct, activist_escalation, new_position, pace_acceleration, purpose_drift, coordinated_accumulation, systematic_exit","title":"Signal Type"},"description":"Filter: accumulation_streak, large_step_up, large_step_down, exit_below_5pct, activist_escalation, new_position, pace_acceleration, purpose_drift, coordinated_accumulation, systematic_exit"},{"name":"filer_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by filer EDINET code (e.g. 'E03606' for SBI Holdings)","title":"Filer Code"},"description":"Filter by filer EDINET code (e.g. 'E03606' for SBI Holdings)"},{"name":"include_trivial","in":"query","required":false,"schema":{"type":"boolean","description":"Include tier 3 (trivial) signals like new_position and exit_below_5pct. Default returns only tier 1 (actionable) and tier 2 (informational).","default":false,"title":"Include Trivial"},"description":"Include tier 3 (trivial) signals like new_position and exit_below_5pct. Default returns only tier 1 (actionable) and tier 2 (informational)."},{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Filter: detected_date on or after","title":"Date From"},"description":"Filter: detected_date on or after"},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Filter: detected_date on or before","title":"Date To"},"description":"Filter: detected_date on or before"},{"name":"as_of","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Freeze the response to a specific point in time. Pass a value previously returned in `meta.as_of` to replay the exact same answer. Omit for the live view.","title":"As Of"},"description":"Freeze the response to a specific point in time. Pass a value previously returned in `meta.as_of` to replay the exact same answer. Omit for the live view."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":50,"title":"Limit"},"description":"Results per page"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Results to skip (ignored when cursor is set)","default":0,"title":"Offset"},"description":"Results to skip (ignored when cursor is set)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor for keyset pagination","title":"Cursor"},"description":"Opaque cursor for keyset pagination"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_OwnershipSignalOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/ownership/signals":{"get":{"tags":["ownership"],"summary":"List Company Signals","description":"Get ownership signals for a specific company.\n\nBy default excludes trivial signals (tier 3: new_position, exit_below_5pct).\nUse `?as_of=<token>` to freeze the response, copying the token from a\nprevious response's `meta.as_of`.","operationId":"list_company_signals_v1_companies__code__ownership_signals_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"description":"Securities or EDINET code of the issuer","title":"Code"},"description":"Securities or EDINET code of the issuer"},{"name":"signal_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by signal type","title":"Signal Type"},"description":"Filter by signal type"},{"name":"include_trivial","in":"query","required":false,"schema":{"type":"boolean","description":"Include tier 3 (trivial) signals","default":false,"title":"Include Trivial"},"description":"Include tier 3 (trivial) signals"},{"name":"as_of","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Freeze the response to a specific point in time. Pass a value previously returned in `meta.as_of` to replay the exact same answer.","title":"As Of"},"description":"Freeze the response to a specific point in time. Pass a value previously returned in `meta.as_of` to replay the exact same answer."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":50,"title":"Limit"},"description":"Results per page"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Results to skip (ignored when cursor is set)","default":0,"title":"Offset"},"description":"Results to skip (ignored when cursor is set)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor for keyset pagination","title":"Cursor"},"description":"Opaque cursor for keyset pagination"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_OwnershipSignalOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ownership/probability-table":{"get":{"tags":["ownership"],"summary":"Get Probability Table","description":"Probability of a trajectory completing, conditional on its state.\n\nReturns P(filer reaches a higher stake threshold | current stake\nrange, streak length, holding purpose), computed empirically from\nall historical trajectories in our dataset. Use it to answer\n\"given that this filer is at X% with N consecutive increases,\nhow often have similar trajectories pushed past Y%?\"\n\nCapture `meta.as_of` to pin a specific snapshot: replay with\n`?as_of=<token>` returns the identical table later.","operationId":"get_probability_table_v1_ownership_probability_table_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_ProbabilityTableOut_"}}}}}}},"/v1/companies/{code}/ownership/trajectories/{filer_code}/probabilities":{"get":{"tags":["ownership"],"summary":"Get Trajectory Probabilities","description":"Get conditional probabilities for a specific active trajectory.\n\nReturns P(reaching 10%, 20%, 33%) and P(exit within 6 months) based on\nthe filer's current stake, streak, and purpose compared to historical data.\nUses CoxPH survival model when available, falls back to base rates.","operationId":"get_trajectory_probabilities_v1_companies__code__ownership_trajectories__filer_code__probabilities_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"description":"Securities or EDINET code of the issuer","title":"Code"},"description":"Securities or EDINET code of the issuer"},{"name":"filer_code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"description":"EDINET code of the filer","title":"Filer Code"},"description":"EDINET code of the filer"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_TrajectoryProbabilitiesOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ownership/cross-holdings":{"get":{"tags":["ownership"],"summary":"List Cross Holdings","description":"All detected cross-shareholding pairs (持ち合い株 / 政策保有株),\nmarket-wide.\n\nReturns every reciprocal stake between listed Japanese companies,\nincluding the sub-threshold pairs that form most of Japanese\nkeiretsu structure. Sorted by combined holding ratio so the largest\nmutual stakes appear first; pairs with NULL ratios sink to the end.\n\n'relationship_type' distinguishes source + confidence, see\nthe field's description. Use this as the inventory of cross-\nholdings that exist; pair it with `/ownership/unwinding-scoreboard`\nto see which of those are actively declining.","operationId":"list_cross_holdings_v1_ownership_cross_holdings_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":50,"title":"Limit"},"description":"Results per page"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Results to skip (ignored when cursor is set)","default":0,"title":"Offset"},"description":"Results to skip (ignored when cursor is set)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor for keyset pagination","title":"Cursor"},"description":"Opaque cursor for keyset pagination"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_CrossHoldingOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/ownership/network":{"get":{"tags":["ownership"],"summary":"Get Company Network","description":"Cross-shareholding pairs that involve this company.\n\nReturns every reciprocal stake (持ち合い株) where this issuer\nappears as one side, including sub-threshold policy holdings.\n'a_holds_b_pct' / 'b_holds_a_pct' may be NULL depending on\nthe underlying disclosure type: see 'relationship_type'.\n\nUse to map a company's cross-holding network before reading the\nunwinding scoreboard: pairs declining here will appear there\nwith velocity attached.","operationId":"get_company_network_v1_companies__code__ownership_network_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"description":"Securities or EDINET code","title":"Code"},"description":"Securities or EDINET code"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_CrossHoldingOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/capital-allocation":{"get":{"tags":["ownership"],"summary":"Get Company Capital Allocation","description":"How this company has been deploying its capital.\n\nClassifies the issuer into one of four buckets based on the\nratio of buybacks + dividends vs reinvestment (capex + R&D + M&A)\nover recent fiscal years:\n\n  - `returner`: heavily prioritises buybacks and dividends\n  - `reinvestor`: heavily prioritises reinvestment\n  - `mixed`: meaningfully both\n  - `hoarder`: neither; cash builds on balance sheet\n\nIncludes the underlying ratios and the fiscal year the\nclassification was computed on.","operationId":"get_company_capital_allocation_v1_companies__code__capital_allocation_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"description":"Securities or EDINET code","title":"Code"},"description":"Securities or EDINET code"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_CapitalAllocationOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/capital-allocation/ranking":{"get":{"tags":["ownership"],"summary":"List Capital Allocation Ranking","description":"Get capital allocation ranking across companies.\n\nSorted by return ratio (highest returners first by default).","operationId":"list_capital_allocation_ranking_v1_capital_allocation_ranking_get","parameters":[{"name":"classification","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter: Returner, Hoarder, Reinvestor, Mixed","title":"Classification"},"description":"Filter: Returner, Hoarder, Reinvestor, Mixed"},{"name":"sector","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by sector","title":"Sector"},"description":"Filter by sector"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":50,"title":"Limit"},"description":"Results per page"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Results to skip (ignored when cursor is set)","default":0,"title":"Offset"},"description":"Results to skip (ignored when cursor is set)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor for keyset pagination","title":"Cursor"},"description":"Opaque cursor for keyset pagination"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_CapitalAllocationOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ownership/activist-campaigns":{"get":{"tags":["ownership"],"summary":"List Activist Campaigns","description":"Active and recent activist campaigns market-wide.\n\nA campaign here means a filer × issuer pair where the filer's stated\nholding purpose is classified `activist`, where its latest filing\ndescribes only dialogue with management after an earlier filing in the\nsame holding was `activist`, OR where we've detected\n`activist_escalation` signals against them. Each row\nincludes intensity (high/medium/low), escalation count, important-\nproposal count, and the trajectory window. Ranked by most recent\nactivity.","operationId":"list_activist_campaigns_v1_ownership_activist_campaigns_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Max results","default":20,"title":"Limit"},"description":"Max results"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_ActivistCampaignOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ownership/unwinding-scoreboard":{"get":{"tags":["ownership"],"summary":"List Unwinding Scoreboard","description":"Cross-shareholdings actively being unwound.\n\nCross-holdings (持ち合い株) are reciprocal stakes between two\nlisted Japanese companies, historically used to lock in friendly\nshareholders. Regulatory and governance pressure since ~2018 has\npushed many of these pairs to unwind.\n\nThis endpoint returns pairs where at least one side shows a clear\ndeclining trajectory, ranked by fastest decline. Use it to find\nforced sellers and identify potential float expansion ahead of\nsecondary supply hitting the market.","operationId":"list_unwinding_scoreboard_v1_ownership_unwinding_scoreboard_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Max results","default":20,"title":"Limit"},"description":"Max results"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_UnwindingScoreboardOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/board":{"get":{"tags":["ownership"],"summary":"Get Board Composition","description":"Get board composition and officer list for a company.\n\nReturns directors, auditors, and executive officers with outside/independent\nstatus, gender breakdown, and shares held.","operationId":"get_board_composition_v1_companies__code__board_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"title":"Code"}},{"name":"fiscal_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":2000},{"type":"null"}],"description":"Fiscal year. Defaults to latest.","title":"Fiscal Year"},"description":"Fiscal year. Defaults to latest."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_BoardCompositionOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/voting":{"get":{"tags":["voting"],"summary":"List Company Voting","description":"Get AGM voting results for a company.\n\nReturns per-proposal voting data including votes for/against/abstain,\napproval percentages, and outcomes. Director elections include\nper-candidate breakdowns.","operationId":"list_company_voting_v1_companies__code__voting_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"description":"EDINET code (e.g. 'E02144') or securities code (e.g. '7203')","title":"Code"},"description":"EDINET code (e.g. 'E02144') or securities code (e.g. '7203')"},{"name":"fiscal_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Filter by fiscal year","title":"Fiscal Year"},"description":"Filter by fiscal year"},{"name":"min_dissent_pct","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":100,"minimum":0},{"type":"null"}],"description":"Optional minimum dissent threshold (0-100). When set, only proposals where (100 - approval_pct) >= this value are returned: useful for surfacing contested resolutions.","title":"Min Dissent Pct"},"description":"Optional minimum dissent threshold (0-100). When set, only proposals where (100 - approval_pct) >= this value are returned: useful for surfacing contested resolutions."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":50,"title":"Limit"},"description":"Results per page"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Results to skip (ignored when cursor is set)","default":0,"title":"Offset"},"description":"Results to skip (ignored when cursor is set)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor for keyset pagination","title":"Cursor"},"description":"Opaque cursor for keyset pagination"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_VotingResultOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/voting/recent":{"get":{"tags":["voting"],"summary":"List Recent Voting","description":"Get recent AGM voting results across all companies.\n\nReturns the most recent voting data, ordered by AGM date descending.\nUse min_dissent_pct to find proposals with significant opposition.","operationId":"list_recent_voting_v1_voting_recent_get","parameters":[{"name":"min_dissent_pct","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum dissent percentage to filter high-opposition proposals (e.g. 20.0)","title":"Min Dissent Pct"},"description":"Minimum dissent percentage to filter high-opposition proposals (e.g. 20.0)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":50,"title":"Limit"},"description":"Results per page"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Results to skip (ignored when cursor is set)","default":0,"title":"Offset"},"description":"Results to skip (ignored when cursor is set)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor for keyset pagination","title":"Cursor"},"description":"Opaque cursor for keyset pagination"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_VotingResultOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/earnings":{"get":{"tags":["earnings"],"summary":"Get Earnings","description":"Get earnings snapshots from 決算短信 for a company.\n\nReturns actuals, balance sheet, cash flows, and ratios for each period.\nData arrives weeks before EDINET annual reports.","operationId":"get_earnings_v1_companies__code__earnings_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"title":"Code"}},{"name":"years","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"description":"Number of fiscal years","default":5,"title":"Years"},"description":"Number of fiscal years"},{"name":"period_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter: FY, Q1, Q2, Q3","title":"Period Type"},"description":"Filter: FY, Q1, Q2, Q3"},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":100,"minimum":1},{"type":"null"}],"description":"Results per page (default: all)","title":"Limit"},"description":"Results per page (default: all)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Results to skip","default":0,"title":"Offset"},"description":"Results to skip"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_EarningsSnapshotOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/forecasts":{"get":{"tags":["earnings"],"summary":"Get Forecasts","description":"Get management earnings forecasts (業績予想) for a company.\n\nExtracted from 決算短信 XBRL: the forward guidance management provides\nalongside their earnings release. Only returns snapshots that contain\nat least one forecast field.\n\nThe earnings-release lane retains that behavior. The response additionally\nincludes captured forecast-revision announcements using the same JPY fields.\nTarget periods, accounting basis, previous figures and revision reasons are\nadditive fields. PDF-only/held revisions retain source links. Announcements\nremain separate historical records rather than a summed financial series.","operationId":"get_forecasts_v1_companies__code__forecasts_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"title":"Code"}},{"name":"years","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":5,"title":"Years"}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":100,"minimum":1},{"type":"null"}],"description":"Results per page (default: all)","title":"Limit"},"description":"Results per page (default: all)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Results to skip","default":0,"title":"Offset"},"description":"Results to skip"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManagementForecastResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/earnings/surprise":{"get":{"tags":["earnings"],"summary":"Get Earnings Surprise","description":"Compare actual earnings against prior management forecasts.\n\nFor each earnings snapshot, finds the most recent prior snapshot that\ncontained a forecast, then computes the surprise (beat/miss) percentage.","operationId":"get_earnings_surprise_v1_companies__code__earnings_surprise_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"title":"Code"}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":100,"minimum":1},{"type":"null"}],"description":"Results per page (default: all)","title":"Limit"},"description":"Results per page (default: all)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Results to skip","default":0,"title":"Offset"},"description":"Results to skip"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_EarningsSurpriseOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/earnings/latest":{"get":{"tags":["earnings"],"summary":"Get Latest Earnings","description":"Get the most recent earnings releases across all companies.\n\nUseful for screening recent 決算短信 filings.","operationId":"get_latest_earnings_v1_earnings_latest_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"period_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter: FY, Q1, Q2, Q3","title":"Period Type"},"description":"Filter: FY, Q1, Q2, Q3"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_EarningsSnapshotOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/earnings/signals":{"get":{"tags":["earnings"],"summary":"Get Company Earnings Signals","description":"Get earnings signals for a company (beats, misses, revisions, records).","operationId":"get_company_earnings_signals_v1_companies__code__earnings_signals_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"title":"Code"}},{"name":"signal_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter: earnings_beat, earnings_miss, forecast_revision_up, forecast_revision_down, record_revenue, margin_expansion, margin_contraction","title":"Signal Type"},"description":"Filter: earnings_beat, earnings_miss, forecast_revision_up, forecast_revision_down, record_revenue, margin_expansion, margin_contraction"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_EarningsSignalOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/earnings/signals":{"get":{"tags":["earnings"],"summary":"Get All Earnings Signals","description":"Get latest earnings signals across all companies.","operationId":"get_all_earnings_signals_v1_earnings_signals_get","parameters":[{"name":"signal_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signal Type"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_EarningsSignalOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/forecast-revisions":{"get":{"tags":["earnings"],"summary":"Get Forecast Revisions","description":"Get previous and revised management guidance from official revision notices.\n\nMonetary values are integer JPY. EPS is JPY per share. Target periods and\nconsolidated/nonconsolidated guidance remain separate. Null means no reported\nnumeric value; *_unreported_fields identifies explicitly nil or dash facts.\nPagination follows captured source notices. Sources includes PDF-only and\nheld notices; data contains structured guidance for parsed sources on that\npage. This endpoint covers captured notices, not full history.","operationId":"get_forecast_revisions_v1_companies__code__forecast_revisions_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"title":"Code"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForecastRevisionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/investors/search":{"get":{"tags":["investors"],"summary":"Search Investors","description":"Search investors by name or EDINET code.\n\nSearches across ownership trajectories and large shareholding filings.\nMatches Japanese filer names, English names in parentheses, and company names.","operationId":"search_investors_v1_investors_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"description":"Search by investor name or EDINET code","title":"Q"},"description":"Search by investor name or EDINET code"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_InvestorSearchResult_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/investors/{code}/positions":{"get":{"tags":["investors"],"summary":"Get Investor Positions","description":"Get all positions for an investor across all companies.\n\nReturns companies where this investor has filed large shareholding reports,\nwith trajectory data (direction, velocity, holding %).","operationId":"get_investor_positions_v1_investors__code__positions_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","title":"Code"}},{"name":"trajectory_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter: accumulating, exiting, stable, new_position","title":"Trajectory Type"},"description":"Filter: accumulating, exiting, stable, new_position"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_InvestorPositionsData_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/watchlist":{"get":{"tags":["watchlist"],"summary":"List Watchlist","description":"List all watchlist items for the authenticated user.","operationId":"list_watchlist_v1_watchlist_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_WatchlistItemOut_"}}}}}},"post":{"tags":["watchlist"],"summary":"Add To Watchlist","description":"Add a company or investor to the user's watchlist.","operationId":"add_to_watchlist_v1_watchlist_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WatchlistItemIn"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_WatchlistItemOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/watchlist/{item_id}":{"delete":{"tags":["watchlist"],"summary":"Remove From Watchlist","description":"Remove an item from the user's watchlist.","operationId":"remove_from_watchlist_v1_watchlist__item_id__delete","parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"integer","title":"Item Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_WatchlistDeleteOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/relationships":{"get":{"tags":["relationships"],"summary":"Get Company Relationships","description":"Get unified relationship graph for a company.\n\nReturns board members, major shareholders, holdings by this entity,\nboard interlocks (directors serving on multiple boards), and cross-holdings.","operationId":"get_company_relationships_v1_companies__code__relationships_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"description":"EDINET code (e.g. 'E02144') or securities code (e.g. '7203')","title":"Code"},"description":"EDINET code (e.g. 'E02144') or securities code (e.g. '7203')"},{"name":"fiscal_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":2000},{"type":"null"}],"description":"Fiscal year for board data. Defaults to latest.","title":"Fiscal Year"},"description":"Fiscal year for board data. Defaults to latest."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_CompanyRelationshipsOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/relationships/interlocks":{"get":{"tags":["relationships"],"summary":"List Company Interlocks","description":"Get board interlocks for a company.\n\nReturns directors who serve on this company's board AND at least one other\ncompany's board in the same fiscal year.","operationId":"list_company_interlocks_v1_companies__code__relationships_interlocks_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"description":"EDINET code (e.g. 'E02144') or securities code (e.g. '7203')","title":"Code"},"description":"EDINET code (e.g. 'E02144') or securities code (e.g. '7203')"},{"name":"fiscal_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":2000},{"type":"null"}],"description":"Fiscal year. Defaults to latest.","title":"Fiscal Year"},"description":"Fiscal year. Defaults to latest."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_BoardInterlockOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/companies/{code}/subsidiaries":{"get":{"tags":["relationships"],"summary":"Get Company Subsidiaries","description":"Subsidiary registry from a parent's annual 関係会社 disclosure.\n\nEach row carries the disclosure verbatim plus derived attributes:\n  - country (ISO 3166-1 alpha-2 from the address)\n  - currency (ISO 4217 alpha-3 from the capital cell)\n  - relationship_type (consolidated_subsidiary / equity_method_affiliate /\n    parent / other_related)\n  - cross_validation: bidirectional confirmation status when the\n    subsidiary itself files its own annual. Filter by\n    cross_validation='bidirectional_confirmed' for the highest-\n    provenance edges; voting_pct_mismatch surfaces filing-lag and\n    in-flight-restructuring signals.\n  - holdings_filing_count + joint_filing_partner_count: cross-source\n    evidence the entity is a real legal entity actively operating.\n\nBuilt from the v3 entity-resolution output (entity_resolution_v3\nparses 関係会社 disclosures with full provenance back to source XBRL\ntables and rows).","operationId":"get_company_subsidiaries_v1_companies__code__subsidiaries_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"description":"EDINET code (e.g. 'E03752') or securities code (e.g. '8604')","title":"Code"},"description":"EDINET code (e.g. 'E03752') or securities code (e.g. '8604')"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Maximum subsidiaries to return.","default":200,"title":"Limit"},"description":"Maximum subsidiaries to return."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SingleResponse_CompanySubsidiariesOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/relationships/interlocks":{"get":{"tags":["relationships"],"summary":"List Market Interlocks","description":"Get market-wide board interlocks.\n\nReturns all directors who serve on multiple company boards in a given\nfiscal year, paginated. Directors with high confidence (DOB match) are\nlisted first.","operationId":"list_market_interlocks_v1_relationships_interlocks_get","parameters":[{"name":"fiscal_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":2000},{"type":"null"}],"description":"Fiscal year. Defaults to latest available.","title":"Fiscal Year"},"description":"Fiscal year. Defaults to latest available."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Results per page","default":50,"title":"Limit"},"description":"Results per page"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Results to skip (ignored when cursor is set)","default":0,"title":"Offset"},"description":"Results to skip (ignored when cursor is set)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor for keyset pagination","title":"Cursor"},"description":"Opaque cursor for keyset pagination"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_BoardInterlockOut_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ontology/version":{"get":{"tags":["ontology"],"summary":"Ontology Version","description":"The current ontology version (semver).\n\nBumped whenever field labels, unit handling, or validation rules\nchange in a way that could affect interpretation.","operationId":"ontology_version_v1_ontology_version_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/ontology/fields":{"get":{"tags":["ontology"],"summary":"List Fields","description":"List every field the API can return, with XBRL-element mappings,\nstandard coverage, null reasons, and comparability caveats.\n\nFilter by `category` to scope to one section of the financial\nstatements (e.g. only income-statement fields).","operationId":"list_fields_v1_ontology_fields_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by category: income_statement, balance_sheet, cash_flow, per_share, ratio, dei, other","title":"Category"},"description":"Filter by category: income_statement, balance_sheet, cash_flow, per_share, ratio, dei, other"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ontology/fields/{field_name}":{"get":{"tags":["ontology"],"summary":"Get Field","description":"Full definition for a single field by its API name.\n\nUseful when you receive an unfamiliar field in a response and\nwant to know what it represents, how it maps across accounting\nstandards, and whether nulls are expected for some filers.","operationId":"get_field_v1_ontology_fields__field_name__get","parameters":[{"name":"field_name","in":"path","required":true,"schema":{"type":"string","title":"Field Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/.well-known/oauth-protected-resource":{"get":{"summary":"Protected Resource Metadata","description":"RFC 9728 Protected Resource Metadata.","operationId":"protected_resource_metadata__well_known_oauth_protected_resource_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/oauth-authorization-server":{"get":{"summary":"Authorization Server Metadata","description":"RFC 8414 Authorization Server Metadata.","operationId":"authorization_server_metadata__well_known_oauth_authorization_server_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/oauth/authorize":{"get":{"summary":"Authorize Get","description":"Show the authorization form.","operationId":"authorize_get_oauth_authorize_get","parameters":[{"name":"client_id","in":"query","required":true,"schema":{"type":"string","title":"Client Id"}},{"name":"redirect_uri","in":"query","required":true,"schema":{"type":"string","title":"Redirect Uri"}},{"name":"code_challenge","in":"query","required":true,"schema":{"type":"string","title":"Code Challenge"}},{"name":"code_challenge_method","in":"query","required":false,"schema":{"type":"string","default":"S256","title":"Code Challenge Method"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","default":"","title":"State"}},{"name":"response_type","in":"query","required":false,"schema":{"type":"string","default":"code","title":"Response Type"}},{"name":"scope","in":"query","required":false,"schema":{"type":"string","default":"","title":"Scope"}},{"name":"resource","in":"query","required":false,"schema":{"type":"string","default":"","title":"Resource"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"summary":"Authorize Post","description":"Validate API key and issue authorization code.","operationId":"authorize_post_oauth_authorize_post","requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_authorize_post_oauth_authorize_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/oauth/token":{"post":{"summary":"Token Exchange","description":"Exchange authorization code for access token (the API key).","operationId":"token_exchange_oauth_token_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/.well-known/mcp/server-card.json":{"get":{"summary":"Mcp Server Card","operationId":"mcp_server_card__well_known_mcp_server_card_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"ActivistActorMemberOut":{"properties":{"key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key","description":"The holder's key (accepted by every route that takes a filer code)"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"The holder's name as filed"},"relation":{"type":"string","const":"filed_together","title":"Relation","description":"How the holder belongs to the actor: it is named in the same large shareholding report (共同保有者)","default":"filed_together"},"latest_ratio_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latest Ratio Pct","description":"The holder's own ratio in its latest report (%)"},"first_seen":{"type":"string","format":"date","title":"First Seen","description":"Base date of the first report naming it"},"last_seen":{"type":"string","format":"date","title":"Last Seen","description":"Base date of the latest report naming it"}},"type":"object","required":["first_seen","last_seen"],"title":"ActivistActorMemberOut"},"ActivistActorOut":{"properties":{"key":{"type":"string","title":"Key","description":"Key of the actor's lead holder at this issuer. Per issuer: the same firm can lead with a different holder elsewhere"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Name of the actor (its first named holder)"},"stake_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Stake Pct","description":"The actor's stake as filed (%). Null when its members have not yet filed one combined figure"},"stake_basis":{"type":"string","enum":["filed_combined","lower_bound","not_yet_combined"],"title":"Stake Basis","description":"filed_combined: the report's own combined figure; lower_bound: a joint report without one, the members' sum; not_yet_combined: members filed separately, no combined figure yet"},"status":{"type":"string","enum":["above_threshold_reported","exit_reported","no_recent_disclosure","continuity_unknown","threshold_ambiguous","undetermined"],"title":"Status","description":"What the disclosures show, never whether the actor is active: above_threshold_reported, exit_reported (a report at 5% or less), no_recent_disclosure (no recent filing), continuity_unknown (no filing for a long period: whether the holding continued is not known), threshold_ambiguous (a report at exactly 5.00%), undetermined (the latest report cannot show the stake above 5%)"},"observed_start":{"type":"string","format":"date","title":"Observed Start","description":"Base date of the actor's first report here"},"last_disclosure_date":{"type":"string","format":"date","title":"Last Disclosure Date","description":"Base date of its latest report"},"members":{"items":{"$ref":"#/components/schemas/ActivistActorMemberOut"},"type":"array","title":"Members","description":"Holders acting as one at this issuer, with how each belongs"},"also_present":{"items":{"$ref":"#/components/schemas/ActivistCoPresentOut"},"type":"array","title":"Also Present","description":"Other actors with a campaign at the same issuer in the same period. Listed side by side, never combined: no filing states they act together"}},"type":"object","required":["key","stake_basis","status","observed_start","last_disclosure_date","members"],"title":"ActivistActorOut"},"ActivistCampaignOut":{"properties":{"filer_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filer Code","description":"Activist filer EDINET code. Null when the filer is a group of entities with no single EDINET code of its own; use filer_name."},"filer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filer Name","description":"Activist filer name"},"filer_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filer Name En","description":"Activist filer name (English) when available"},"issuer_security_code":{"type":"string","title":"Issuer Security Code","description":"Target company securities code"},"issuer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issuer Name","description":"Target company name"},"issuer_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issuer Name En","description":"Target company name (English) when available"},"holding_ratio_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Holding Ratio Pct","description":"Current holding ratio (%)"},"trajectory_type":{"type":"string","title":"Trajectory Type","description":"accumulating, stable, exiting, etc."},"streak_length":{"type":"integer","title":"Streak Length","description":"Consecutive filings in current direction"},"velocity_pp_per_month":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Velocity Pp Per Month","description":"Acquisition pace (pp/month)"},"first_filing_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Filing Date","description":"First filing date (ISO)"},"last_filing_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Filing Date","description":"Last filing date (ISO)"},"filing_count":{"type":"integer","title":"Filing Count","description":"Total filings"},"escalation_signals":{"type":"integer","title":"Escalation Signals","description":"Number of activist escalation signals","default":0},"important_proposals":{"type":"integer","title":"Important Proposals","description":"Number of important proposal filings","default":0},"purpose_change_filings":{"type":"integer","title":"Purpose Change Filings","description":"Number of change reports filed because the activist's stated holding purpose changed","default":0},"campaign_intensity":{"type":"string","title":"Campaign Intensity","description":"Deprecated: a coarse band (high, medium, low), not a measured quantity. Its value is unchanged; it will be removed in the next contract version. Read escalation_signals, important_proposals and purpose_change_filings instead","default":"low","deprecated":true},"actor":{"anyOf":[{"$ref":"#/components/schemas/ActivistActorOut"},{"type":"null"}],"description":"Who acts behind this holder at this issuer, as of the latest read snapshot. Null when it is not known yet (for example a report filed after the snapshot)"}},"type":"object","required":["issuer_security_code","trajectory_type","streak_length","filing_count"],"title":"ActivistCampaignOut"},"ActivistCoPresentOut":{"properties":{"key":{"type":"string","title":"Key","description":"Lead holder key of the other actor"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Name of the other actor"},"stake_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Stake Pct","description":"Its stake as filed (%)"},"status":{"type":"string","enum":["above_threshold_reported","exit_reported","no_recent_disclosure","continuity_unknown","threshold_ambiguous","undetermined"],"title":"Status","description":"Its disclosure status"}},"type":"object","required":["key","status"],"title":"ActivistCoPresentOut"},"AllowanceOut":{"properties":{"granted":{"type":"integer","title":"Granted"},"remaining":{"type":"integer","title":"Remaining"},"open_days":{"type":"integer","title":"Open Days"},"running_low_at":{"type":"integer","title":"Running Low At"},"closing_soon_days":{"type":"integer","title":"Closing Soon Days"},"sample_codes":{"items":{"type":"string"},"type":"array","title":"Sample Codes"},"opens":{"items":{"$ref":"#/components/schemas/OpenCompanyOut"},"type":"array","title":"Opens"}},"type":"object","required":["granted","remaining","open_days","running_low_at","closing_soon_days","sample_codes","opens"],"title":"AllowanceOut","description":"Per-account company access, when offered; null otherwise."},"BatchFinancialsRequest":{"properties":{"codes":{"items":{"type":"string"},"type":"array","maxItems":100,"minItems":1,"title":"Codes","description":"List of EDINET or securities codes (1–100)."},"years":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Years","description":"Number of fiscal years per company.","default":5},"fields":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Fields","description":"Financial fields to include. Null returns all fields."}},"type":"object","required":["codes"],"title":"BatchFinancialsRequest"},"BatchIdentifiersRequest":{"properties":{"ids":{"items":{"type":"string","maxLength":64,"minLength":1},"type":"array","maxItems":100,"minItems":1,"title":"Ids","description":"Identifiers to resolve (1-100). Any mix of EDINET codes, securities codes and investor identifiers."}},"type":"object","required":["ids"],"title":"BatchIdentifiersRequest"},"BoardCompositionOut":{"properties":{"edinet_code":{"type":"string","title":"Edinet Code","description":"EDINET code"},"securities_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Securities Code","description":"Securities code"},"fiscal_year":{"type":"integer","title":"Fiscal Year","description":"Fiscal year"},"total_directors":{"type":"integer","title":"Total Directors","description":"Number of directors"},"total_auditors":{"type":"integer","title":"Total Auditors","description":"Number of auditors"},"total_executive_officers":{"type":"integer","title":"Total Executive Officers","description":"Number of executive officers"},"male_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Male Count","description":"Male count"},"female_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Female Count","description":"Female count"},"female_ratio_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Female Ratio Pct","description":"Female ratio (%)"},"outside_director_count":{"type":"integer","title":"Outside Director Count","description":"Outside directors + auditors"},"independent_director_ratio_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Independent Director Ratio Pct","description":"Independent director ratio (%)"},"officers":{"items":{"$ref":"#/components/schemas/BoardMemberOut"},"type":"array","title":"Officers","description":"Individual officers"}},"type":"object","required":["edinet_code","fiscal_year","total_directors","total_auditors","total_executive_officers","outside_director_count"],"title":"BoardCompositionOut"},"BoardInterlockCompanyOut":{"properties":{"edinet_code":{"type":"string","title":"Edinet Code","description":"EDINET code of the other company"},"securities_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Securities Code","description":"Securities code"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Company name"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"Director's title at this company"}},"type":"object","required":["edinet_code"],"title":"BoardInterlockCompanyOut"},"BoardInterlockOut":{"properties":{"name":{"type":"string","title":"Name","description":"Director name"},"date_of_birth":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date Of Birth","description":"Date of birth (Japanese format)"},"confidence":{"type":"string","title":"Confidence","description":"'high' (DOB matches) or 'low' (DOB null on either side)"},"companies":{"items":{"$ref":"#/components/schemas/BoardInterlockCompanyOut"},"type":"array","title":"Companies","description":"Other companies where this director serves"}},"type":"object","required":["name","confidence"],"title":"BoardInterlockOut"},"BoardMemberOut":{"properties":{"name":{"type":"string","title":"Name","description":"Officer name"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title","description":"Official title/position"},"date_of_birth":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date Of Birth","description":"Date of birth (Japanese format)"},"shares_held_thousands":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Shares Held Thousands","description":"Shares held (thousands)"},"role_type":{"type":"string","title":"Role Type","description":"board or exec"},"is_outside":{"type":"boolean","title":"Is Outside","description":"Outside/independent director"}},"type":"object","required":["name","role_type","is_outside"],"title":"BoardMemberOut"},"Body_authorize_post_oauth_authorize_post":{"properties":{"client_id":{"type":"string","title":"Client Id"},"redirect_uri":{"type":"string","title":"Redirect Uri"},"code_challenge":{"type":"string","title":"Code Challenge"},"code_challenge_method":{"type":"string","title":"Code Challenge Method","default":"S256"},"state":{"type":"string","title":"State","default":""},"api_key":{"type":"string","title":"Api Key"},"csrf_token":{"type":"string","title":"Csrf Token"}},"type":"object","required":["client_id","redirect_uri","code_challenge","api_key","csrf_token"],"title":"Body_authorize_post_oauth_authorize_post"},"BulkFinancialOut":{"properties":{"edinet_code":{"type":"string","title":"Edinet Code","description":"EDINET submitter code."},"securities_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Securities Code","description":"TSE securities code."},"name_jp":{"type":"string","title":"Name Jp","description":"Company name in Japanese."},"name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En","description":"Company name in English."},"sector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sector","description":"TSE 33-sector classification in Japanese."},"fiscal_year":{"type":"integer","title":"Fiscal Year","description":"Fiscal year."},"period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period End","description":"Last day of the fiscal period (ISO 8601)."},"accounting_standard":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accounting Standard","description":"Accounting standard: 'Japan GAAP', 'IFRS', or 'US GAAP'."}},"additionalProperties":true,"type":"object","required":["edinet_code","name_jp","fiscal_year"],"title":"BulkFinancialOut"},"BuybackAccelerationOut":{"properties":{"edinet_code":{"type":"string","title":"Edinet Code","description":"EDINET code"},"doc_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Id","description":"EDINET doc_id of the current-period buyback report this row compares against the prior period. Use /filings/{doc_id} to fetch the source filing."},"securities_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Securities Code","description":"Securities code (4-digit)"},"name_jp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name Jp","description":"Company name (Japanese)"},"name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En","description":"Company name (English)"},"sector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sector","description":"Sector"},"reporting_period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reporting Period End","description":"Reporting period end (ISO date)"},"resolution_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolution Type","description":"Resolution type"},"authorized_shares":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Authorized Shares","description":"Authorized shares"},"prev_completion_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Prev Completion Pct","description":"Previous period completion %"},"current_completion_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Current Completion Pct","description":"Current period completion %"},"acceleration_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Acceleration Pct","description":"Increase in completion % (pp)"}},"type":"object","required":["edinet_code"],"title":"BuybackAccelerationOut"},"BuybackAnalysisOut":{"properties":{"edinet_code":{"type":"string","title":"Edinet Code","description":"EDINET code"},"total_programs":{"type":"integer","title":"Total Programs","description":"Number of buyback programs"},"programs":{"items":{"$ref":"#/components/schemas/BuybackProgramOut"},"type":"array","title":"Programs","description":"Per-program analysis"}},"type":"object","required":["edinet_code","total_programs","programs"],"title":"BuybackAnalysisOut"},"BuybackOut":{"properties":{"edinet_code":{"type":"string","title":"Edinet Code","description":"EDINET code of the company"},"doc_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Id","description":"EDINET doc_id of the buyback report (doc_type 220) this row was extracted from. Use /filings/{doc_id} to fetch the source filing."},"reporting_period_start":{"type":"string","format":"date","title":"Reporting Period Start","description":"Start date of the reporting period"},"reporting_period_end":{"type":"string","format":"date","title":"Reporting Period End","description":"End date of the reporting period"},"resolution_type":{"type":"string","title":"Resolution Type","description":"Resolution type: 'shareholder_meeting' or 'board_of_directors'"},"authorized_shares":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Authorized Shares","description":"Maximum shares authorized for buyback under this resolution"},"authorized_amount":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Authorized Amount","description":"Maximum amount authorized for buyback in JPY"},"shares_acquired_month":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Shares Acquired Month","description":"Number of shares acquired during this reporting month"},"amount_acquired_month":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Amount Acquired Month","description":"Total amount spent on share acquisitions this month in JPY"},"cumulative_shares":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cumulative Shares","description":"Total shares acquired since the buyback resolution date"},"cumulative_amount":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cumulative Amount","description":"Total amount spent since the buyback resolution date in JPY"},"treasury_shares_held":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Treasury Shares Held","description":"Treasury shares held by the company at end of the reporting period"},"shares_issued":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Shares Issued","description":"Total shares issued (including treasury shares)"},"share_class":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Share Class","description":"Class of shares (e.g. '普通株式' for common stock)"},"progress_shares_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Progress Shares Pct","description":"Buyback completion rate by shares: cumulative / authorized * 100"},"progress_amount_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Progress Amount Pct","description":"Buyback completion rate by amount: cumulative / authorized * 100"}},"type":"object","required":["edinet_code","reporting_period_start","reporting_period_end","resolution_type"],"title":"BuybackOut"},"BuybackProgramOut":{"properties":{"resolution_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolution Type","description":"Resolution type"},"authorized_shares":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Authorized Shares","description":"Authorized shares to buy back"},"authorized_amount":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Authorized Amount","description":"Authorized amount (JPY)"},"cumulative_shares":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cumulative Shares","description":"Shares bought so far"},"cumulative_amount":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cumulative Amount","description":"Amount spent so far (JPY)"},"completion_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Completion Pct","description":"Completion percentage (0-100)"},"first_period":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Period","description":"First reporting period (ISO date)"},"last_period":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Period","description":"Last reporting period (ISO date)"},"report_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Report Count","description":"Number of monthly reports filed"},"months_active":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Months Active","description":"Duration in months"},"pace_pct_per_month":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pace Pct Per Month","description":"Completion % per month"}},"type":"object","title":"BuybackProgramOut"},"CagrOut":{"properties":{"3yr":{"anyOf":[{"$ref":"#/components/schemas/GrowthMetrics"},{"type":"null"}],"description":"3-year compound annual growth rates."},"5yr":{"anyOf":[{"$ref":"#/components/schemas/GrowthMetrics"},{"type":"null"}],"description":"5-year compound annual growth rates."}},"type":"object","title":"CagrOut"},"CalendarEntry":{"properties":{"date":{"type":"string","title":"Date","description":"Date in ISO 8601 format (YYYY-MM-DD)."},"filing_count":{"type":"integer","title":"Filing Count","description":"Number of filings received on this date."}},"type":"object","required":["date","filing_count"],"title":"CalendarEntry"},"CapitalAllocationOut":{"properties":{"edinet_code":{"type":"string","title":"Edinet Code","description":"EDINET code"},"securities_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Securities Code","description":"Securities code"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Company name"},"sector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sector","description":"Sector"},"fiscal_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Fiscal Year","description":"Fiscal year analyzed"},"classification":{"type":"string","title":"Classification","description":"Returner, Hoarder, Reinvestor, Mixed, or Insufficient Data"},"fcf":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Fcf","description":"Free cash flow (JPY)"},"total_returns":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Returns","description":"Dividends + buybacks (JPY)"},"return_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Return Ratio","description":"Total returns / FCF"},"capex_revenue_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Capex Revenue Ratio","description":"Capex / Revenue ratio"}},"type":"object","required":["edinet_code","classification"],"title":"CapitalAllocationOut"},"CompanyExpandedOut":{"properties":{"edinet_code":{"type":"string","title":"Edinet Code","description":"EDINET submitter code assigned by FSA (e.g. 'E02144'). Primary identifier."},"securities_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Securities Code","description":"TSE securities code, 4 digits (e.g. '7203')."},"name_jp":{"type":"string","title":"Name Jp","description":"Company name in Japanese (e.g. 'トヨタ自動車株式会社')."},"name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En","description":"Company name in English. Null if not provided in filings."},"name_en_quality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Quality","description":"Audit tag for `name_en`. One of: 'verified' (from an authoritative external registry), 'derived' (deterministic extraction or high-confidence public-registry match), 'machine' (model-generated, lowest confidence). Null when no English name has been resolved yet."},"name_en_resolved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Name En Resolved At","description":"Timestamp `name_en` was last resolved. Use to detect staleness."},"sector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sector","description":"TSE 33-sector classification in Japanese (e.g. '輸送用機器')."},"sector_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sector En","description":"TSE 33-sector in English. Auto-translated."},"fiscal_year_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fiscal Year End","description":"Fiscal year-end month as 2-digit string (e.g. '03' for March)."},"listing":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Listing","description":"TSE market segment in Japanese (e.g. 'プライム（内国株式）')."},"listing_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Listing En","description":"TSE market segment in English (e.g. 'Prime'). Auto-translated from listing."},"sector_display":{"type":"string","title":"Sector Display","description":"Always-populated display label derived from sector + listing. TSE's 33-sector classification only applies to listed equities; unlisted filers (REITs, asset managers, foreign subs) carry no sector. This field surfaces that gap explicitly: 'Unlisted' when listing is null, 'Uncategorised' when listed but unclassified, otherwise the English sector name. Consumers needing the raw TSE classification should still read `sector` / `sector_en`.","default":""},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type","description":"Entity classification: 'listed_company', 'fund', or 'unlisted_filer'."},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When this company record was first created in Axiora."},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"When this company record was last updated."},"former_names":{"items":{"$ref":"#/components/schemas/CompanyFormerNameOut"},"type":"array","title":"Former Names","description":"Legal names this company held before its current one, most recent first. Holdings, filings and partner records dated before a rename carry these names. Empty when no former name is recorded."},"financials":{"anyOf":[{"items":{"$ref":"#/components/schemas/FinancialOut"},"type":"array"},{"type":"null"}],"title":"Financials","description":"Financial data for this company (when expand=financials)."},"ratios":{"anyOf":[{"items":{"$ref":"#/components/schemas/RatioOut"},"type":"array"},{"type":"null"}],"title":"Ratios","description":"Computed ratios (when expand=ratios)."},"growth":{"anyOf":[{"$ref":"#/components/schemas/GrowthOut"},{"type":"null"}],"description":"Growth rates and CAGRs (when expand=growth)."},"peers":{"anyOf":[{"items":{"$ref":"#/components/schemas/PeerOut"},"type":"array"},{"type":"null"}],"title":"Peers","description":"Peer companies (when expand=peers)."},"segments":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Segments","description":"Business segment data (when expand=segments)."},"translations":{"anyOf":[{"items":{"$ref":"#/components/schemas/TranslationOut"},"type":"array"},{"type":"null"}],"title":"Translations","description":"English translations (when expand=translations)."},"health_score":{"anyOf":[{"$ref":"#/components/schemas/HealthScoreOut"},{"type":"null"}],"description":"Financial health score (when expand=health_score)."}},"type":"object","required":["edinet_code","name_jp","created_at","updated_at"],"title":"CompanyExpandedOut","description":"Company with optional expanded sub-resources."},"CompanyFormerNameOut":{"properties":{"name_jp":{"type":"string","title":"Name Jp","description":"Former name in Japanese."},"name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En","description":"Former name in English, if known."}},"type":"object","required":["name_jp"],"title":"CompanyFormerNameOut","description":"A legal name the company held before its current one."},"CompanyOut":{"properties":{"edinet_code":{"type":"string","title":"Edinet Code","description":"EDINET submitter code assigned by FSA (e.g. 'E02144'). Primary identifier."},"securities_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Securities Code","description":"TSE securities code, 4 digits (e.g. '7203')."},"name_jp":{"type":"string","title":"Name Jp","description":"Company name in Japanese (e.g. 'トヨタ自動車株式会社')."},"name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En","description":"Company name in English. Null if not provided in filings."},"name_en_quality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Quality","description":"Audit tag for `name_en`. One of: 'verified' (from an authoritative external registry), 'derived' (deterministic extraction or high-confidence public-registry match), 'machine' (model-generated, lowest confidence). Null when no English name has been resolved yet."},"name_en_resolved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Name En Resolved At","description":"Timestamp `name_en` was last resolved. Use to detect staleness."},"sector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sector","description":"TSE 33-sector classification in Japanese (e.g. '輸送用機器')."},"sector_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sector En","description":"TSE 33-sector in English. Auto-translated."},"fiscal_year_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fiscal Year End","description":"Fiscal year-end month as 2-digit string (e.g. '03' for March)."},"listing":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Listing","description":"TSE market segment in Japanese (e.g. 'プライム（内国株式）')."},"listing_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Listing En","description":"TSE market segment in English (e.g. 'Prime'). Auto-translated from listing."},"sector_display":{"type":"string","title":"Sector Display","description":"Always-populated display label derived from sector + listing. TSE's 33-sector classification only applies to listed equities; unlisted filers (REITs, asset managers, foreign subs) carry no sector. This field surfaces that gap explicitly: 'Unlisted' when listing is null, 'Uncategorised' when listed but unclassified, otherwise the English sector name. Consumers needing the raw TSE classification should still read `sector` / `sector_en`.","default":""},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type","description":"Entity classification: 'listed_company', 'fund', or 'unlisted_filer'."},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When this company record was first created in Axiora."},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"When this company record was last updated."}},"type":"object","required":["edinet_code","name_jp","created_at","updated_at"],"title":"CompanyOut"},"CompanyRelationshipsOut":{"properties":{"company":{"additionalProperties":true,"type":"object","title":"Company","description":"Company identifiers"},"board_members":{"items":{"$ref":"#/components/schemas/BoardMemberOut"},"type":"array","title":"Board Members"},"major_shareholders":{"items":{"$ref":"#/components/schemas/RelationshipShareholderOut"},"type":"array","title":"Major Shareholders"},"holdings":{"items":{"$ref":"#/components/schemas/RelationshipHoldingOut"},"type":"array","title":"Holdings"},"board_interlocks":{"items":{"$ref":"#/components/schemas/BoardInterlockOut"},"type":"array","title":"Board Interlocks"},"cross_holdings":{"items":{"$ref":"#/components/schemas/CrossHoldingOut"},"type":"array","title":"Cross Holdings"},"register_shareholders":{"anyOf":[{"$ref":"#/components/schemas/RegisterShareholdersOut"},{"type":"null"}],"description":"Issuer-reported fiscal-year-end register (latest year, top holders including sub-5%). Distinct from major_shareholders, which is derived from event-driven 5% filings."}},"type":"object","required":["company"],"title":"CompanyRelationshipsOut"},"CompanySearchOut":{"properties":{"edinet_code":{"type":"string","title":"Edinet Code","description":"EDINET submitter code assigned by FSA (e.g. 'E02144'). Primary identifier."},"securities_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Securities Code","description":"TSE securities code, 4 digits (e.g. '7203')."},"name_jp":{"type":"string","title":"Name Jp","description":"Company name in Japanese (e.g. 'トヨタ自動車株式会社')."},"name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En","description":"Company name in English. Null if not provided in filings."},"name_en_quality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En Quality","description":"Audit tag for `name_en`. One of: 'verified' (from an authoritative external registry), 'derived' (deterministic extraction or high-confidence public-registry match), 'machine' (model-generated, lowest confidence). Null when no English name has been resolved yet."},"name_en_resolved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Name En Resolved At","description":"Timestamp `name_en` was last resolved. Use to detect staleness."},"sector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sector","description":"TSE 33-sector classification in Japanese (e.g. '輸送用機器')."},"sector_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sector En","description":"TSE 33-sector in English. Auto-translated."},"fiscal_year_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fiscal Year End","description":"Fiscal year-end month as 2-digit string (e.g. '03' for March)."},"listing":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Listing","description":"TSE market segment in Japanese (e.g. 'プライム（内国株式）')."},"listing_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Listing En","description":"TSE market segment in English (e.g. 'Prime'). Auto-translated from listing."},"sector_display":{"type":"string","title":"Sector Display","description":"Always-populated display label derived from sector + listing. TSE's 33-sector classification only applies to listed equities; unlisted filers (REITs, asset managers, foreign subs) carry no sector. This field surfaces that gap explicitly: 'Unlisted' when listing is null, 'Uncategorised' when listed but unclassified, otherwise the English sector name. Consumers needing the raw TSE classification should still read `sector` / `sector_en`.","default":""},"entity_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type","description":"Entity classification: 'listed_company', 'fund', or 'unlisted_filer'."},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When this company record was first created in Axiora."},"updated_at":{"type":"string","format":"date-time","title":"Updated At","description":"When this company record was last updated."},"former_names":{"items":{"$ref":"#/components/schemas/CompanyFormerNameOut"},"type":"array","title":"Former Names","description":"Legal names this company held before its current one, most recent first. Holdings, filings and partner records dated before a rename carry these names. Empty when no former name is recorded."}},"type":"object","required":["edinet_code","name_jp","created_at","updated_at"],"title":"CompanySearchOut","description":"A company search result."},"CompanySubsidiariesOut":{"properties":{"company":{"additionalProperties":true,"type":"object","title":"Company","description":"Company identifiers (edinet_code, name)."},"subsidiary_count":{"type":"integer","title":"Subsidiary Count","description":"Number of subsidiaries returned."},"subsidiaries":{"items":{"$ref":"#/components/schemas/SubsidiaryOut"},"type":"array","title":"Subsidiaries"}},"type":"object","required":["company","subsidiary_count"],"title":"CompanySubsidiariesOut","description":"Subsidiary registry from a parent's annual 関係会社 disclosure."},"CompareFinancials":{"properties":{"revenue":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Revenue","description":"Revenue in JPY."},"gross_profit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Gross Profit","description":"Gross profit in JPY."},"net_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Net Income","description":"Net income in JPY."},"operating_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Operating Income","description":"Operating income in JPY."},"total_assets":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Assets","description":"Total assets in JPY."},"total_equity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Equity","description":"Total equity in JPY."},"current_assets":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Current Assets","description":"Current assets in JPY."},"current_liabilities":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Current Liabilities","description":"Current liabilities in JPY."},"eps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Eps","description":"Earnings per share in JPY."},"bps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Bps","description":"Book value per share in JPY."}},"type":"object","title":"CompareFinancials"},"CompareRatios":{"properties":{"roe":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Roe","description":"Return on equity (%)."},"roa":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Roa","description":"Return on assets (%)."},"operating_margin":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Operating Margin","description":"Operating margin (%)."},"net_margin":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Net Margin","description":"Net margin (%)."},"equity_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Equity Ratio","description":"Equity ratio (%)."}},"type":"object","title":"CompareRatios"},"CompareResultOut":{"properties":{"company":{"$ref":"#/components/schemas/CompanyOut","description":"Company details."},"fiscal_year":{"type":"integer","title":"Fiscal Year","description":"Fiscal year of the comparison data."},"financials":{"$ref":"#/components/schemas/CompareFinancials","description":"Financial data for comparison."},"ratios":{"$ref":"#/components/schemas/CompareRatios","description":"Financial ratios for comparison."}},"type":"object","required":["company","fiscal_year","financials","ratios"],"title":"CompareResultOut"},"CoverageOut":{"properties":{"totals":{"$ref":"#/components/schemas/CoverageTotals","description":"High-level coverage counts."},"fiscal_year_range":{"$ref":"#/components/schemas/FiscalYearRange","description":"Earliest and latest fiscal years available."},"fiscal_year_depth":{"items":{"$ref":"#/components/schemas/FiscalYearDepth"},"type":"array","title":"Fiscal Year Depth","description":"Per-year breakdown of companies and filings."},"latest_filing_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Filing At","description":"Timestamp of the most recent filing (ISO 8601)."},"metric_coverage":{"additionalProperties":{"$ref":"#/components/schemas/MetricCoverage"},"type":"object","title":"Metric Coverage","description":"Coverage percentage for each financial metric."},"accounting_standards":{"additionalProperties":{"type":"integer"},"type":"object","title":"Accounting Standards","description":"Count of filings per accounting standard."},"sector_breakdown":{"items":{"$ref":"#/components/schemas/SectorBreakdown"},"type":"array","title":"Sector Breakdown","description":"Company count by sector."},"exchange_breakdown":{"items":{"$ref":"#/components/schemas/ExchangeBreakdown"},"type":"array","title":"Exchange Breakdown","description":"Company count by TSE market segment."},"filing_types":{"items":{"$ref":"#/components/schemas/FilingTypeBreakdown"},"type":"array","title":"Filing Types","description":"Filing count by document type."},"data_source":{"$ref":"#/components/schemas/DataSourceInfo","description":"Information about the upstream data source."}},"type":"object","required":["totals","fiscal_year_range","fiscal_year_depth","metric_coverage","accounting_standards","sector_breakdown","exchange_breakdown","filing_types","data_source"],"title":"CoverageOut"},"CoverageTotals":{"properties":{"companies":{"type":"integer","title":"Companies","description":"Total companies in the database."},"listed_companies":{"type":"integer","title":"Listed Companies","description":"Companies with a TSE securities code."},"filings":{"type":"integer","title":"Filings","description":"Total parsed filings."},"financial_data_points":{"type":"integer","title":"Financial Data Points","description":"Total non-null financial field values across all filings."},"translated_sections":{"type":"integer","title":"Translated Sections","description":"Total filing sections translated to English."},"financial_metrics":{"type":"integer","title":"Financial Metrics","description":"Number of distinct financial metrics available."}},"type":"object","required":["companies","listed_companies","filings","financial_data_points","translated_sections","financial_metrics"],"title":"CoverageTotals"},"CreateKeyRequest":{"properties":{"label":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Label"},"test":{"type":"boolean","title":"Test","default":false}},"type":"object","title":"CreateKeyRequest"},"CreateKeyResponse":{"properties":{"raw_key":{"type":"string","title":"Raw Key"},"key":{"$ref":"#/components/schemas/KeyResponse"},"allowance_status":{"type":"string","title":"Allowance Status"}},"type":"object","required":["raw_key","key","allowance_status"],"title":"CreateKeyResponse"},"CreateWebhookRequest":{"properties":{"url":{"type":"string","maxLength":2048,"title":"Url"},"events":{"items":{"type":"string"},"type":"array","maxItems":10,"minItems":1,"title":"Events"}},"type":"object","required":["url","events"],"title":"CreateWebhookRequest"},"CrossHoldingOut":{"properties":{"company_a_edinet_code":{"type":"string","title":"Company A Edinet Code","description":"EDINET code of company A"},"company_a_securities_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company A Securities Code","description":"Securities code of company A"},"company_a_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company A Name","description":"Name of company A"},"company_b_edinet_code":{"type":"string","title":"Company B Edinet Code","description":"EDINET code of company B"},"company_b_securities_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company B Securities Code","description":"Securities code of company B"},"company_b_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company B Name","description":"Name of company B"},"a_holds_b_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"A Holds B Pct","description":"A's holding ratio in B (%). May be NULL when the underlying disclosure type doesn't carry a ratio (see relationship_type)."},"b_holds_a_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"B Holds A Pct","description":"B's holding ratio in A (%). Same NULL semantics as a_holds_b_pct."},"min_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Pct","description":"The smaller of the two reciprocal holdings (%). NULL when either side's ratio is NULL."},"sector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sector","description":"Shared or representative sector for the pair (company A's sector when both share it; A's sector otherwise). Null when sector is unknown."},"relationship_type":{"type":"string","title":"Relationship Type","description":"Pair classification. One of: 'mutual_attested' (both sides confirm holding each other), 'single_side_attested' (one side confirms), 'mutual_self_join' (both directions observed without explicit confirmation), 'mutual' (legacy high-threshold pair, only these rows carry holding ratios)."},"cluster_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cluster Id","description":"Cluster grouping ID"}},"type":"object","required":["company_a_edinet_code","company_b_edinet_code","relationship_type"],"title":"CrossHoldingOut"},"DataSourceInfo":{"properties":{"name":{"type":"string","title":"Name","description":"Data source name."},"operator":{"type":"string","title":"Operator","description":"Organization operating the data source."},"url":{"type":"string","title":"Url","description":"URL of the data source."},"description":{"type":"string","title":"Description","description":"Human-readable description of the data source."}},"type":"object","required":["name","operator","url","description"],"title":"DataSourceInfo"},"DeepHealthCheckOut":{"properties":{"status":{"type":"string","title":"Status","description":"Overall service status: 'ok' or 'degraded'."},"checks":{"additionalProperties":{"type":"string"},"type":"object","title":"Checks","description":"Individual subsystem statuses (e.g. {'database': 'ok', 'cache': 'ok'})."}},"type":"object","required":["status","checks"],"title":"DeepHealthCheckOut"},"DeletedOut":{"properties":{"deleted":{"type":"boolean","title":"Deleted","description":"True if the resource was successfully deleted."},"id":{"type":"integer","title":"Id","description":"ID of the deleted resource."}},"type":"object","required":["deleted","id"],"title":"DeletedOut"},"EarningsForecastOut":{"properties":{"securities_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Securities Code"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"company_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name En"},"fiscal_year_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fiscal Year End"},"period_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Type"},"filing_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filing Date"},"accounting_standard":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accounting Standard"},"tdnet_pdf_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"URL of the source 決算短信 PDF on TDNet. Every forecast traces back here.","title":"Tdnet Pdf Url"},"forecast_revenue":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Forecast Revenue"},"forecast_operating_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Forecast Operating Income"},"forecast_ordinary_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Forecast Ordinary Income"},"forecast_net_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Forecast Net Income"},"forecast_eps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Forecast Eps"},"forecast_revenue_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Forecast Revenue Change Pct"},"forecast_operating_income_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Forecast Operating Income Change Pct"},"forecast_net_income_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Forecast Net Income Change Pct"}},"title":"EarningsForecastOut","type":"object"},"EarningsSignalOut":{"properties":{"signal_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signal Type"},"securities_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Securities Code"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"detected_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detected Date"},"tdnet_pdf_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tdnet Pdf Url","description":"URL of the source TDnet document (決算短信 or 業績予想の修正) that triggered this signal."},"fiscal_year_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fiscal Year End"},"period_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Type"},"is_consolidated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Consolidated","description":"True for consolidated figures, false for parent-only."},"metric":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric"},"actual_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Actual Value"},"expected_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Expected Value"},"surprise_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Surprise Pct"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","title":"EarningsSignalOut"},"EarningsSnapshotOut":{"properties":{"securities_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Securities Code"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"company_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name En"},"fiscal_year_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fiscal Year End"},"period_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Type"},"filing_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filing Date"},"accounting_standard":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accounting Standard"},"is_consolidated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Consolidated"},"tdnet_pdf_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tdnet Pdf Url","description":"URL of the source 決算短信 PDF on TDNet. Every number traces back here."},"revenue":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Revenue"},"operating_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Operating Income"},"ordinary_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ordinary Income"},"net_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Net Income"},"comprehensive_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Comprehensive Income"},"revenue_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Revenue Change Pct"},"operating_income_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Operating Income Change Pct"},"net_income_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Net Income Change Pct"},"eps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Eps"},"diluted_eps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Diluted Eps"},"bps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Bps"},"dps_annual":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Dps Annual"},"total_assets":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Assets"},"net_assets":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Net Assets"},"equity_ratio_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Equity Ratio Pct"},"operating_cf":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Operating Cf"},"investing_cf":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Investing Cf"},"financing_cf":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Financing Cf"},"cash_end":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cash End"},"roe_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Roe Pct"},"roa_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Roa Pct"},"operating_margin_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Operating Margin Pct"}},"type":"object","title":"EarningsSnapshotOut"},"EarningsSurpriseDetail":{"properties":{"actual":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Actual"},"forecast":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Forecast"},"surprise_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Surprise Pct"},"beat":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Beat"}},"type":"object","title":"EarningsSurpriseDetail"},"EarningsSurpriseOut":{"properties":{"securities_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Securities Code"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"company_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name En"},"fiscal_year_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fiscal Year End"},"period_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Type"},"filing_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filing Date"},"accounting_standard":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accounting Standard"},"is_consolidated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Consolidated"},"tdnet_pdf_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tdnet Pdf Url","description":"URL of the source 決算短信 PDF on TDNet. Every number traces back here."},"revenue":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Revenue"},"operating_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Operating Income"},"ordinary_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ordinary Income"},"net_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Net Income"},"comprehensive_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Comprehensive Income"},"revenue_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Revenue Change Pct"},"operating_income_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Operating Income Change Pct"},"net_income_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Net Income Change Pct"},"eps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Eps"},"diluted_eps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Diluted Eps"},"bps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Bps"},"dps_annual":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Dps Annual"},"total_assets":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Assets"},"net_assets":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Net Assets"},"equity_ratio_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Equity Ratio Pct"},"operating_cf":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Operating Cf"},"investing_cf":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Investing Cf"},"financing_cf":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Financing Cf"},"cash_end":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cash End"},"roe_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Roe Pct"},"roa_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Roa Pct"},"operating_margin_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Operating Margin Pct"},"surprise":{"additionalProperties":{"$ref":"#/components/schemas/EarningsSurpriseDetail"},"type":"object","title":"Surprise"}},"type":"object","title":"EarningsSurpriseOut"},"Entity":{"properties":{"id":{"type":"string","title":"Id","description":"Entity ID, e.g. 'company:E00883' or 'holder:E06485'."},"type":{"type":"string","title":"Type"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"name_jp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name Jp"},"attributes":{"additionalProperties":true,"type":"object","title":"Attributes"},"ids":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"object","title":"Ids","description":"Every public identifier held for the entity (EDINET code, securities code, 法人番号, LEI, the v1 filer code). Any of them works as input. Null means none is held."},"facts":{"anyOf":[{"additionalProperties":{"items":{"$ref":"#/components/schemas/Fact"},"type":"array"},"type":"object"},{"type":"null"}],"title":"Facts"},"facts_more":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Facts More","description":"For an included fact type capped at 50: the /v2/facts link for the rest."},"status":{"type":"string","enum":["confirmed","held"],"title":"Status","default":"confirmed"},"held_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Held Reason"}},"type":"object","required":["id","type"],"title":"Entity"},"EntityList":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Entity"},"type":"array","title":"Data"},"meta":{"$ref":"#/components/schemas/axiora__api__v2__models__Meta"}},"type":"object","required":["data","meta"],"title":"EntityList"},"EntityOne":{"properties":{"data":{"$ref":"#/components/schemas/Entity"},"meta":{"$ref":"#/components/schemas/axiora__api__v2__models__Meta"}},"type":"object","required":["data","meta"],"title":"EntityOne"},"ExchangeBreakdown":{"properties":{"listing":{"type":"string","title":"Listing","description":"TSE market segment."},"companies":{"type":"integer","title":"Companies","description":"Number of companies in this segment."}},"type":"object","required":["listing","companies"],"title":"ExchangeBreakdown"},"Fact":{"properties":{"id":{"type":"string","title":"Id","description":"Stable fact ID."},"type":{"type":"string","title":"Type"},"subjects":{"items":{"$ref":"#/components/schemas/Subject"},"type":"array","title":"Subjects"},"valid_as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Valid As Of","description":"Date the fact describes."},"known_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Known At","description":"When the market could first know it."},"value":{"additionalProperties":true,"type":"object","title":"Value"},"superseded_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Superseded By"},"source":{"$ref":"#/components/schemas/Source"},"status":{"type":"string","enum":["confirmed","held"],"title":"Status"},"held_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Held Reason"}},"type":"object","required":["id","type","subjects","value","source","status"],"title":"Fact"},"FactList":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Fact"},"type":"array","title":"Data"},"meta":{"$ref":"#/components/schemas/axiora__api__v2__models__Meta"}},"type":"object","required":["data","meta"],"title":"FactList"},"FilingOut":{"properties":{"doc_id":{"type":"string","title":"Doc Id","description":"EDINET document ID (e.g. 'S100ABCD'). Globally unique."},"edinet_code":{"type":"string","title":"Edinet Code","description":"EDINET submitter code of the filing company."},"doc_type":{"type":"string","title":"Doc Type","description":"EDINET doc type code. 120=annual, 130=amended annual, 160=semi-annual, 140=quarterly, 150=amended quarterly."},"doc_type_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Type Label","description":"Japanese label for doc_type (e.g. '有価証券報告書')."},"fiscal_year":{"type":"integer","title":"Fiscal Year","description":"Fiscal year the filing covers."},"period_start":{"type":"string","format":"date","title":"Period Start","description":"First day of the reporting period."},"period_end":{"type":"string","format":"date","title":"Period End","description":"Last day of the reporting period."},"accounting_standard":{"type":"string","title":"Accounting Standard","description":"Accounting standard used: 'Japan GAAP', 'IFRS', or 'US GAAP'."},"filed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Filed At","description":"When the filing was submitted to EDINET. Null if not available."},"received_at":{"type":"string","format":"date-time","title":"Received At","description":"When Axiora ingested this filing from EDINET."},"doc_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Description","description":"Description from EDINET (e.g. '有価証券報告書 第120期')."},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"When this record was created in Axiora."}},"type":"object","required":["doc_id","edinet_code","doc_type","fiscal_year","period_start","period_end","accounting_standard","received_at","created_at"],"title":"FilingOut"},"FilingTypeBreakdown":{"properties":{"doc_type":{"type":"string","title":"Doc Type","description":"EDINET document type code."},"label":{"type":"string","title":"Label","description":"Japanese label (e.g. '有価証券報告書')."},"count":{"type":"integer","title":"Count","description":"Number of filings of this type."}},"type":"object","required":["doc_type","label","count"],"title":"FilingTypeBreakdown"},"FinancialOut":{"properties":{"edinet_code":{"type":"string","title":"Edinet Code","description":"EDINET submitter code (e.g. 'E02144')."},"fiscal_year":{"type":"integer","title":"Fiscal Year","description":"Fiscal year label. '2024' means the fiscal year ending in calendar year 2024."},"period_end":{"type":"string","format":"date","title":"Period End","description":"Last day of the fiscal period (e.g. '2024-03-31')."},"revenue":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Revenue","description":"Revenue (売上高) in JPY. IFRS: Revenue; JP-GAAP: 売上高 or 営業収益."},"net_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Net Income","description":"Net income attributable to owners of the parent in JPY. Null if not reported."},"operating_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Operating Income","description":"Operating income (営業利益) in JPY."},"ordinary_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ordinary Income","description":"Ordinary income (経常利益) in JPY. JP-GAAP only; includes non-operating items."},"total_assets":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Assets","description":"Total assets (総資産) in JPY."},"total_equity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Equity","description":"Total equity including non-controlling interests in JPY."},"net_assets":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Net Assets","description":"Net assets (純資産) in JPY. JP-GAAP concept; includes NCI and stock acquisition rights."},"total_liabilities":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Liabilities","description":"Total liabilities (負債合計) in JPY."},"cash_and_equivalents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cash And Equivalents","description":"Cash and cash equivalents in JPY. BS item, not CF ending balance."},"operating_cf":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Operating Cf","description":"Cash flow from operating activities in JPY."},"investing_cf":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Investing Cf","description":"Investing cash flow in JPY. Typically negative."},"financing_cf":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Financing Cf","description":"Financing cash flow in JPY. Negative = net repayment."},"eps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Eps","description":"Basic EPS in JPY (e.g. 285.23)."},"diluted_eps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Diluted Eps","description":"Diluted EPS in JPY. Adjusts for convertibles/options."},"dividends_per_share":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Dividends Per Share","description":"Annual DPS in JPY (e.g. 75.0). Interim + year-end."},"bps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Bps","description":"Book value per share in JPY."},"roe":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Roe","description":"Return on equity (%). E.g. 12.5 means 12.5%."},"pe_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pe Ratio","description":"Price-to-earnings ratio. Derived from market price ÷ EPS when available."},"num_employees":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Employees","description":"Number of employees (headcount). Unitless integer."},"payout_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Payout Ratio","description":"Payout ratio (fraction, e.g. 0.30). Filer-stated when available; otherwise cash-basis derived from dividends paid ÷ net income (see `derived_fields`)."},"capital_stock":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Capital Stock","description":"Stated capital (資本金) in JPY."},"comprehensive_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Comprehensive Income","description":"Comprehensive income in JPY. Net income + OCI."},"income_before_tax":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Income Before Tax","description":"Income before income taxes (税引前当期純利益) in JPY."},"shares_issued":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Shares Issued","description":"Total shares issued (発行済株式総数). Includes treasury stock."},"shares_outstanding_at_filing":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Shares Outstanding At Filing","description":"Shares outstanding at filing date (提出日現在の発行済株式総数). DEI header."},"interim_dividend":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Interim Dividend","description":"Interim dividend per share in JPY. Subset of dividends_per_share."},"cost_of_sales":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cost Of Sales","description":"Cost of sales (売上原価) in JPY."},"gross_profit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Gross Profit","description":"Gross profit (売上総利益) in JPY. Revenue minus cost of sales."},"sga":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sga","description":"Selling, general and administrative expenses (販管費) in JPY."},"extraordinary_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Extraordinary Income","description":"Extraordinary income (特別利益) in JPY. JP-GAAP only."},"extraordinary_loss":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Extraordinary Loss","description":"Extraordinary loss (特別損失) in JPY. JP-GAAP only."},"depreciation":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Depreciation","description":"Depreciation and amortization in JPY."},"rnd_expenses":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rnd Expenses","description":"R&D expenses (研究開発費) in JPY."},"current_assets":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Current Assets","description":"Current assets (流動資産) in JPY."},"noncurrent_assets":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Noncurrent Assets","description":"Non-current assets (固定資産) in JPY."},"ppe":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ppe","description":"Property, plant and equipment (有形固定資産) in JPY."},"intangible_assets":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Intangible Assets","description":"Intangible assets (無形固定資産) in JPY."},"inventories":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Inventories","description":"Inventories (棚卸資産) in JPY."},"trade_receivables":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Trade Receivables","description":"Trade receivables (売掛金・受取手形) in JPY."},"current_liabilities":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Current Liabilities","description":"Current liabilities (流動負債) in JPY."},"noncurrent_liabilities":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Noncurrent Liabilities","description":"Non-current liabilities (固定負債) in JPY."},"trade_payables":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Trade Payables","description":"Trade payables (買掛金・支払手形) in JPY."},"ibd_current":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ibd Current","description":"Interest-bearing debt, current portion in JPY. Short-term borrowings + current LT debt."},"ibd_noncurrent":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ibd Noncurrent","description":"Interest-bearing debt, non-current in JPY. Long-term borrowings + bonds payable."},"retained_earnings":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Retained Earnings","description":"Retained earnings (利益剰余金) in JPY."},"non_controlling_interests":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Non Controlling Interests","description":"Non-controlling interests (非支配株主持分) in JPY."},"capex":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Capex","description":"Capital expenditure in JPY. From investing CF."},"treasury_stock":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Treasury Stock","description":"Treasury stock (自己株式) in JPY. Reported as negative in equity section."},"goodwill":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Goodwill","description":"Goodwill (のれん) in JPY. IFRS: separate line; JP-GAAP: in intangibles."},"interest_expense":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Interest Expense","description":"Interest expense (支払利息) in JPY."},"investment_securities":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Investment Securities","description":"Investment securities (投資有価証券) in JPY."},"deferred_tax_assets":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Deferred Tax Assets","description":"Deferred tax assets (繰延税金資産) in JPY."},"is_consolidated":{"type":"boolean","title":"Is Consolidated","description":"True for consolidated financials. False for standalone/parent-only filers.","default":true},"accounting_standard":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accounting Standard","description":"Accounting standard: 'JP-GAAP', 'IFRS', or 'US-GAAP'. Null when not resolved from filing metadata."},"currency":{"type":"string","title":"Currency","description":"Currency code. Always 'JPY'. All monetary values are in Japanese yen.","default":"JPY"},"source_doc_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Doc Id","description":"EDINET document ID of the source filing (e.g. 'S100ABCD')."},"data_source":{"type":"string","title":"Data Source","description":"Data provenance.","default":"EDINET (Financial Services Agency of Japan)"},"explanations":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Explanations","description":"Explanations for null financial fields. Keys are field names, values explain why the field is null (e.g. accounting standard differences, data availability). Only present when include=explanations is requested (REST API) or always included in MCP tool responses."},"sources":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Sources","description":"Per-field source citations tracing each value to its EDINET filing. Only present when include=sources is requested. Contains 'edinet_url', 'accounting_standard', and period dates."},"derived_fields":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Derived Fields","description":"Fields in this row computed from the filing's own facts rather than stated by the filer (currently only `payout_ratio`, cash-basis: dividends paid ÷ net income). Null/empty = all reported. See the endpoint's caveats."},"roa":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Roa","description":"Return on assets (%). net_income ÷ total_assets × 100."},"operating_margin":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Operating Margin","description":"Operating margin (%). operating_income ÷ revenue × 100."},"net_margin":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Net Margin","description":"Net margin (%). net_income ÷ revenue × 100."},"gross_margin":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gross Margin","description":"Gross margin (%). gross_profit ÷ revenue × 100."},"equity_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Equity Ratio","description":"Equity ratio (%). total_equity ÷ total_assets × 100."}},"type":"object","required":["edinet_code","fiscal_year","period_end"],"title":"FinancialOut"},"FiscalYearDepth":{"properties":{"fiscal_year":{"type":"integer","title":"Fiscal Year","description":"Fiscal year."},"companies":{"type":"integer","title":"Companies","description":"Number of companies with data for this fiscal year."},"filings":{"type":"integer","title":"Filings","description":"Number of filings for this fiscal year."}},"type":"object","required":["fiscal_year","companies","filings"],"title":"FiscalYearDepth"},"FiscalYearRange":{"properties":{"min":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min","description":"Earliest fiscal year in the dataset."},"max":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max","description":"Latest fiscal year in the dataset."}},"type":"object","title":"FiscalYearRange"},"ForecastRevisionMeta":{"properties":{"request_id":{"type":"string","title":"Request Id"},"computation_version":{"type":"string","title":"Computation Version","default":"2026.10.2"},"ontology_version":{"type":"string","title":"Ontology Version","default":"3.2.0"},"data_as_of":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Data As Of","description":"Latest captured source publication time; null when source_total is zero."},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"caveats":{"items":{"type":"string"},"type":"array","title":"Caveats"},"securities_code":{"type":"string","title":"Securities Code"},"source_total":{"type":"integer","title":"Source Total"},"parsed_count":{"type":"integer","title":"Parsed Count"},"archive_only_count":{"type":"integer","title":"Archive Only Count"},"held_count":{"type":"integer","title":"Held Count"}},"type":"object","required":["request_id","data_as_of","total","limit","offset","caveats","securities_code","source_total","parsed_count","archive_only_count","held_count"],"title":"ForecastRevisionMeta"},"ForecastRevisionNotice":{"properties":{"securities_code":{"type":"string","title":"Securities Code"},"company_name":{"type":"string","title":"Company Name"},"published_at":{"type":"string","format":"date-time","title":"Published At"},"fiscal_year_end":{"type":"string","format":"date","title":"Fiscal Year End"},"title":{"type":"string","title":"Title"},"notice":{"type":"string","title":"Notice"},"reason":{"type":"string","title":"Reason"},"notes":{"type":"string","title":"Notes"},"tdnet_pdf_url":{"type":"string","title":"Tdnet Pdf Url"},"revisions":{"items":{"$ref":"#/components/schemas/GuidanceRevision"},"type":"array","title":"Revisions"}},"additionalProperties":false,"type":"object","required":["securities_code","company_name","published_at","fiscal_year_end","title","notice","reason","notes","tdnet_pdf_url","revisions"],"title":"ForecastRevisionNotice"},"ForecastRevisionResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/ForecastRevisionNotice"},"type":"array","title":"Data"},"sources":{"items":{"$ref":"#/components/schemas/ForecastSourceNotice"},"type":"array","title":"Sources"},"meta":{"$ref":"#/components/schemas/ForecastRevisionMeta"}},"type":"object","required":["data","sources","meta"],"title":"ForecastRevisionResponse"},"ForecastSourceNotice":{"properties":{"published_at":{"type":"string","format":"date-time","title":"Published At"},"title":{"type":"string","title":"Title"},"tdnet_pdf_url":{"type":"string","title":"Tdnet Pdf Url"},"disposition":{"type":"string","enum":["parsed","archive_only","held"],"title":"Disposition"}},"type":"object","required":["published_at","title","tdnet_pdf_url","disposition"],"title":"ForecastSourceNotice"},"FreshnessOut":{"properties":{"last_ingest_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Ingest At","description":"Observed completion timestamp of the most recent EDINET ingest run (ISO 8601). Falls back to start time for legacy rows."},"last_ingest_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Ingest Status","description":"Public status of the most recent ingest ('ok', 'delayed', or 'unknown')."},"filings_today":{"type":"integer","title":"Filings Today","description":"Number of filings ingested today."},"filings_this_week":{"type":"integer","title":"Filings This Week","description":"Number of filings ingested this week."},"lag_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Lag Minutes","description":"Minutes since the most recent ingest result became visible. Null if no ingest has run."},"next_poll_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Poll At","description":"Estimated time of next EDINET poll (ISO 8601)."},"total_companies":{"type":"integer","title":"Total Companies","description":"Total companies in the database."},"total_filings":{"type":"integer","title":"Total Filings","description":"Total filings in the database."}},"type":"object","required":["filings_today","filings_this_week","total_companies","total_filings"],"title":"FreshnessOut"},"FundRegistration":{"properties":{"doc_id":{"type":"string","title":"Doc Id"},"doc_type":{"type":"string","enum":["030","040"],"title":"Doc Type"},"amends_doc_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Amends Doc Id","description":"EDINET document ID that this amendment refers to."},"edinet_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Edinet Code","description":"EDINET code of the filing issuer or manager."},"fund_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fund Code","description":"Source G-code, absent when a foreign cover supplies none."},"fund_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fund Name"},"issuer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issuer Name","description":"Filed name of the issuer or asset manager."},"filing_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Filing Date"},"document_form":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Form"},"offering_amount_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Offering Amount Text","description":"Filed offering cap as text."},"agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent"},"fiscal_period_start":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fiscal Period Start"},"fiscal_period_end":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Fiscal Period End"},"place_of_filing":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Of Filing"},"representative":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Representative"},"hq_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hq Address"},"contact_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact Name"},"telephone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Telephone"},"industry_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry Code"},"parse_warnings":{"items":{"type":"string"},"type":"array","title":"Parse Warnings"}},"type":"object","required":["doc_id","doc_type"],"title":"FundRegistration"},"GrowthMetrics":{"properties":{"revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Revenue","description":"Revenue growth rate (%). Positive means growth."},"gross_profit":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gross Profit","description":"Gross profit growth rate (%)."},"net_income":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Net Income","description":"Net income growth rate (%)."},"operating_income":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Operating Income","description":"Operating income growth rate (%)."},"eps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Eps","description":"EPS growth rate (%)."},"total_assets":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Assets","description":"Total assets growth rate (%)."}},"type":"object","title":"GrowthMetrics"},"GrowthOut":{"properties":{"yoy":{"items":{"$ref":"#/components/schemas/YoyEntry"},"type":"array","title":"Yoy","description":"Year-over-year growth rates for each fiscal year."},"cagr":{"$ref":"#/components/schemas/CagrOut","description":"Compound annual growth rates (3-year and 5-year)."}},"type":"object","required":["yoy","cagr"],"title":"GrowthOut"},"GuidanceRevision":{"properties":{"period_type":{"type":"string","enum":["FY","Q2"],"title":"Period Type"},"period_start":{"type":"string","format":"date","title":"Period Start"},"period_end":{"type":"string","format":"date","title":"Period End"},"accounting_standard":{"type":"string","enum":["JP-GAAP","IFRS"],"title":"Accounting Standard"},"is_consolidated":{"type":"boolean","title":"Is Consolidated"},"previous":{"$ref":"#/components/schemas/GuidanceValues"},"current":{"$ref":"#/components/schemas/GuidanceValues"},"previous_unreported_fields":{"items":{"type":"string"},"type":"array","title":"Previous Unreported Fields"},"current_unreported_fields":{"items":{"type":"string"},"type":"array","title":"Current Unreported Fields"}},"additionalProperties":false,"type":"object","required":["period_type","period_start","period_end","accounting_standard","is_consolidated","previous","current","previous_unreported_fields","current_unreported_fields"],"title":"GuidanceRevision"},"GuidanceValues":{"properties":{"revenue":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Revenue"},"operating_revenues":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Operating Revenues"},"gross_operating_revenues":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Gross Operating Revenues"},"bank_ordinary_revenues":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bank Ordinary Revenues"},"operating_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Operating Income"},"ordinary_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ordinary Income"},"profit_before_tax":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Profit Before Tax"},"profit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Profit"},"net_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Net Income"},"eps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Eps"}},"additionalProperties":false,"type":"object","title":"GuidanceValues","description":"Monetary amounts are integer JPY; EPS is JPY per share."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthCheckOut":{"properties":{"status":{"type":"string","title":"Status","description":"Service status: 'ok' or 'degraded'."},"snapshot":{"$ref":"#/components/schemas/SnapshotHealthOut","description":"The read snapshot this instance is serving."}},"type":"object","required":["status","snapshot"],"title":"HealthCheckOut"},"HealthScoreOut":{"properties":{"edinet_code":{"type":"string","title":"Edinet Code","description":"EDINET submitter code."},"score":{"type":"integer","title":"Score","description":"Financial health score from 0 to 100. Higher is healthier."},"components":{"additionalProperties":{"type":"number"},"type":"object","title":"Components","description":"Score breakdown by component (stability, profitability, cash_flow)."},"flags":{"items":{"type":"string"},"type":"array","title":"Flags","description":"Risk flags (e.g. net_loss, negative_operating_cf)."},"industry_adjustment":{"type":"number","title":"Industry Adjustment","description":"Industry adjustment points (-5 to +5) vs sector medians."},"fiscal_year":{"type":"integer","title":"Fiscal Year","description":"Fiscal year the score is based on."},"computed_at":{"type":"string","format":"date-time","title":"Computed At","description":"When the score was computed."},"data_source":{"type":"string","title":"Data Source","description":"Data provenance.","default":"EDINET (Financial Services Agency of Japan)"},"methodology":{"type":"string","title":"Methodology","description":"Human-readable summary of the scoring methodology.","default":"Base 50 + stability (max 20) + profitability (max 20) + cash flow (max 10) + industry adjustment (±5). All inputs derived from audited XBRL filings."}},"type":"object","required":["edinet_code","score","components","flags","industry_adjustment","fiscal_year","computed_at"],"title":"HealthScoreOut"},"HolderFormerNameOut":{"properties":{"name_jp":{"type":"string","title":"Name Jp","description":"A name the holder filed under before its current one"},"first_base_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"First Base Date","description":"Reporting-obligation date (報告義務発生日) of the first served report under this name"},"last_base_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Base Date","description":"Reporting-obligation date of the last served report under this name"}},"type":"object","required":["name_jp"],"title":"HolderFormerNameOut"},"IdentifierProvenance":{"properties":{"market_identifiers":{"type":"string","title":"Market Identifiers","description":"Where `securities_code`, `isin` and `jpx_code` come from, and what their nulls mean. 'market_cross_reference': served from the listed-issuer cross-reference. 'unlisted': this filer is not listed, so it has none to carry. 'unmapped': listed, but not yet cross-referenced, so they are unknown to us. 'not_an_issuer': the identifier names an entity with no issuer facet, so they do not apply."},"entity_registry":{"type":"string","title":"Entity Registry","description":"Where the ENTITY-level fields (`lei`, `entity_id`, `name`) come from. 'entity_registry': a resolved entity record backs this identifier. 'none': the identifier is known only from filing data, so `lei` and `entity_id` are unknown rather than absent."},"explanation":{"type":"string","title":"Explanation","description":"The same statement in prose. Always present."}},"type":"object","required":["market_identifiers","entity_registry","explanation"],"title":"IdentifierProvenance","description":"Why the identifier fields hold the values they hold.\n\nA null identifier is only usable if the consumer can tell \"we checked and\nthere is none\" from \"we never looked\". These three fields carry that\ndistinction structurally so it does not have to be inferred from prose."},"IdentifiersOut":{"properties":{"edinet_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Edinet Code","description":"EDINET submitter code (e.g. 'E02144'). Null only when the identifier names an entity that has never filed under one of its own, which is possible for a group of co-filing investors."},"securities_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Securities Code","description":"TSE securities code (e.g. '7203')."},"isin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Isin","description":"ISIN (12-character international securities ID)."},"lei":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lei","description":"Legal Entity Identifier (20 characters). An entity-level identifier, so it is served from the resolved entity record and never from the listed-issuer cross-reference. Null when no entity record backs this identifier, or when that record carries no LEI; `provenance.entity_registry` says which."},"jpx_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jpx Code","description":"JPX issuer code."},"match_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Match Method","description":"How the market identifiers were matched (e.g. 'exact', 'fuzzy'). Null when this company is not in the listed-issuer cross-reference; `provenance.market_identifiers` says why."},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence","description":"Match confidence (0.0 to 1.0). Null when there is no match to score."},"matched_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Matched At","description":"When the market identifiers were last matched. Null when never matched."},"entity_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Id","description":"Stable key of the resolved entity behind this identifier. Null when no resolved entity record covers it."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"The entity's name, as filed (Japanese)."},"name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En","description":"English name, where we hold one."},"roles":{"items":{"type":"string"},"type":"array","title":"Roles","description":"Every role this entity holds: 'issuer' (company endpoints answer for it) and/or 'investor' (it files shareholding reports). An entity is legitimately both, so this is always a list."},"links":{"additionalProperties":{"type":"string"},"type":"object","title":"Links","description":"Role to the endpoint path that answers for this entity in that role."},"provenance":{"$ref":"#/components/schemas/IdentifierProvenance","description":"What the null fields above mean. Always present."}},"type":"object","required":["provenance"],"title":"IdentifiersOut"},"InternalControlReport":{"properties":{"doc_id":{"type":"string","title":"Doc Id"},"doc_type":{"type":"string","enum":["235","236"],"title":"Doc Type"},"amends_doc_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Amends Doc Id"},"edinet_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Edinet Code"},"security_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Security Code"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"company_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name En"},"filing_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Filing Date"},"document_form":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Form"},"effectiveness":{"type":"string","enum":["effective","not_effective","unknown"],"title":"Effectiveness","default":"unknown"},"result_of_evaluation_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Result Of Evaluation Text"},"material_weakness":{"type":"boolean","title":"Material Weakness","default":false},"representative":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Representative"},"cfo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cfo"},"hq_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hq Address"},"place_of_filing":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Place Of Filing"},"cabinet_ordinance":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cabinet Ordinance"},"evaluation_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Evaluation Date"},"parse_warnings":{"items":{"type":"string"},"type":"array","title":"Parse Warnings"}},"type":"object","required":["doc_id","doc_type"],"title":"InternalControlReport"},"InvestorInfo":{"properties":{"edinet_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Edinet Code"},"filer_code":{"type":"string","title":"Filer Code","description":"Stable investor identifier accepted by /investors/{code}/positions"},"name_jp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name Jp"},"name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En"},"former_names":{"items":{"$ref":"#/components/schemas/HolderFormerNameOut"},"type":"array","title":"Former Names","description":"Names this holder filed large-shareholding reports under other than name_jp (its latest report's name among them when name_jp is its official registered name), newest first, each bounded by the reports that carry it"},"identity_basis":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identity Basis","description":"'named_by_filer' when the holder has no registered identity and is known only by the name one filer gives it in its own reports; null otherwise"},"total_positions":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Positions"},"active_positions":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Active Positions"}},"type":"object","required":["filer_code"],"title":"InvestorInfo"},"InvestorPositionOut":{"properties":{"issuer_security_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issuer Security Code"},"issuer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issuer Name"},"issuer_name_jp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issuer Name Jp"},"latest_holding_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latest Holding Pct"},"trajectory_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trajectory Type"},"streak_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Streak Length"},"velocity_pp_per_month":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Velocity Pp Per Month"},"purpose_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purpose Category"},"first_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Date"},"last_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Date"},"filing_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Filing Count"},"delta_90d_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta 90D Pct"},"delta_180d_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta 180D Pct"},"delta_1y_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta 1Y Pct"},"points":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Points"}},"type":"object","title":"InvestorPositionOut"},"InvestorPositionsData":{"properties":{"investor":{"anyOf":[{"$ref":"#/components/schemas/InvestorInfo"},{"type":"null"}]},"positions":{"items":{"$ref":"#/components/schemas/InvestorPositionOut"},"type":"array","title":"Positions"},"joint_filers":{"items":{"$ref":"#/components/schemas/JointFilerOut"},"type":"array","title":"Joint Filers","description":"Holders named with this investor as joint holders (共同保有者) in large-shareholding reports, most frequent first. Joint filing is a disclosed relationship, not common ownership or control."}},"type":"object","title":"InvestorPositionsData"},"InvestorSearchResult":{"properties":{"edinet_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Edinet Code","description":"The investor's own EDINET code. Null when the investor has none, which is the case for a group resolved across several filers. Use filer_code to look the investor up."},"filer_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filer Code","description":"Stable identifier for the investor. Pass it to /investors/{code}/positions. It may differ from edinet_code; both identifiers reach the same investor when their identity is resolved."},"name_jp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name Jp"},"name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En"},"former_names":{"items":{"$ref":"#/components/schemas/HolderFormerNameOut"},"type":"array","title":"Former Names","description":"Names this holder filed large-shareholding reports under other than name_jp (its latest report's name among them when name_jp is its official registered name), newest first, each bounded by the reports that carry it"},"positions":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Positions"}},"type":"object","title":"InvestorSearchResult"},"JointFilerOut":{"properties":{"edinet_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Edinet Code","description":"The partner's EDINET code, usable as /investors/{code}/positions; null when the partner is known only by its filed name"},"name":{"type":"string","title":"Name","description":"Registered name, or the filed name when not registered"},"names":{"items":{"type":"string"},"type":"array","title":"Names","description":"Every name the partner filed under"},"co_filing_count":{"type":"integer","title":"Co Filing Count","description":"Large-shareholding reports filed jointly with this investor"},"last_base_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Base Date","description":"Reporting-obligation date (報告義務発生日) of the latest joint report"}},"type":"object","required":["name","co_filing_count"],"title":"JointFilerOut"},"KeyResponse":{"properties":{"id":{"type":"integer","title":"Id"},"key_prefix":{"type":"string","title":"Key Prefix"},"tier":{"type":"string","title":"Tier"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"},"created_at":{"type":"string","title":"Created At"},"last_used_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Used At"}},"type":"object","required":["id","key_prefix","tier","label","created_at","last_used_at"],"title":"KeyResponse"},"ListKeysResponse":{"properties":{"keys":{"items":{"$ref":"#/components/schemas/KeyResponse"},"type":"array","title":"Keys"},"has_ever_created":{"type":"boolean","title":"Has Ever Created"},"allowance":{"anyOf":[{"$ref":"#/components/schemas/AllowanceOut"},{"type":"null"}]},"subscribed":{"type":"boolean","title":"Subscribed","default":false}},"type":"object","required":["keys","has_ever_created"],"title":"ListKeysResponse"},"ListResponse_ActivistCampaignOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/ActivistCampaignOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[ActivistCampaignOut]"},"ListResponse_BoardInterlockOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/BoardInterlockOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[BoardInterlockOut]"},"ListResponse_BulkFinancialOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/BulkFinancialOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[BulkFinancialOut]"},"ListResponse_BuybackAccelerationOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/BuybackAccelerationOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[BuybackAccelerationOut]"},"ListResponse_BuybackOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/BuybackOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[BuybackOut]"},"ListResponse_CalendarEntry_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/CalendarEntry"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[CalendarEntry]"},"ListResponse_CapitalAllocationOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/CapitalAllocationOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[CapitalAllocationOut]"},"ListResponse_CompanyOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/CompanyOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[CompanyOut]"},"ListResponse_CompanySearchOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/CompanySearchOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[CompanySearchOut]"},"ListResponse_CompareResultOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/CompareResultOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[CompareResultOut]"},"ListResponse_CrossHoldingOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/CrossHoldingOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[CrossHoldingOut]"},"ListResponse_EarningsForecastOut_":{"properties":{"data":{"description":"Array of result objects.","items":{"$ref":"#/components/schemas/EarningsForecastOut"},"title":"Data","type":"array"},"meta":{"$ref":"#/components/schemas/Meta","description":"Pagination and request metadata."}},"required":["data","meta"],"title":"ListResponse[EarningsForecastOut]","type":"object"},"ListResponse_EarningsSignalOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/EarningsSignalOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[EarningsSignalOut]"},"ListResponse_EarningsSnapshotOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/EarningsSnapshotOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[EarningsSnapshotOut]"},"ListResponse_EarningsSurpriseOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/EarningsSurpriseOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[EarningsSurpriseOut]"},"ListResponse_FilingOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/FilingOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[FilingOut]"},"ListResponse_FinancialOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/FinancialOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[FinancialOut]"},"ListResponse_IdentifiersOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/IdentifiersOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[IdentifiersOut]"},"ListResponse_InvestorSearchResult_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/InvestorSearchResult"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[InvestorSearchResult]"},"ListResponse_OwnershipChartSeriesOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/OwnershipChartSeriesOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[OwnershipChartSeriesOut]"},"ListResponse_OwnershipMoverOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/OwnershipMoverOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[OwnershipMoverOut]"},"ListResponse_OwnershipSignalOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/OwnershipSignalOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[OwnershipSignalOut]"},"ListResponse_PeerOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/PeerOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[PeerOut]"},"ListResponse_RankingResultOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/RankingResultOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[RankingResultOut]"},"ListResponse_RatioOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/RatioOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[RatioOut]"},"ListResponse_ScreenResultOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/ScreenResultOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[ScreenResultOut]"},"ListResponse_SectionOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/SectionOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[SectionOut]"},"ListResponse_SectorListItem_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/SectorListItem"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[SectorListItem]"},"ListResponse_ShareholdingOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/ShareholdingOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[ShareholdingOut]"},"ListResponse_TimeseriesResultOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/TimeseriesResultOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[TimeseriesResultOut]"},"ListResponse_TrajectoryOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/TrajectoryOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[TrajectoryOut]"},"ListResponse_TranslationOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/TranslationOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[TranslationOut]"},"ListResponse_TranslationSearchResult_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/TranslationSearchResult"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[TranslationSearchResult]"},"ListResponse_UnwindingScoreboardOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/UnwindingScoreboardOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[UnwindingScoreboardOut]"},"ListResponse_VotingResultOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/VotingResultOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[VotingResultOut]"},"ListResponse_WatchlistItemOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/WatchlistItemOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[WatchlistItemOut]"},"ListResponse_WebhookOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/WebhookOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[WebhookOut]"},"ManagementForecastOut":{"properties":{"securities_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Securities Code"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"company_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name En"},"fiscal_year_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fiscal Year End"},"period_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Type"},"filing_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filing Date"},"accounting_standard":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accounting Standard"},"tdnet_pdf_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tdnet Pdf Url","description":"URL of the source 決算短信 PDF on TDNet. Every forecast traces back here."},"forecast_revenue":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Forecast Revenue"},"forecast_operating_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Forecast Operating Income"},"forecast_ordinary_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Forecast Ordinary Income"},"forecast_net_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Forecast Net Income"},"forecast_eps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Forecast Eps"},"forecast_revenue_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Forecast Revenue Change Pct"},"forecast_operating_income_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Forecast Operating Income Change Pct"},"forecast_net_income_change_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Forecast Net Income Change Pct"},"source_type":{"type":"string","enum":["earnings_release","forecast_revision"],"title":"Source Type"},"published_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published At"},"forecast_period_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Forecast Period Start"},"forecast_period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Forecast Period End"},"forecast_period_type":{"anyOf":[{"type":"string","enum":["FY","Q2"]},{"type":"null"}],"title":"Forecast Period Type"},"forecast_period_verified":{"type":"boolean","title":"Forecast Period Verified"},"is_consolidated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Consolidated"},"forecast_operating_revenues":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Forecast Operating Revenues"},"forecast_gross_operating_revenues":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Forecast Gross Operating Revenues"},"forecast_bank_ordinary_revenues":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Forecast Bank Ordinary Revenues"},"forecast_profit_before_tax":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Forecast Profit Before Tax"},"forecast_profit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Forecast Profit"},"previous_forecast":{"anyOf":[{"$ref":"#/components/schemas/GuidanceValues"},{"type":"null"}]},"previous_unreported_fields":{"items":{"type":"string"},"type":"array","title":"Previous Unreported Fields"},"current_unreported_fields":{"items":{"type":"string"},"type":"array","title":"Current Unreported Fields"},"revision_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Revision Reason"}},"type":"object","required":["source_type","forecast_period_verified"],"title":"ManagementForecastOut"},"ManagementForecastResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/ManagementForecastOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Pagination and request metadata."},"revision_sources":{"items":{"$ref":"#/components/schemas/ForecastSourceNotice"},"type":"array","title":"Revision Sources"}},"type":"object","required":["data","meta","revision_sources"],"title":"ManagementForecastResponse"},"Meta":{"additionalProperties":true,"properties":{"total":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Total number of matching records. Absent on endpoints that do not report a count.","title":"Total"},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Maximum records returned per page. Present only on endpoints that paginate; its absence means this endpoint returns a complete result set and does not accept `limit`/`offset`/`cursor`.","title":"Limit"},"offset":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of records skipped (offset-based pagination). Absent when the endpoint does not paginate, and when a `cursor` is in use (offset is not meaningful in keyset mode).","title":"Offset"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Opaque cursor for the next page (keyset pagination). Null on the last page. Absent on endpoints that do not paginate.","title":"Next Cursor"},"request_id":{"description":"Unique request identifier for tracing and support (e.g. 'req_abc123').","title":"Request Id","type":"string"},"computation_version":{"default":"2026.10.2","description":"Public compatibility version of the response schema. Bumped on breaking changes. Format: YYYY.MM.N. For exact reproduction, use the `as_of` token instead.","title":"Computation Version","type":"string"},"ontology_version":{"default":"3.2.0","description":"Semver of the field/unit interpretation layer. Bumped on breaking changes to field labelling or unit handling. For exact reproduction, use the `as_of` token instead.","title":"Ontology Version","type":"string"},"data_as_of":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"description":"Timestamp of the last successful data ingest from EDINET, ISO 8601 with timezone. Absent when this endpoint cannot state its own source freshness. It is never null: a freshness check that reads this key gets a real timestamp or nothing at all.","title":"Data As Of"},"caveats":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"description":"Endpoint-specific caveats consumers should know about when interpreting this response. Examples: source provenance (EDINET vs TDNet), computation schedule (raw filing vs derived analytics), or fields that need trust filtering (name_en_quality). Null when no caveats apply.","title":"Caveats"}},"required":["request_id"],"title":"Meta","type":"object"},"MetricCoverage":{"properties":{"count":{"type":"integer","title":"Count","description":"Number of filings that have this metric."},"total_filings":{"type":"integer","title":"Total Filings","description":"Total filings checked."},"coverage_pct":{"type":"number","title":"Coverage Pct","description":"Percentage of filings with this metric (0-100)."}},"type":"object","required":["count","total_filings","coverage_pct"],"title":"MetricCoverage"},"OpenCompanyOut":{"properties":{"edinet_code":{"type":"string","title":"Edinet Code"},"securities_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Securities Code"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"opened_at":{"type":"string","title":"Opened At"},"expires_at":{"type":"string","title":"Expires At"}},"type":"object","required":["edinet_code","securities_code","name","opened_at","expires_at"],"title":"OpenCompanyOut"},"OwnershipChartPointOut":{"properties":{"base_date":{"type":"string","format":"date","title":"Base Date","description":"Date the reported position is as of: the reporting-obligation date (報告義務発生日)"},"holding_ratio_pct":{"type":"number","title":"Holding Ratio Pct","description":"The stake this holder reports for itself, as a percentage of the issuer's outstanding shares. On a joint filing (co_holder_count > 1) this is the individual holder's own position, not the group's. Compare with group_ratio_pct for the combined position the 5% obligation attaches to."},"delta_pct":{"type":"number","title":"Delta Pct","description":"Change from previous point in pp","default":0.0},"purpose":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purpose","description":"Purpose of holding"},"doc_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Id","description":"EDINET document ID"}},"type":"object","required":["base_date","holding_ratio_pct"],"title":"OwnershipChartPointOut"},"OwnershipChartSeriesOut":{"properties":{"filer_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filer Code","description":"EDINET code of the filer. Null when the filer is a group of entities with no EDINET code of its own or when its public identifier is ambiguous; use filer_name and the points' doc_id values."},"filer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filer Name","description":"Name of the filer"},"source":{"type":"string","title":"Source","description":"'trajectory' or 'shareholding'"},"trajectory_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trajectory Type","description":"accumulating, exiting, stable, new_position"},"latest_holding_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latest Holding Pct","description":"Most recent holding ratio"},"points":{"items":{"$ref":"#/components/schemas/OwnershipChartPointOut"},"type":"array","title":"Points","description":"Timeline points sorted by date"}},"type":"object","required":["source","points"],"title":"OwnershipChartSeriesOut"},"OwnershipMoverOut":{"properties":{"issuer_security_code":{"type":"string","title":"Issuer Security Code","description":"Securities code of the issuer"},"issuer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issuer Name","description":"Name of the issuer (JP)"},"issuer_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issuer Name En","description":"English name of the issuer"},"filer_canonical_code":{"type":"string","title":"Filer Canonical Code","description":"Stable canonical identifier for the filer. Equals the filer's EDINET code for ungrouped filers; opaque token for entity-resolved groups."},"filer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filer Name","description":"Name of the filer (JP)"},"filer_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filer Name En","description":"English name of the filer"},"latest_holding_ratio_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latest Holding Ratio Pct","description":"Latest observation. The stake this holder reports for itself, as a percentage of the issuer's outstanding shares. On a joint filing (co_holder_count > 1) this is the individual holder's own position, not the group's. Compare with group_ratio_pct for the combined position the 5% obligation attaches to."},"trajectory_type":{"type":"string","title":"Trajectory Type","description":"accumulating or exiting"},"velocity_pp_per_month":{"type":"number","title":"Velocity Pp Per Month","description":"Percentage points change per month"},"delta_90d_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta 90D Pct","description":"Change over 90 days"},"last_base_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Base Date","description":"Reporting-obligation date (報告義務発生日) of the most recent report"},"purpose_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purpose Category","description":"Latest classified purpose"}},"type":"object","required":["issuer_security_code","filer_canonical_code","trajectory_type","velocity_pp_per_month"],"title":"OwnershipMoverOut"},"OwnershipSignalOut":{"properties":{"signal_type":{"type":"string","title":"Signal Type","description":"Signal type: accumulation_streak, large_step_up, exit_below_5pct, etc."},"filer_code":{"type":"string","title":"Filer Code","description":"Stable canonical identifier for the filer. Equals the filer's EDINET code for ungrouped filers; opaque token for entity-resolved groups."},"filer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filer Name","description":"Name of the filer (JP)"},"filer_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filer Name En","description":"English name of the filer"},"issuer_security_code":{"type":"string","title":"Issuer Security Code","description":"Securities code of the issuer"},"issuer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issuer Name","description":"Name of the issuer (JP)"},"issuer_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issuer Name En","description":"English name of the issuer"},"detected_date":{"type":"string","format":"date","title":"Detected Date","description":"Date the signal was detected"},"holding_ratio_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Holding Ratio Pct","description":"At signal time. The stake this holder reports for itself, as a percentage of the issuer's outstanding shares. On a joint filing (co_holder_count > 1) this is the individual holder's own position, not the group's. Compare with group_ratio_pct for the combined position the 5% obligation attaches to."},"delta_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta Pct","description":"Change in percentage points"},"confidence":{"type":"number","title":"Confidence","description":"Confidence score 0-1"},"doc_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Id","description":"EDINET document ID of the triggering filing (e.g. 'S100ABCD')"},"tier":{"type":"integer","title":"Tier","description":"Signal tier: 1=actionable, 2=informational, 3=trivial","default":3},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Signal-specific context (streak, purpose, filers)"}},"type":"object","required":["signal_type","filer_code","issuer_security_code","detected_date","confidence"],"title":"OwnershipSignalOut"},"PeerOut":{"properties":{"company":{"$ref":"#/components/schemas/CompanyOut","description":"Peer company details."},"fiscal_year":{"type":"integer","title":"Fiscal Year","description":"Fiscal year of the peer data."},"revenue":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Revenue","description":"Revenue in JPY."},"net_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Net Income","description":"Net income in JPY."},"roe":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Roe","description":"Return on equity for this fiscal year, expressed as a decimal (0.124 = 12.4%). Null when underlying inputs are unavailable."},"health_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Health Score","description":"Financial-health composite (0-100). See the health-score documentation for the published methodology. Null when not yet available for this period."}},"type":"object","required":["company","fiscal_year"],"title":"PeerOut"},"ProbabilityBucketOut":{"properties":{"stake_range":{"type":"string","title":"Stake Range","description":"Stake range bucket: <5%, 5-10%, 10-20%, 20-33%, 33%+"},"streak_range":{"type":"string","title":"Streak Range","description":"Streak length bucket: 1, 2-3, 4+"},"purpose_type":{"type":"string","title":"Purpose Type","description":"Purpose bucket: investment, strategic, activist, other"},"sample_size":{"type":"integer","title":"Sample Size","description":"Number of trajectories in this bucket"},"confidence_level":{"type":"string","title":"Confidence Level","description":"low (<10), medium (10-29), high (>=30)"},"p_reach_10pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"P Reach 10Pct","description":"P(ever reaching 10%)"},"p_reach_20pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"P Reach 20Pct","description":"P(ever reaching 20%)"},"p_reach_33pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"P Reach 33Pct","description":"P(ever reaching 33% blocking minority)"},"p_exit_6m":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"P Exit 6M","description":"P(exiting within 6 months)"}},"type":"object","required":["stake_range","streak_range","purpose_type","sample_size","confidence_level"],"title":"ProbabilityBucketOut"},"ProbabilityTableOut":{"properties":{"buckets":{"items":{"$ref":"#/components/schemas/ProbabilityBucketOut"},"type":"array","title":"Buckets","description":"Per-bucket conditional probabilities"},"total_trajectories":{"type":"integer","title":"Total Trajectories","description":"Total trajectories used to compute table"},"model_version":{"type":"string","title":"Model Version","description":"Model version identifier","default":"v1"}},"type":"object","required":["buckets","total_trajectories"],"title":"ProbabilityTableOut"},"RankingResultOut":{"properties":{"rank":{"type":"integer","title":"Rank","description":"Position in the ranking (1-based)."},"company":{"$ref":"#/components/schemas/CompanyOut","description":"Company details."},"fiscal_year":{"type":"integer","title":"Fiscal Year","description":"Fiscal year of the ranked value."},"value":{"anyOf":[{"type":"number"},{"type":"integer"},{"type":"null"}],"title":"Value","description":"The metric value used for ranking."},"metric":{"type":"string","title":"Metric","description":"Which metric was used (e.g. 'revenue', 'roe')."}},"type":"object","required":["rank","company","fiscal_year","metric"],"title":"RankingResultOut"},"RatioOut":{"properties":{"fiscal_year":{"type":"integer","title":"Fiscal Year","description":"Fiscal year."},"period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period End","description":"Last day of the fiscal period (ISO 8601)."},"roe":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Roe","description":"Return on equity (%). Net income ÷ average equity."},"roa":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Roa","description":"Return on assets (%). Net income ÷ average total assets."},"operating_margin":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Operating Margin","description":"Operating margin (%). Operating income ÷ revenue."},"net_margin":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Net Margin","description":"Net margin (%). Net income ÷ revenue."},"gross_margin":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gross Margin","description":"Gross margin (%). Gross profit ÷ revenue."},"equity_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Equity Ratio","description":"Equity ratio (%). Total equity ÷ total assets."},"debt_to_equity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Debt To Equity","description":"Debt-to-equity ratio. Total liabilities ÷ total equity."},"current_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Current Ratio","description":"Current ratio. Current assets / current liabilities."},"interest_coverage":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Interest Coverage","description":"Interest coverage ratio. Operating income ÷ interest expense."},"pe_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pe Ratio","description":"Price-to-earnings ratio."},"num_employees":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Employees","description":"Number of employees (headcount)."},"eps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Eps","description":"Basic earnings per share in JPY."},"bps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Bps","description":"Book value per share in JPY."},"dividends_per_share":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Dividends Per Share","description":"Annual dividends per share in JPY."},"payout_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Payout Ratio","description":"Dividend payout ratio (%)."}},"type":"object","required":["fiscal_year"],"title":"RatioOut"},"RegisterShareholderRowOut":{"properties":{"rank":{"type":"integer","title":"Rank","description":"Rank in the register (1 = largest holder)."},"holder_name":{"type":"string","title":"Holder Name","description":"Holder name as disclosed."},"holder_type":{"type":"string","title":"Holder Type","description":"Coarse holder class: trust_nominee, foreign_custody, employee_plan, foundation, financial_institution, other. trust_nominee / foreign_custody rows are custody aggregates, not beneficial owners."},"quantity_held":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Quantity Held","description":"Shares held on the basis date."},"quantity_precision":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quantity Precision","description":"Precision of quantity_held: 'exact' or 'thousands'."},"ratio_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ratio Pct","description":"Holding ratio as printed in the filing (%). Basis varies by year."},"ratio_basis":{"type":"string","title":"Ratio Basis","description":"Denominator regime of ratio_pct: 'issued', 'ex_treasury', 'indistinguishable', or 'unknown'."},"ratio_pct_issued":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ratio Pct Issued","description":"Holding ratio recomputed on total issued shares (%), a regime-independent series for time-series and cross-company comparison. Prefer this over ratio_pct."}},"additionalProperties":true,"type":"object","required":["rank","holder_name","holder_type","ratio_basis"],"title":"RegisterShareholderRowOut","description":"One fiscal-year-end register row (基準日 top holders), basis='shares'.\n\nWhen 'quantity_held' / 'ratio_pct' / 'ratio_pct_issued' is null, a\ncompanion '<field>_null_reason' key (public vocabulary) is added to explain\nwhy, these keys appear only when the value is null."},"RegisterShareholdersOut":{"properties":{"as_of":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"As Of","description":"Register basis date (fiscal year end)."},"filed":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Filed","description":"Date the annual report was filed."},"basis":{"type":"string","title":"Basis","description":"Register basis; always 'shares' here.","default":"shares"},"rows":{"items":{"$ref":"#/components/schemas/RegisterShareholderRowOut"},"type":"array","title":"Rows"},"data_notes":{"items":{"type":"string"},"type":"array","title":"Data Notes","description":"Interpretation notes consumers must read before using these rows."}},"type":"object","title":"RegisterShareholdersOut","description":"Issuer-reported fiscal-year-end shareholder register (大株主の状況)."},"RelationshipHoldingOut":{"properties":{"issuer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issuer Name","description":"Name of the held company"},"issuer_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issuer Name En","description":"English name of the held company when available."},"issuer_security_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issuer Security Code","description":"Securities code of the held company"},"holding_ratio_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Holding Ratio Pct","description":"Latest observation. The stake this holder reports for itself, as a percentage of the issuer's outstanding shares. On a joint filing (co_holder_count > 1) this is the individual holder's own position, not the group's. Compare with group_ratio_pct for the combined position the 5% obligation attaches to."},"trajectory_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trajectory Type","description":"accumulating, exiting, stable, new_position"}},"type":"object","title":"RelationshipHoldingOut"},"RelationshipShareholderOut":{"properties":{"filer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filer Name","description":"Filer/shareholder name"},"filer_canonical_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filer Canonical Code","description":"Filer EDINET code"},"holding_ratio_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Holding Ratio Pct","description":"Latest observation. The stake this holder reports for itself, as a percentage of the issuer's outstanding shares. On a joint filing (co_holder_count > 1) this is the individual holder's own position, not the group's. Compare with group_ratio_pct for the combined position the 5% obligation attaches to."},"trajectory_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trajectory Type","description":"accumulating, exiting, stable, new_position"},"purpose_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purpose Category","description":"Investment purpose"}},"type":"object","title":"RelationshipShareholderOut"},"ScreenFinancials":{"properties":{"fiscal_year":{"type":"integer","title":"Fiscal Year","description":"Fiscal year of the financial data."},"revenue":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Revenue","description":"Revenue in JPY."},"gross_profit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Gross Profit","description":"Gross profit in JPY."},"net_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Net Income","description":"Net income in JPY."},"operating_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Operating Income","description":"Operating income in JPY."},"total_assets":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Assets","description":"Total assets in JPY."},"total_equity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Equity","description":"Total equity in JPY."},"total_liabilities":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Liabilities","description":"Total liabilities in JPY."},"current_assets":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Current Assets","description":"Current assets in JPY."},"current_liabilities":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Current Liabilities","description":"Current liabilities in JPY."}},"type":"object","required":["fiscal_year"],"title":"ScreenFinancials"},"ScreenMetrics":{"properties":{"roe":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Roe","description":"Return on equity (%)."},"roa":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Roa","description":"Return on assets (%)."},"operating_margin":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Operating Margin","description":"Operating margin (%)."},"net_margin":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Net Margin","description":"Net margin (%)."},"equity_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Equity Ratio","description":"Equity ratio (%)."},"pe_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pe Ratio","description":"Price-to-earnings ratio (latest filed)."}},"type":"object","title":"ScreenMetrics"},"ScreenResultOut":{"properties":{"company":{"$ref":"#/components/schemas/CompanyOut","description":"Company details."},"financials":{"$ref":"#/components/schemas/ScreenFinancials","description":"Latest financial data."},"metrics":{"$ref":"#/components/schemas/ScreenMetrics","description":"Computed financial ratios."}},"type":"object","required":["company","financials","metrics"],"title":"ScreenResultOut"},"SectionOut":{"properties":{"section":{"type":"string","title":"Section","description":"Section key (e.g. 'mda', 'risk_factors')."},"label_en":{"type":"string","title":"Label En","description":"Human-readable English label for the section."},"label_jp":{"type":"string","title":"Label Jp","description":"Japanese label for the section."},"text_jp":{"type":"string","title":"Text Jp","description":"Full Japanese text of the section. No truncation."},"text_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text En","description":"English translation, if available. Null when not yet translated."},"char_count":{"type":"integer","title":"Char Count","description":"Character count of the Japanese text."}},"type":"object","required":["section","label_en","label_jp","text_jp","char_count"],"title":"SectionOut"},"SectorAggregates":{"properties":{"total_revenue":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Revenue","description":"Sum of revenue across all companies in the sector (JPY)."},"avg_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Revenue","description":"Mean revenue in the sector (JPY)."},"min_revenue":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Revenue","description":"Minimum revenue in the sector (JPY)."},"max_revenue":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Revenue","description":"Maximum revenue in the sector (JPY)."},"total_net_income":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Net Income","description":"Sum of net income across the sector (JPY)."},"avg_net_income":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Net Income","description":"Mean net income in the sector (JPY)."},"avg_roe":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Roe","description":"Mean ROE in the sector (%)."},"avg_roa":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Roa","description":"Mean ROA in the sector (%)."},"avg_operating_margin":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Operating Margin","description":"Mean operating margin in the sector (%)."}},"type":"object","title":"SectorAggregates"},"SectorBreakdown":{"properties":{"sector":{"type":"string","title":"Sector","description":"TSE 33-sector name in Japanese."},"companies":{"type":"integer","title":"Companies","description":"Number of companies in this sector."}},"type":"object","required":["sector","companies"],"title":"SectorBreakdown"},"SectorListItem":{"properties":{"sector":{"type":"string","title":"Sector","description":"TSE 33-sector name in Japanese."},"sector_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sector En","description":"TSE 33-sector name in English."},"sector_display":{"type":"string","title":"Sector Display","description":"Always-populated display label, sector_en when available, 'Unlisted' when entity has no TSE listing, 'Uncategorised' otherwise.","default":""},"company_count":{"type":"integer","title":"Company Count","description":"Number of companies in this sector."}},"type":"object","required":["sector","company_count"],"title":"SectorListItem"},"SectorStatsOut":{"properties":{"sector":{"type":"string","title":"Sector","description":"TSE 33-sector name in Japanese."},"company_count":{"type":"integer","title":"Company Count","description":"Number of companies in this sector."},"aggregates":{"$ref":"#/components/schemas/SectorAggregates","description":"Aggregate financial statistics."}},"type":"object","required":["sector","company_count","aggregates"],"title":"SectorStatsOut"},"ShareholdingAuditOut":{"properties":{"shareholding_id":{"type":"integer","title":"Shareholding Id","description":"Row identifier."},"source":{"additionalProperties":true,"type":"object","title":"Source","description":"Filing reference. Includes doc_id (EDINET), filer EDINET code, issuer security code, and base_date. Every claim in this bundle traces to this filing."},"realtime":{"additionalProperties":true,"type":"object","title":"Realtime","description":"What was knowable at filing time. Includes predicted_category (= holding_purpose_category), confidence, and as_of_date (= source.base_date)."},"retrospective":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Retrospective","description":"What later evidence revealed. Same shape as realtime but predicted_category may differ when later filings from the same filer × issuer disclosed a more-active intent. evidence_cutoff_date marks the latest filing used. Null when no later evidence existed."},"classifier_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Classifier Version","description":"Opaque version label for how this row was read."}},"type":"object","required":["shareholding_id","source","realtime"],"title":"ShareholdingAuditOut","description":"Full audit bundle for a single shareholding row.\n\nReturned by GET /shareholdings/{id}/audit. Combines the row's\nreal-time and retrospective views, the calibrated confidence, the\nsource filing reference, and the reading's version label into one\nself-contained object that\ninstitutional consumers can cite or pin."},"ShareholdingOut":{"properties":{"id":{"type":"integer","title":"Id","description":"Row identifier. Pass to /shareholdings/{id}/audit for full provenance."},"filer_edinet_code":{"type":"string","title":"Filer Edinet Code","description":"EDINET code of the filer (investor)"},"issuer_security_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issuer Security Code","description":"Securities code of the issuer (target company)"},"issuer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issuer Name","description":"Name of the issuer (target company)"},"holder_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Holder Name","description":"Name of the holder"},"holder_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Holder Type","description":"'individual' or 'corporation'"},"shares_held":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Shares Held","description":"Total shares held. Whole shares. Where the filing states a fraction (depositary receipts converted to shares), the fraction is dropped and the filing is flagged."},"holding_ratio_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Holding Ratio Pct","description":"Holding ratio as percentage"},"previous_holding_ratio_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Previous Holding Ratio Pct","description":"Holding ratio from previous report"},"total_outstanding_shares":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Outstanding Shares","description":"Total outstanding shares of the issuer"},"purpose_of_holding":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purpose Of Holding","description":"Purpose of holding (original Japanese)"},"holding_purpose_category":{"anyOf":[{"type":"string","enum":["pure_investment","portfolio_investment","cross_holding","management_participation","activist","going_private","tender_offer_offeror","tender_offer_target","trading_inventory","other"]},{"type":"null"}],"title":"Holding Purpose Category","description":"Classified purpose. One of: pure_investment, portfolio_investment, cross_holding, management_participation, activist, going_private, tender_offer_offeror, tender_offer_target, trading_inventory, other. activist means the filing states pressure on management: a proposal, a demand, or an important proposal (重要提案行為) that the holder makes, plans or may make. Dialogue with management or advice alone is not activist."},"purpose_confidence":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Purpose Confidence","description":"Calibrated probability of holding_purpose_category. Filter by threshold (e.g. >= 0.9) to get the highest-confidence subset."},"purpose_classifier_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purpose Classifier Version","description":"Opaque version label for how this row was read."},"purpose_retrospective_label":{"anyOf":[{"type":"string","enum":["pure_investment","portfolio_investment","cross_holding","management_participation","activist","going_private","tender_offer_offeror","tender_offer_target","trading_inventory","other"]},{"type":"null"}],"title":"Purpose Retrospective Label","description":"Most-active category disclosed by the same filer×issuer pair at any point. When equal to holding_purpose_category, no later evidence shifted the picture. When different, later evidence revealed an intent the row's real-time label didn't show, the disagreement is the signal."},"purpose_retrospective_cutoff":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Purpose Retrospective Cutoff","description":"base_date of the filing that set purpose_retrospective_label. Use to avoid look-ahead bias in backtests: 'as of this row's base_date the real-time label is what was knowable; the retrospective label uses evidence through this cutoff.'"},"has_important_proposal":{"type":"boolean","title":"Has Important Proposal","description":"Whether the holder intends to make an important proposal","default":false},"base_date":{"type":"string","format":"date","title":"Base Date","description":"Date the reported position is as of: the reporting-obligation date (報告義務発生日)"},"report_type":{"type":"string","title":"Report Type","description":"Report type: 'initial', 'amendment', or 'correction'"},"filing_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filing Reason","description":"Reason for filing (amendments only)"},"doc_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Id","description":"EDINET document ID for source traceability"}},"type":"object","required":["id","filer_edinet_code","base_date","report_type"],"title":"ShareholdingOut"},"SingleResponse_BoardCompositionOut_":{"properties":{"data":{"$ref":"#/components/schemas/BoardCompositionOut","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[BoardCompositionOut]"},"SingleResponse_BuybackAnalysisOut_":{"properties":{"data":{"$ref":"#/components/schemas/BuybackAnalysisOut","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[BuybackAnalysisOut]"},"SingleResponse_CapitalAllocationOut_":{"properties":{"data":{"$ref":"#/components/schemas/CapitalAllocationOut","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[CapitalAllocationOut]"},"SingleResponse_CompanyExpandedOut_":{"properties":{"data":{"$ref":"#/components/schemas/CompanyExpandedOut","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[CompanyExpandedOut]"},"SingleResponse_CompanyRelationshipsOut_":{"properties":{"data":{"$ref":"#/components/schemas/CompanyRelationshipsOut","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[CompanyRelationshipsOut]"},"SingleResponse_CompanySubsidiariesOut_":{"properties":{"data":{"$ref":"#/components/schemas/CompanySubsidiariesOut","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[CompanySubsidiariesOut]"},"SingleResponse_CoverageOut_":{"properties":{"data":{"$ref":"#/components/schemas/CoverageOut","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[CoverageOut]"},"SingleResponse_DeletedOut_":{"properties":{"data":{"$ref":"#/components/schemas/DeletedOut","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[DeletedOut]"},"SingleResponse_FilingOut_":{"properties":{"data":{"$ref":"#/components/schemas/FilingOut","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[FilingOut]"},"SingleResponse_FreshnessOut_":{"properties":{"data":{"$ref":"#/components/schemas/FreshnessOut","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[FreshnessOut]"},"SingleResponse_FundRegistration_":{"properties":{"data":{"$ref":"#/components/schemas/FundRegistration","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[FundRegistration]"},"SingleResponse_GrowthOut_":{"properties":{"data":{"$ref":"#/components/schemas/GrowthOut","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[GrowthOut]"},"SingleResponse_HealthScoreOut_":{"properties":{"data":{"$ref":"#/components/schemas/HealthScoreOut","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[HealthScoreOut]"},"SingleResponse_IdentifiersOut_":{"properties":{"data":{"$ref":"#/components/schemas/IdentifiersOut","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[IdentifiersOut]"},"SingleResponse_InternalControlReport_":{"properties":{"data":{"$ref":"#/components/schemas/InternalControlReport","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[InternalControlReport]"},"SingleResponse_InvestorPositionsData_":{"properties":{"data":{"$ref":"#/components/schemas/InvestorPositionsData","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[InvestorPositionsData]"},"SingleResponse_ProbabilityTableOut_":{"properties":{"data":{"$ref":"#/components/schemas/ProbabilityTableOut","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[ProbabilityTableOut]"},"SingleResponse_SectorStatsOut_":{"properties":{"data":{"$ref":"#/components/schemas/SectorStatsOut","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[SectorStatsOut]"},"SingleResponse_ShareholdingAuditOut_":{"properties":{"data":{"$ref":"#/components/schemas/ShareholdingAuditOut","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[ShareholdingAuditOut]"},"SingleResponse_TrajectoryProbabilitiesOut_":{"properties":{"data":{"$ref":"#/components/schemas/TrajectoryProbabilitiesOut","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[TrajectoryProbabilitiesOut]"},"SingleResponse_UsageOut_":{"properties":{"data":{"$ref":"#/components/schemas/UsageOut","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[UsageOut]"},"SingleResponse_WaitlistJoinOut_":{"properties":{"data":{"$ref":"#/components/schemas/WaitlistJoinOut","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[WaitlistJoinOut]"},"SingleResponse_WatchlistDeleteOut_":{"properties":{"data":{"$ref":"#/components/schemas/WatchlistDeleteOut","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[WatchlistDeleteOut]"},"SingleResponse_WatchlistItemOut_":{"properties":{"data":{"$ref":"#/components/schemas/WatchlistItemOut","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[WatchlistItemOut]"},"SingleResponse_WebhookCreateOut_":{"properties":{"data":{"$ref":"#/components/schemas/WebhookCreateOut","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[WebhookCreateOut]"},"SingleResponse_dict_str__Any__":{"properties":{"data":{"additionalProperties":true,"type":"object","title":"Data","description":"The requested resource object."},"meta":{"$ref":"#/components/schemas/axiora__api__schemas__Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[dict[str, Any]]"},"SnapshotHealthOut":{"properties":{"status":{"type":"string","title":"Status","description":"Read-snapshot state of this instance: 'serving' (reads are answered from the version below), 'disabled' (snapshot reads are off; reads come from the primary DB), or 'unavailable' (enabled, but no snapshot is loaded)."},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version","description":"Version of the snapshot being served; null unless 'serving'."},"source_data_as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Data As Of","description":"Freshness of the data in the snapshot being served."}},"type":"object","required":["status"],"title":"SnapshotHealthOut","description":"The read snapshot an API instance is actually serving.\n\nA result, which data this process holds, not a method. Owner of this shape:\n'axiora.api.read_source.snapshot_health'."},"Source":{"properties":{"doc_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Id","description":"Filing the value came from."},"doc_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Type","description":"Document type code, e.g. '350'."},"filed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filed At","description":"When the filing was submitted (ISO 8601)."},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"The filing on EDINET."},"section":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Section","description":"Section of the filing, where kept."},"quote":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote","description":"Quoted line, where kept."},"read_by":{"anyOf":[{"type":"string","const":"kiri"},{"type":"null"}],"title":"Read By","description":"'kiri' when Kiri read the value."}},"type":"object","title":"Source"},"Subject":{"properties":{"entity":{"type":"string","title":"Entity","description":"Entity ID, e.g. 'company:E00883'."},"role":{"type":"string","title":"Role","description":"Role in the fact, e.g. 'holder' or 'issuer'."}},"type":"object","required":["entity","role"],"title":"Subject"},"SubsidiaryOut":{"properties":{"subsidiary_edinet_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subsidiary Edinet Code","description":"EDINET code if the subsidiary itself files separately. Null for most foreign subs and small private subs."},"name":{"type":"string","title":"Name","description":"Subsidiary's Japanese name as disclosed."},"address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address","description":"Address as written in the filing."},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"ISO 3166-1 alpha-2 derived from address. Null when address is ambiguous or empty."},"capital":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Capital","description":"Capital cell verbatim, e.g. '10,000 百万円'."},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency","description":"ISO 4217 alpha-3 derived from capital. Null when the cell is bare-numeric (no currency token)."},"business":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business","description":"Business / 事業の内容 cell, free text."},"voting_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Voting Pct","description":"Voting % in [0, 100] from 議決権所有割合."},"relationship_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Relationship Type","description":"consolidated_subsidiary / equity_method_affiliate / parent / non_consolidated_subsidiary / other_related / unknown."},"cross_validation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cross Validation","description":"Bidirectional confirmation status. Values: bidirectional_confirmed, parent_only, subsidiary_only, voting_pct_mismatch, subsidiary_stale. Null when no counterparty disclosure exists to confirm against."},"voting_delta_pp":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Voting Delta Pp","description":"Absolute pp difference in voting% when both filers report it; null when only one side reports."},"source_filing":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Filing","description":"EDINET doc_id the disclosure was extracted from. Auditable: every claim references a real filing."},"holdings_filing_count":{"type":"integer","title":"Holdings Filing Count","description":"Number of 大量保有報告書 (5%+ shareholding reports) the entity has filed under its own name. Bidirectional evidence the entity is a real legal entity actively operating.","default":0},"joint_filing_partner_count":{"type":"integer","title":"Joint Filing Partner Count","description":"Number of distinct other entities this subsidiary has co-filed 大量保有報告書 with. High counts signal coordinated group / fund-vehicle structures.","default":0}},"type":"object","required":["name"],"title":"SubsidiaryOut","description":"One subsidiary as disclosed in the parent's 関係会社 table."},"TimeseriesPoint":{"properties":{"fiscal_year":{"type":"integer","title":"Fiscal Year","description":"Fiscal year."},"period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period End","description":"Last day of the fiscal period (ISO 8601)."},"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value","description":"Metric value for this fiscal year. Null if data is unavailable."}},"type":"object","required":["fiscal_year"],"title":"TimeseriesPoint"},"TimeseriesResultOut":{"properties":{"company":{"$ref":"#/components/schemas/CompanyOut","description":"Company details."},"metric":{"type":"string","title":"Metric","description":"Which metric is charted (e.g. 'revenue', 'roe')."},"points":{"items":{"$ref":"#/components/schemas/TimeseriesPoint"},"type":"array","title":"Points","description":"Time series data points ordered by fiscal year."}},"type":"object","required":["company","metric","points"],"title":"TimeseriesResultOut"},"TrajectoryOut":{"properties":{"issuer_security_code":{"type":"string","title":"Issuer Security Code","description":"Securities code of the issuer"},"issuer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Issuer Name","description":"Name of the issuer"},"filer_canonical_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filer Canonical Code","description":"Stable identifier for the filer. Pass it to /investors/{code}/positions to see everything this filer holds. It is the filer's EDINET code when the filer has one, and otherwise names a group of filers that act as a single investor."},"filer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filer Name","description":"Name of the filer"},"latest_holding_ratio_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latest Holding Ratio Pct","description":"Latest observation. The stake this holder reports for itself, as a percentage of the issuer's outstanding shares. On a joint filing (co_holder_count > 1) this is the individual holder's own position, not the group's. Compare with group_ratio_pct for the combined position the 5% obligation attaches to."},"latest_group_ratio_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latest Group Ratio Pct","description":"Latest observation. The combined stake declared for every holder on the same filing, as reported by the filer. Joint-holder accounting permits overlapping positions, so this figure may differ from the sum of the individual holders' stakes, and on a small number of filings it disagrees with them outright. Where the two disagree, holding_ratio_pct is the holder's own reported position and is the figure to screen on. Null when the filing carries no combined total."},"latest_co_holder_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Latest Co Holder Count","description":"On the latest filing. Number of holders declaring together on that filing. 1 means a solo filer."},"delta_90d_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta 90D Pct","description":"Change in this holder's own ratio over 90 days"},"delta_180d_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta 180D Pct","description":"Change in this holder's own ratio over 180 days"},"delta_1y_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta 1Y Pct","description":"Change in this holder's own ratio over 1 year"},"trajectory_type":{"type":"string","title":"Trajectory Type","description":"accumulating, exiting, stable, or new_position"},"streak_length":{"type":"integer","title":"Streak Length","description":"Consecutive filings in current direction"},"velocity_pp_per_month":{"type":"number","title":"Velocity Pp Per Month","description":"Percentage points change per month"},"purpose_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purpose Category","description":"Latest classified purpose"},"first_base_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"First Base Date","description":"Reporting-obligation date (報告義務発生日) of the first report"},"last_base_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Base Date","description":"Reporting-obligation date (報告義務発生日) of the most recent report"},"filing_count":{"type":"integer","title":"Filing Count","description":"Total number of filings"},"points":{"anyOf":[{"items":{"$ref":"#/components/schemas/TrajectoryPointOut"},"type":"array"},{"type":"null"}],"title":"Points","description":"Full trajectory points (only in detail endpoint)"}},"type":"object","required":["issuer_security_code","trajectory_type","streak_length","velocity_pp_per_month","filing_count"],"title":"TrajectoryOut"},"TrajectoryPointOut":{"properties":{"base_date":{"type":"string","format":"date","title":"Base Date","description":"Date the reported position is as of: the reporting-obligation date (報告義務発生日)"},"holding_ratio_pct":{"type":"number","title":"Holding Ratio Pct","description":"The stake this holder reports for itself, as a percentage of the issuer's outstanding shares. On a joint filing (co_holder_count > 1) this is the individual holder's own position, not the group's. Compare with group_ratio_pct for the combined position the 5% obligation attaches to."},"group_ratio_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Group Ratio Pct","description":"The combined stake declared for every holder on the same filing, as reported by the filer. Joint-holder accounting permits overlapping positions, so this figure may differ from the sum of the individual holders' stakes, and on a small number of filings it disagrees with them outright. Where the two disagree, holding_ratio_pct is the holder's own reported position and is the figure to screen on. Null when the filing carries no combined total."},"co_holder_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Co Holder Count","description":"Number of holders declaring together on that filing. 1 means a solo filer."},"delta_pct":{"type":"number","title":"Delta Pct","description":"Change in this holder's own ratio from the previous point, in pp"},"shares_held":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Shares Held","description":"Shares this holder reports for itself. Whole shares. Where the filing states a fraction (depositary receipts converted to shares), the fraction is dropped and the filing is flagged."},"purpose_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purpose Category","description":"Classified purpose"},"report_type":{"type":"string","title":"Report Type","description":"Report type"},"doc_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Id","description":"EDINET document ID (e.g. 'S100ABCD')"}},"type":"object","required":["base_date","holding_ratio_pct","delta_pct","report_type"],"title":"TrajectoryPointOut"},"TrajectoryProbabilitiesOut":{"properties":{"reach_10pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reach 10Pct","description":"P(reaching 10%)"},"reach_20pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reach 20Pct","description":"P(reaching 20%)"},"reach_33pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reach 33Pct","description":"P(reaching 33% blocking minority)"},"exit_within_6m":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Exit Within 6M","description":"P(exiting within 6 months)"},"sample_size":{"type":"integer","title":"Sample Size","description":"Number of historical trajectories in matching bucket","default":0},"confidence_level":{"type":"string","title":"Confidence Level","description":"low, medium, or high","default":"low"},"model_type":{"type":"string","title":"Model Type","description":"Model used: base_rate or coxph","default":"base_rate"}},"type":"object","title":"TrajectoryProbabilitiesOut"},"TranslationOut":{"properties":{"section":{"type":"string","title":"Section","description":"Section key: mda, risk_factors, business_overview, governance, financial_notes, or accounting_policy."},"source_jp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Jp","description":"Original Japanese text. Null if source was not stored."},"text_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text En","description":"English translation of the section. Null if not yet translated."},"token_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Token Count","description":"Approximate token count of the translated output."},"translated_at":{"type":"string","format":"date-time","title":"Translated At","description":"When the translation was generated."}},"type":"object","required":["section","translated_at"],"title":"TranslationOut"},"TranslationSearchResult":{"properties":{"section":{"type":"string","title":"Section","description":"Filing section where the match was found."},"snippet":{"type":"string","title":"Snippet","description":"Text snippet with matching terms highlighted."},"edinet_code":{"type":"string","title":"Edinet Code","description":"EDINET submitter code of the matched company."},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name","description":"Company name in Japanese."},"fiscal_year":{"type":"integer","title":"Fiscal Year","description":"Fiscal year of the matched filing."},"doc_id":{"type":"string","title":"Doc Id","description":"EDINET document ID of the matched filing."},"rank":{"type":"number","title":"Rank","description":"PostgreSQL ts_rank relevance score. Higher means more relevant."}},"type":"object","required":["section","snippet","edinet_code","fiscal_year","doc_id","rank"],"title":"TranslationSearchResult"},"TypesOut":{"properties":{"data":{"additionalProperties":true,"type":"object","title":"Data"},"meta":{"$ref":"#/components/schemas/axiora__api__v2__models__Meta"}},"type":"object","required":["data","meta"],"title":"TypesOut"},"UnwindingScoreboardOut":{"properties":{"company_a_edinet_code":{"type":"string","title":"Company A Edinet Code","description":"EDINET code of company A"},"company_a_securities_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company A Securities Code","description":"Securities code of company A"},"company_a_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company A Name","description":"Name of company A"},"company_a_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company A Name En","description":"Company A name (English) when available"},"company_b_edinet_code":{"type":"string","title":"Company B Edinet Code","description":"EDINET code of company B"},"company_b_securities_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company B Securities Code","description":"Securities code of company B"},"company_b_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company B Name","description":"Name of company B"},"company_b_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company B Name En","description":"Company B name (English) when available"},"a_holds_b_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"A Holds B Pct","description":"A's holding in B (%)"},"b_holds_a_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"B Holds A Pct","description":"B's holding in A (%)"},"a_trajectory_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"A Trajectory Type","description":"A's trajectory type"},"a_velocity_pp_per_month":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"A Velocity Pp Per Month","description":"A's pace (pp/month)"},"a_delta_90d_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"A Delta 90D Pct","description":"A's 90-day change"},"b_trajectory_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"B Trajectory Type","description":"B's trajectory type"},"b_velocity_pp_per_month":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"B Velocity Pp Per Month","description":"B's pace (pp/month)"},"b_delta_90d_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"B Delta 90D Pct","description":"B's 90-day change"},"unwinding_status":{"type":"string","title":"Unwinding Status","description":"mutual_unwinding, one_sided_exit, gradual_decline, monitoring"}},"type":"object","required":["company_a_edinet_code","company_b_edinet_code","unwinding_status"],"title":"UnwindingScoreboardOut"},"UsageAllowanceOut":{"properties":{"companies_granted":{"type":"integer","title":"Companies Granted"},"companies_remaining":{"type":"integer","title":"Companies Remaining"},"open_days":{"type":"integer","title":"Open Days","description":"How long a company stays open from its first query."},"sample_codes":{"items":{"type":"string"},"type":"array","title":"Sample Codes","description":"Securities codes open to every key."},"open_companies":{"items":{"$ref":"#/components/schemas/UsageOpenCompanyOut"},"type":"array","title":"Open Companies"}},"type":"object","required":["companies_granted","companies_remaining","open_days","sample_codes","open_companies"],"title":"UsageAllowanceOut"},"UsageOpenCompanyOut":{"properties":{"edinet_code":{"type":"string","title":"Edinet Code"},"securities_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Securities Code"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"open_until":{"type":"string","title":"Open Until","description":"ISO 8601 instant the company closes."}},"type":"object","required":["edinet_code","open_until"],"title":"UsageOpenCompanyOut"},"UsageOut":{"properties":{"key_prefix":{"type":"string","title":"Key Prefix","description":"First 8 characters of the API key for identification."},"tier":{"type":"string","title":"Tier","description":"Current pricing tier (e.g. 'free', 'pro')."},"requests_today":{"type":"integer","title":"Requests Today","description":"Number of API requests made today.","default":0},"daily_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Daily Limit","description":"Daily request limit for current tier, null if unlimited."},"burst_limit":{"type":"integer","title":"Burst Limit","description":"Max requests per second for current tier.","default":2},"plan":{"type":"string","title":"Plan","description":"The account's plan: 'free', 'pro' (Developer) or 'institutional'.","default":"free"},"allowance":{"anyOf":[{"$ref":"#/components/schemas/UsageAllowanceOut"},{"type":"null"}],"description":"Per-account company access for Free accounts, when offered; null otherwise. A company opens the first time a Developer endpoint is queried for it."}},"additionalProperties":true,"type":"object","required":["key_prefix","tier"],"title":"UsageOut"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VotingResultOut":{"properties":{"edinet_code":{"type":"string","title":"Edinet Code","description":"EDINET submitter code."},"doc_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Id","description":"EDINET doc_id of the extraordinary report (doc_type 180) this voting result was extracted from. Use /filings/{doc_id} to fetch the source filing."},"securities_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Securities Code","description":"TSE securities code."},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name","description":"Company name in Japanese."},"company_name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name En","description":"Company name in English, if held."},"agm_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Agm Date","description":"AGM date (ISO 8601)."},"proposal_number":{"type":"integer","title":"Proposal Number","description":"Proposal number (1-based)."},"proposal_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Proposal Description","description":"Description of the proposal."},"candidate_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Candidate Name","description":"Candidate name (for director/auditor elections)."},"votes_for":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Votes For","description":"Votes in favor."},"votes_against":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Votes Against","description":"Votes against."},"votes_abstain":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Votes Abstain","description":"Abstentions."},"approval_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Approval Pct","description":"Approval percentage (0-100)."},"result":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Result","description":"Vote outcome, normalized to English: 'approved' (可決) or 'rejected' (否決)."}},"type":"object","required":["edinet_code","proposal_number"],"title":"VotingResultOut"},"WaitlistJoinOut":{"properties":{"tier":{"type":"string","title":"Tier"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["tier"],"title":"WaitlistJoinOut"},"WaitlistRequest":{"properties":{"tier":{"type":"string","maxLength":50,"title":"Tier"},"email":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}],"title":"Email"},"name":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Name"},"firm":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Firm"},"message":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Message"},"source":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Source"}},"type":"object","required":["tier"],"title":"WaitlistRequest"},"WatchlistDeleteOut":{"properties":{"deleted":{"type":"boolean","title":"Deleted","default":true}},"type":"object","title":"WatchlistDeleteOut"},"WatchlistItemIn":{"properties":{"entity_type":{"type":"string","pattern":"^(company|investor)$","title":"Entity Type","description":"company or investor"},"entity_code":{"type":"string","maxLength":64,"minLength":1,"title":"Entity Code","description":"Securities code or EDINET code"},"entity_name":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Entity Name","description":"Display name"}},"type":"object","required":["entity_type","entity_code"],"title":"WatchlistItemIn"},"WatchlistItemOut":{"properties":{"id":{"type":"integer","title":"Id"},"entity_type":{"type":"string","title":"Entity Type"},"entity_code":{"type":"string","title":"Entity Code"},"entity_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Name"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","entity_type","entity_code"],"title":"WatchlistItemOut"},"WebhookCreateOut":{"properties":{"id":{"type":"integer","title":"Id","description":"Webhook ID."},"url":{"type":"string","title":"Url","description":"HTTPS URL that receives webhook deliveries."},"events":{"items":{"type":"string"},"type":"array","title":"Events","description":"Subscribed event types (e.g. ['new_filing', 'amendment'])."},"active":{"type":"boolean","title":"Active","description":"Whether the webhook is currently active."},"created_at":{"type":"string","title":"Created At","description":"When the webhook was created (ISO 8601)."},"secret":{"type":"string","title":"Secret","description":"HMAC-SHA256 signing secret (64 hex chars). Shown once."}},"type":"object","required":["id","url","events","active","created_at","secret"],"title":"WebhookCreateOut"},"WebhookOut":{"properties":{"id":{"type":"integer","title":"Id","description":"Webhook ID."},"url":{"type":"string","title":"Url","description":"HTTPS URL that receives webhook deliveries."},"events":{"items":{"type":"string"},"type":"array","title":"Events","description":"Subscribed event types (e.g. ['new_filing', 'amendment'])."},"active":{"type":"boolean","title":"Active","description":"Whether the webhook is currently active."},"created_at":{"type":"string","title":"Created At","description":"When the webhook was created (ISO 8601)."}},"type":"object","required":["id","url","events","active","created_at"],"title":"WebhookOut"},"YoyEntry":{"properties":{"fiscal_year":{"type":"integer","title":"Fiscal Year","description":"Fiscal year."},"period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period End","description":"Last day of the fiscal period (ISO 8601)."},"growth":{"$ref":"#/components/schemas/GrowthMetrics","description":"Year-over-year growth rates for this fiscal year."}},"type":"object","required":["fiscal_year","growth"],"title":"YoyEntry"},"axiora__api__schemas__Meta":{"additionalProperties":true,"type":"object"},"axiora__api__v2__models__Meta":{"properties":{"request_id":{"type":"string","title":"Request Id"},"data_as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data As Of","description":"Source data date of the snapshot served."},"data_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Version","description":"Snapshot version served."},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"resolved_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolved From","description":"The identifier sent, when it was not the canonical id in data.id."},"deprecations":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Deprecations"},"caveats":{"items":{"type":"string"},"type":"array","title":"Caveats"}},"type":"object","required":["request_id"],"title":"Meta"}},"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key as Bearer token (e.g. 'ax_live_...')"}}},"security":[{"BearerAuth":[]}]}