Docs/Reference/Buybacks/List Company Buybacks
GET/v1/companies/{code}/buybacksTier · Developer

List Company Buybacks

Get share buyback reports for a company.

Returns 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.

Path parameters · 1

Variables interpolated into the URL path.

codestringrequired

EDINET code (e.g. 'E02497') or securities code (e.g. '8001')

Query parameters · 5

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

date_fromstring · date | nulloptional

Filter: reporting period ends on or after this date (YYYY-MM-DD)

format date
date_tostring · date | nulloptional

Filter: reporting period ends on or before this date (YYYY-MM-DD)

format date
limitintegeroptional

Results per page

default 50
offsetintegeroptional

Results to skip (ignored when cursor is set)

default 0
cursorstring | nulloptional

Opaque cursor for keyset pagination

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 BuybackOut.

Envelope

dataBuybackOut[]

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>

BuybackOut

edinet_codestring

EDINET code of the company

doc_idstring | null

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_startstring · date

Start date of the reporting period

format date
reporting_period_endstring · date

End date of the reporting period

format date
resolution_typestring

Resolution type: 'shareholder_meeting' or 'board_of_directors'

authorized_sharesinteger | null

Maximum shares authorized for buyback under this resolution

authorized_amountinteger | null

Maximum amount authorized for buyback in JPY

shares_acquired_monthinteger | null

Number of shares acquired during this reporting month

amount_acquired_monthinteger | null

Total amount spent on share acquisitions this month in JPY

cumulative_sharesinteger | null

Total shares acquired since the buyback resolution date

cumulative_amountinteger | null

Total amount spent since the buyback resolution date in JPY

treasury_shares_heldinteger | null

Treasury shares held by the company at end of the reporting period

shares_issuedinteger | null

Total shares issued (including treasury shares)

share_classstring | null

Class of shares (e.g. '普通株式' for common stock)

progress_shares_pctnumber | null

Buyback completion rate by shares: cumulative / authorized * 100

progress_amount_pctnumber | null

Buyback completion rate by amount: cumulative / authorized * 100

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.