Docs/Reference/Relationships/Get Company Relationships
GET/v1/companies/{code}/relationshipsTier · Institutional

Get Company Relationships

Get unified relationship graph for a company.

Returns board members, major shareholders, holdings by this entity, board interlocks (directors serving on multiple boards), and cross-holdings.

Path parameters · 1

Variables interpolated into the URL path.

codestringrequired

EDINET code (e.g. 'E02144') or securities code (e.g. '7203')

Query parameters · 1

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

fiscal_yearinteger | nulloptional

Fiscal year for board data. Defaults to latest.

Request headers · 1

Authentication.

Authorizationstringrequired

Production API key. Pass it as Bearer ax_live_…

Returns · 200

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

Envelope

dataCompanyRelationshipsOut

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>

CompanyRelationshipsOut

companyobject

Company identifiers

board_membersBoardMemberOut[]
major_shareholdersRelationshipShareholderOut[]
holdingsRelationshipHoldingOut[]
board_interlocksBoardInterlockOut[]
cross_holdingsCrossHoldingOut[]
register_shareholdersRegisterShareholdersOut | null

Issuer-reported fiscal-year-end register (latest year, top holders including sub-5%). Distinct from major_shareholders, which is derived from event-driven 5% filings.

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.