Docs/リファレンス/自己株式取得/自己株式取得状況の取得
GET/v1/companies/{code}/buybacksプラン · Developer

自己株式取得状況の取得

企業の自己株券買付状況報告書（EDINET書類タイプ220）を取得します。

月次の自己株式取得状況を新しい順に返します。決議による取得上限、当月取得数・金額、累計取得数・金額、自己株式保有数などを含みます。

パスパラメータ · 1

URLパスに展開される変数。

codestring必須

EDINETコードまたは証券コード

クエリパラメータ · 5

任意のフィルターと修飾子。URLエンコードした ?key=value で渡します。

date_fromstring · date | null任意

開始日（inclusive）

format date
date_tostring · date | null任意

終了日（inclusive）

format date
limitinteger任意

1ページあたりの件数

default 50
offsetinteger任意

スキップする件数（cursor指定時は無視）

default 0
cursorstring | null任意

キーセットページネーション用カーソル

リクエストヘッダー · 1

認証ヘッダー。

Authorizationstring必須

本番用のAPIキー。次の形式で渡します: Bearer ax_live_…

返り値 · 200

標準の { data, meta } エンベロープ。 data は BuybackOut 型の配列です。

エンベロープ

dataBuybackOut[]

結果オブジェクトの配列。

metaMeta

ページネーションとリクエストメタデータ。request_id、data_as_of、ontology_version を含みます。

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

BuybackOut

edinet_codestring

企業のEDINETコード。

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

報告対象期間の開始日。

format date
reporting_period_endstring · date

報告対象期間の終了日。

format date
resolution_typestring

決議種別。'shareholder_meeting'（株主総会決議）または'board_of_directors'（取締役会決議）。

authorized_sharesinteger | null

この決議による取得上限株式数。

authorized_amountinteger | null

この決議による取得上限金額（JPY）。

shares_acquired_monthinteger | null

当月の取得株式数。

amount_acquired_monthinteger | null

当月の取得金額（JPY）。

cumulative_sharesinteger | null

決議日以降の累計取得株式数。

cumulative_amountinteger | null

決議日以降の累計取得金額（JPY）。

treasury_shares_heldinteger | null

期末時点の自己株式保有数。

shares_issuedinteger | null

発行済株式総数。

share_classstring | null

株式の種類（例: '普通株式'）。

progress_shares_pctnumber | null

株式数ベースの取得進捗率（%）。累計÷上限×100。

progress_amount_pctnumber | null

金額ベースの取得進捗率（%）。累計÷上限×100。

エラー

標準のHTTPステータスコードに加え、{ error: { code, message } } エンベロープ内で型付きの error.code を返します。

すべてのエンドポイントは共通の型付きエラーエンベロープ（{ error: { code, message } }）を返します。 全コードの一覧はエラーリファレンスを参照してください。