---
title: "サブスクリプション状態・エンタイトルメント・クオータを取得する"
method: GET
path: "/api/v1/billing/subscription"
tags: ["billing"]
---

# サブスクリプション状態・エンタイトルメント・クオータを取得する

`GET /api/v1/billing/subscription`

## Request

- Base URL: `https://app.yukkurigen.com`
- URL: `https://app.yukkurigen.com/api/v1/billing/subscription`
- Auth: HTTP bearer

## Response `200`

サブスクリプション情報

- object
  - `subscription` object
    - `planTier` string
    - `planName` string
    - `priceJpy` integer
    - `status` string
    - `currentPeriodEnd` string, date-time
    - `cancelAtPeriodEnd` boolean
    - `paymentFailed` boolean
  - `entitlements` object
    - `apiAccess` boolean
    - `lifetime` boolean
  - `quotas` object
    - `limits` object
    - `usage` object
    - `extraCredits` integer
    - `totalAvailableCredits` integer
    - `legacyExtraCredits` integer
  - `onboarding` object
    - `completed` boolean

## Other responses

- `401`: 未認証

---

[API](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api.md) · [All operations](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/llms.txt) · [OpenAPI document](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/revisions/ba5f36b016da?raw)
