---
title: "クレジット残高"
method: GET
path: "/api/v1/credits"
tags: ["credits"]
---

# クレジット残高

`GET /api/v1/credits`

## Request

- Base URL: `https://app.yukkurigen.com`
- URL: `https://app.yukkurigen.com/api/v1/credits`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Response `200`

残高

- object
  - `total` number
  - `monthly` number
  - `monthlyUsed` number
  - `extra` number

## Other responses

- `401`: 未認証（code: unauthenticated）
- `403`: 権限不足（credits:read / code: insufficient_scope）

## Changes

- **2026-10-20** `ba5f36b016da`: 10 warning, 6 info
  - added the new `already_subscribed` enum value to the `code` response property for the response status `401`
  - added the new `already_subscribed` enum value to the `code` response property for the response status `403`
  - added the new `render_not_paid` enum value to the `code` response property for the response status `401`
  - added the new `render_not_paid` enum value to the `code` response property for the response status `403`
  - …12 more

[Operation history](https://skmtc.dev/yukkurigen/apis/yukkurigen-ai-operated-api/changes/api/v1/credits/get.md)

---

[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)