---
title: "アカウント情報取得"
method: GET
path: "/v1/account/info"
tags: ["アカウント"]
---

# アカウント情報取得

`GET /v1/account/info`

## Request

- Base URL: `https://api.rakkokeyword.com`
- URL: `https://api.rakkokeyword.com/v1/account/info`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/rakkokeyword/apis/rakkokeyword/docs/v1/account/info/get.ts> (a function with typed inputs; its response is checked against the schema)

アカウント情報取得。
利用者自身の契約プランとクレジットの状況を取得する。

契約プラン・契約日・有効期限日・自動更新設定と、クレジット残高・残高の内訳・オートチャージ設定・次回付与予定・追加クレジットの単価を返す。
機能を実行する前に、残高が足りるか・どのプランで利用しているかを確認できる。

クレジットは消費しない。

## Response `200`

取得成功

- AccountResponseDto
  - `result` boolean, required: API 呼び出しの成否。正常時は true、エラー時は false。
  - `meta` object, required: リクエストに関するメタ情報（課金・消費リソースなど）
    - `consumedCredit` number, required: このリクエストで消費されたクレジット数。本エンドポイントは常に 0。
  - `data` object, required: アカウントの状況
    - `rakkoId` integer, required: ラッコID。
    - `contract` object, required: 契約の状況
      - `planKey` 'STANDARD' | 'PRO' | 'ENTERPRISE', required: 契約プランの識別子。
      - `planName` string, required: 契約プランの名称。
      - `contractDate` string, required: 契約日。
      - `dueDate` string, required: 契約の有効期限日。この日まで利用できる。
      - `autoUpdate` object, required: 自動更新の設定
        - `enabled` boolean, required: 自動更新の設定状況。有効なら true。
        - `months` integer, nullable, required: 自動更新の更新期間（月数）。自動更新が無効な場合や、更新期間が設定されていない場合は null。
        - `renewalDate` string, nullable, required: 自動更新の初回試行日。有効期限日の 5 日前。自動更新が無効な場合は null。
    - `credit` object, required: クレジットの状況
      - `balance` number, required: 利用できるクレジットの残高。有効期限内の残高の合計。
      - `balanceDetails` object[], required: 有効期限内の残高の内訳。有効期限日の昇順。
        - `expirationDate` string, required: この残高の有効期限日。
        - `grantTypeLabel` string, required: 付与の名目。月次付与 / 追加購入（手動）/ 追加購入（自動）/ アップグレード引継 / プラン移行 / 週次付与 / じゃんけん戦利品のいずれか。
        - `remainingAmount` number, required: この付与分の残数。使い切った付与分は 0。
      - `autoCharge` object, required: オートチャージの設定
        - `enabled` boolean, required: オートチャージの設定状況。有効なら true。
        - `thresholdAmount` integer, nullable, required: オートチャージが発動する残数。オートチャージが無効な場合は null。
        - `purchaseAmount` integer, nullable, required: オートチャージで購入するクレジット数。オートチャージが無効な場合は null。
      - `monthlyGrant` object, required: 月次付与の予定
        - `nextGrantDate` string, nullable, required: 次回のクレジット付与日。当日の 0 時に付与される。付与予定がない場合は null。
        - `nextGrantAmount` integer, nullable, required: 次回付与されるクレジット数。付与予定がない場合や、プランに付与数が設定されていない場合は null。
      - `additionalCreditUnitPrice` integer, nullable, required: 追加クレジットの単価。100 クレジットあたりの価格（円・税込）。プランに単価が設定されていない場合は null。
  - `errors` string[], required: エラーメッセージの配列。正常時は空配列。

## Other responses

- `403`: 認証エラー
- `429`: レート制限超過
- `500`: Internal Server Error
- `503`: Service Unavailable - メンテナンス中、データベース接続エラーなど

## Changes

- **2026-11-10** `9a79a4653ee1`: 1 info
  - removed the `LIGHT` enum value from the `data/contract/planKey` response property for the response status `200`
- **2026-10-27** `084bc7d3e4de`: 2 breaking, 2 info
  - the response property `data/contract/autoUpdate/renewalDate` became nullable for the status `200`
  - the response property `data/credit/monthlyGrant/nextGrantDate` became nullable for the status `200`
  - response property `data/contract/autoUpdate/renewalDate` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `data/credit/monthlyGrant/nextGrantDate` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
- **2026-09-24** `6b6ac57e0064`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rakkokeyword/apis/rakkokeyword/changes/v1/account/info/get.md)

---

[API](https://skmtc.dev/rakkokeyword/apis/rakkokeyword.md) - [All operations](https://skmtc.dev/rakkokeyword/apis/rakkokeyword/llms.txt) - [OpenAPI document](https://skmtc.dev/rakkokeyword/apis/rakkokeyword/revisions/b244735ba825?raw)