{"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 (cross-holdings, activist campaigns, capital-allocation buckets) declare themselves via `meta.caveats` and expose `meta.data_as_of` for freshness.\n\n**2. Versioned interpretation** — Every response carries `meta.computation_version` (formulas, thresholds) and `meta.ontology_version` (field labels, units). Pin against a version when correlating historical responses. Per-row decisions that depend on a classifier (purpose classification, English name resolution) carry their own opaque `*_version` token you can pin to.\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 `/ontology/fields` for the full data dictionary, `/freshness` for current ingest lag, and `/coverage` for per-metric completeness.","version":"0.3.1"},"paths":{"/v1/health":{"get":{"tags":["health"],"summary":"Health","description":"Shallow health check — confirms the process is alive.","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.","operationId":"health_deep_v1_health_deep_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeepHealthCheckOut"}}}}}}},"/v1/freshness":{"get":{"tags":["freshness"],"summary":"Get Freshness","description":"How fresh is the data right now.\n\nReturns the timestamp of the last successful EDINET ingest, the\nmost recent run status, the lag in minutes since that ingest, and\nwhen the next poll is scheduled. Use this to decide whether to\ntrust a near-realtime answer (low lag) or to 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, securities code, or EDINET code.\n\nReturns results ranked by match quality: exact code matches first,\nthen prefix matches, then substring matches.","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_CompanyOut_"}}}},"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.","operationId":"get_company_v1_companies__code__get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":20,"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.","title":"Expand"},"description":"Comma-separated sub-resources to include: financials, ratios, growth, peers, segments, translations, health_score. Use 'all' for everything."},{"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), semi-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.","operationId":"get_financials_v1_companies__code__financials_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":20,"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 (semi-annual), 140 (quarterly)","default":"120","title":"Doc Type"},"description":"Filing type: 120 (annual), 130 (semi-annual), 140 (quarterly)"},{"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.","operationId":"get_ratios_v1_companies__code__ratios_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":20,"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.","operationId":"get_growth_v1_companies__code__growth_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":20,"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":20,"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":"Get cross-reference identifiers (ISIN, LEI, Bloomberg ticker, etc.) for a company.","operationId":"get_identifiers_v1_companies__code__identifiers_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":20,"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":{"get":{"tags":["filings"],"summary":"List Filings","description":"List EDINET filings, filtered by date / company / doc_type.\n\nEach row carries `doc_id`, `doc_type` (e.g. 120 annual,\n130 semi-annual, 140 quarterly, 150 extraordinary, 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.","operationId":"list_filings_v1_filings_get","parameters":[{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start date (inclusive)","title":"Date From"},"description":"Start date (inclusive)"},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End date (inclusive)","title":"Date To"},"description":"End date (inclusive)"},{"name":"company_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":20},{"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"}],"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 Postgres relevance (tsvector/tsquery), 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":20,"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.\nRequires institutional tier.","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.\nRequires institutional tier.","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":20,"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), ordered newest first. Each record shows authorized limits, shares acquired 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":20,"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 first. Use this to monitor buyback activity across the market or within a 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.","operationId":"get_buyback_analysis_endpoint_v1_companies__code__buybacks_analysis_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":20,"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/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":20,"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 + alternative for both, the source filing reference,\nand a stable classifier version stamp consumers can pin to.\n\nUse this when a hard label isn't enough — when you need to cite\na prediction, audit a disagreement, or replay the same query\nlater against the same classifier state.","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."}],"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":20,"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":"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":20,"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":20,"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/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":20,"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":30,"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.","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":"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).","operationId":"list_company_signals_v1_companies__code__ownership_signals_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":20,"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":"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\nBacked by a pre-computed table when fresh; falls back to live\ncomputation otherwise. Pin against `meta.computation_version`\nto detect when the underlying model is rebuilt.","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":20,"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":20,"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, market-wide.\n\nReturns every reciprocal stake (持ち合い株) where Company A holds\n≥5% of Company B AND Company B holds ≥5% of Company A. Sorted by\ncombined holding ratio so the largest mutual stakes appear first.\n\nUse this as the inventory of cross-holdings that exist; pair it\nwith `/ownership/unwinding-scoreboard` to see which of those are\nactively 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, with both holding percentages and the\nrelationship type. Use to map a company's cross-holding network\nbefore reading the unwinding scoreboard — pairs declining here\nwill appear there with velocity attached.","operationId":"get_company_network_v1_companies__code__ownership_network_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":20,"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":20,"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 either the\nfiler's stated holding purpose is classified `activist`, OR we've\ndetected `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":20,"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":20,"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":20,"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"}],"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.","operationId":"get_forecasts_v1_companies__code__forecasts_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","maxLength":20,"title":"Code"}},{"name":"years","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":5,"title":"Years"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListResponse_EarningsForecastOut_"}}}},"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":20,"title":"Code"}}],"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":20,"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/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":20,"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":20,"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":20,"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. Pin against\na known version when correlating historical responses with\ncurrent data — `meta.ontology_version` on every data response\nmatches what this endpoint returns.","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":{"ActivistCampaignOut":{"properties":{"filer_code":{"type":"string","title":"Filer Code","description":"Activist filer EDINET code"},"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},"campaign_intensity":{"type":"string","title":"Campaign Intensity","description":"Campaign intensity: high, medium, low","default":"low"}},"type":"object","required":["filer_code","issuer_security_code","trajectory_type","streak_length","filing_count"],"title":"ActivistCampaignOut"},"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,"minimum":1,"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"},"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"},"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."},"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."},"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"}},"type":"object","required":["company"],"title":"CompanyRelationshipsOut"},"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"}},"type":"object","required":["raw_key","key"],"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":{"type":"number","title":"A Holds B Pct","description":"A's holding ratio in B (%)"},"b_holds_a_pct":{"type":"number","title":"B Holds A Pct","description":"B's holding ratio in A (%)"},"min_pct":{"type":"number","title":"Min Pct","description":"The smaller of the two reciprocal holdings (%). Useful as a single sortable measure of pair tightness."},"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":"mutual or asymmetric"},"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","a_holds_b_pct","b_holds_a_pct","min_pct","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"}],"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"}},"type":"object","title":"EarningsForecastOut"},"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 決算短信 PDF 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"},"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"},"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"},"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=semi-annual, 140=quarterly, 150=extraordinary."},"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 (%). E.g. 30.0 = 30%. Dividends / NI."},"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."},"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"},"FreshnessOut":{"properties":{"last_ingest_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Ingest At","description":"Timestamp of the last successful EDINET ingest (ISO 8601)."},"last_ingest_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Ingest Status","description":"Status of the last ingest ('ok' or 'error')."},"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 last successful ingest. 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"},"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"},"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'."}},"type":"object","required":["status"],"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"},"IdentifiersOut":{"properties":{"edinet_code":{"type":"string","title":"Edinet Code","description":"EDINET submitter code (e.g. 'E02144')."},"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)."},"bloomberg_ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bloomberg Ticker","description":"Bloomberg ticker symbol."},"jpx_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jpx Code","description":"JPX issuer code."},"match_method":{"type":"string","title":"Match Method","description":"How identifiers were matched (e.g. 'securities_code', 'edinet_api')."},"confidence":{"type":"number","title":"Confidence","description":"Match confidence (0.0 to 1.0)."},"matched_at":{"type":"string","format":"date-time","title":"Matched At","description":"When the identifiers were last matched."}},"type":"object","required":["edinet_code","match_method","confidence","matched_at"],"title":"IdentifiersOut"},"InvestorInfo":{"properties":{"edinet_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Edinet Code"},"name_jp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name Jp"},"name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En"},"total_positions":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Positions"},"active_positions":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Active Positions"}},"type":"object","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"}},"type":"object","title":"InvestorPositionsData"},"InvestorSearchResult":{"properties":{"edinet_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Edinet Code"},"name_jp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name Jp"},"name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En"},"positions":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Positions"}},"type":"object","title":"InvestorSearchResult"},"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"}},"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/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/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/Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[BulkFinancialOut]"},"ListResponse_BuybackOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/BuybackOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/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/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/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/Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[CompanyOut]"},"ListResponse_CompareResultOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/CompareResultOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/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/Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[CrossHoldingOut]"},"ListResponse_EarningsForecastOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/EarningsForecastOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/schemas/Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[EarningsForecastOut]"},"ListResponse_EarningsSignalOut_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/EarningsSignalOut"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/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/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/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/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/Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[FinancialOut]"},"ListResponse_InvestorSearchResult_":{"properties":{"data":{"items":{"$ref":"#/components/schemas/InvestorSearchResult"},"type":"array","title":"Data","description":"Array of result objects."},"meta":{"$ref":"#/components/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/Meta","description":"Pagination and request metadata."}},"type":"object","required":["data","meta"],"title":"ListResponse[WebhookOut]"},"Meta":{"properties":{"total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total","description":"Total number of matching records (list endpoints only)."},"limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Limit","description":"Maximum records returned per page."},"offset":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Offset","description":"Number of records skipped (offset-based pagination)."},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Opaque cursor for the next page (keyset pagination). Null on the last page."},"request_id":{"type":"string","title":"Request Id","description":"Unique request identifier for tracing and support (e.g. 'req_abc123')."},"computation_version":{"type":"string","title":"Computation Version","description":"Version string for computation logic (formulas, thresholds, derived metrics). Bumped when changes affect computed values. Format: YYYY.MM.N","default":"2026.04.1"},"ontology_version":{"type":"string","title":"Ontology Version","description":"Semantic version of the field/unit interpretation layer used to produce the values in this response. Bumped on breaking changes to field labeling, unit handling, or validation rules. Pin against a known version, detect drift, or trigger re-ingest after a bump. Semver.","default":"2.1.0"},"data_as_of":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Data As Of","description":"Timestamp of the last successful data ingest from EDINET. Null if not yet resolved. ISO 8601 with timezone."},"caveats":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Caveats","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."}},"additionalProperties":true,"type":"object","required":["request_id"],"title":"Meta"},"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"},"OwnershipChartPointOut":{"properties":{"base_date":{"type":"string","format":"date","title":"Base Date","description":"Date of the filing"},"holding_ratio_pct":{"type":"number","title":"Holding Ratio Pct","description":"Holding ratio as percentage"},"delta_pct":{"type":"number","title":"Delta Pct","description":"Change from previous point in pp","default":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":{"type":"string","title":"Filer Code","description":"EDINET code of the filer"},"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":["filer_code","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":"Canonical EDINET code of the filer"},"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 holding ratio"},"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":"Date of most recent filing"},"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":"Canonical EDINET code of the filer"},"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":"Holding ratio at signal time"},"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"},"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":"Holding ratio (%)"},"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 holding ratio (%)"},"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, alternative_label + probability, validated, 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":"Stable token identifying the classifier state that produced realtime.predicted_category. Pin to a specific value for stable replay."}},"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 model's calibrated\nconfidence + alternative, the source filing reference, and the\nclassifier version stamp into one self-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"},"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"},{"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."},"purpose_confidence":{"anyOf":[{"type":"number","maximum":1,"minimum":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_alternative_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purpose Alternative Label","description":"Second-most-likely category for this row. Inspect when purpose_confidence is moderate to see the runner-up."},"purpose_alternative_probability":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Purpose Alternative Probability","description":"Probability of purpose_alternative_label."},"purpose_validated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Purpose Validated","description":"True when the predicted category passed cross-check consistency. False marks borderline rows worth review."},"purpose_classifier_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purpose Classifier Version","description":"Classifier version stamp at the time this row was labeled. Pin to a specific value for stable replay."},"purpose_retrospective_label":{"anyOf":[{"type":"string"},{"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":"Base date of the report"},"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/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/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/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/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/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/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/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/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/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/Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[FreshnessOut]"},"SingleResponse_GrowthOut_":{"properties":{"data":{"$ref":"#/components/schemas/GrowthOut","description":"The requested resource object."},"meta":{"$ref":"#/components/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/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/Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[IdentifiersOut]"},"SingleResponse_InvestorPositionsData_":{"properties":{"data":{"$ref":"#/components/schemas/InvestorPositionsData","description":"The requested resource object."},"meta":{"$ref":"#/components/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/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/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/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/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/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/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/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/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/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/Meta","description":"Request metadata."}},"type":"object","required":["data","meta"],"title":"SingleResponse[dict[str, Any]]"},"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 validation outcome from joining this edge against the subsidiary's own annual: bidirectional_confirmed, parent_only, subsidiary_only, voting_pct_mismatch. Null when not yet validated."},"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":{"type":"string","title":"Filer Canonical Code","description":"Canonical EDINET code of the filer"},"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 holding ratio"},"delta_90d_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta 90D Pct","description":"Change in holding ratio over 90 days"},"delta_180d_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta 180D Pct","description":"Change in holding ratio over 180 days"},"delta_1y_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Delta 1Y Pct","description":"Change in holding 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":"Date of first filing"},"last_base_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Base Date","description":"Date of most recent filing"},"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","filer_canonical_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 of the shareholding report"},"holding_ratio_pct":{"type":"number","title":"Holding Ratio Pct","description":"Holding ratio as percentage"},"delta_pct":{"type":"number","title":"Delta Pct","description":"Change from previous point in pp"},"shares_held":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Shares Held","description":"Shares held"},"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."},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"Axiora translation engine variant that produced this row. Stable, opaque label — pin to it for reproducibility. Known values: `axiora-annual-v3.0.0-flash` (current annual-report pipeline), `axiora-annual-v2-flash` / `axiora-annual-v2-pro` (legacy v2), `axiora-v1` (legacy bulk translations)."},"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"},"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"},"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}},"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."},"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 result: '可決' (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":20,"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"}},"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key as Bearer token (e.g. 'ax_live_...')"}}},"security":[{"BearerAuth":[]}]}