Docs/Reference/Compare/Get Peers
GET/v1/companies/{code}/peersTier · Developer

Get Peers

Find peer companies (same sector, similar revenue size).

Returns companies in the same sector, ordered by closest revenue to the target company.

Path parameters · 1

Variables interpolated into the URL path.

codestringrequired

Query parameters · 1

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

limitintegeroptional
default 10

Request headers · 1

Authentication.

Authorizationstringrequired

Production API key. Pass it as Bearer ax_live_…

Returns · 200

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

Envelope

dataPeerOut[]

Array of result objects.

metaMeta

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

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

PeerOut

companyCompanyOut

Peer company details.

fiscal_yearinteger

Fiscal year of the peer data.

revenueinteger | null

Revenue in JPY.

net_incomeinteger | null

Net income in JPY.

roenumber | null

Return on equity for this fiscal year, expressed as a decimal (0.124 = 12.4%). Null when underlying inputs are unavailable.

health_scoreinteger | null

Financial-health composite (0-100). See the health-score documentation for the published methodology. Null when not yet available for this period.

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.