Docs/Reference/Ownership/Get Company Capital Allocation
GET/v1/companies/{code}/capital-allocationTier · Institutional

Get Company Capital Allocation

How this company has been deploying its capital.

Classifies the issuer into one of four buckets based on the ratio of buybacks + dividends vs reinvestment (capex + R&D + M&A) over recent fiscal years:

- returner: heavily prioritises buybacks and dividends - reinvestor: heavily prioritises reinvestment - mixed: meaningfully both - hoarder: neither; cash builds on balance sheet

Includes the underlying ratios and the fiscal year the classification was computed on.

Path parameters · 1

Variables interpolated into the URL path.

codestringrequired

Securities or EDINET code

Request headers · 1

Authentication.

Authorizationstringrequired

Production API key. Pass it as Bearer ax_live_…

Returns · 200

The standard { data, meta } envelope. data contains CapitalAllocationOut.

Envelope

dataCapitalAllocationOut

A single result object.

metaMeta

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

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

CapitalAllocationOut

edinet_codestring

EDINET code

securities_codestring | null

Securities code

namestring | null

Company name

sectorstring | null

Sector

fiscal_yearinteger | null

Fiscal year analyzed

classificationstring

Returner, Hoarder, Reinvestor, Mixed, or Insufficient Data

fcfnumber | null

Free cash flow (JPY)

total_returnsnumber | null

Dividends + buybacks (JPY)

return_rationumber | null

Total returns / FCF

capex_revenue_rationumber | null

Capex / Revenue ratio

Errors

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

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