Beta

購入クレジット一覧

QUERYhttps://api.youvico.com/api/workspace/purchased-credits
レート制限
Default
スコープ
credits:read
ワークスペースロール
所有者管理者

ワークスペースのクレジット購入履歴を新しい順に取得します。期限切れや使い切った購入も含まれます。

例

curl -X QUERY 'https://api.youvico.com/api/workspace/purchased-credits' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{}'
{
  "data": [
    {
      "id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "credit": {
        "id": "9e8d7c6b-5a4f-4e3d-8c2b-1a0f9e8d7c6b",
        "name": "500 Credits"
      },
      "quantity": 2,
      "remainCredits": 600,
      "reservedCredits": 100,
      "usedCredits": 300,
      "expiredAt": "2027-04-02 03:00:00.204518",
      "createdAt": "2026-04-02 03:00:00.204518"
    }
  ],
  "page": {
    "next": null,
    "prev": null
  }
}
リクエスト
curl -X QUERY 'https://api.youvico.com/api/workspace/purchased-credits' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{}'
レスポンス200 OK
{
  "data": [
    {
      "id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "credit": {
        "id": "9e8d7c6b-5a4f-4e3d-8c2b-1a0f9e8d7c6b",
        "name": "500 Credits"
      },
      "quantity": 2,
      "remainCredits": 600,
      "reservedCredits": 100,
      "usedCredits": 300,
      "expiredAt": "2027-04-02 03:00:00.204518",
      "createdAt": "2026-04-02 03:00:00.204518"
    }
  ],
  "page": {
    "next": null,
    "prev": null
  }
}

リクエスト

ボディ

nextstring

Maximum 2048 characters

page.next のカーソル
prevstring

Maximum 2048 characters

page.prev のカーソル

レスポンス

200 OK を返します。

dataarray
クレジットの購入履歴
data[].idstring
購入ID

例: 1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d

data[].creditobject
クレジット商品
data[].quantitynumber
購入数量

例: 2

data[].remainCreditsnumber
予約量を除いた残高

例: 600

data[].reservedCreditsnumber
実行中のAIジョブが予約したクレジット

例: 100

data[].usedCreditsnumber
使用したクレジット

例: 300

data[].expiredAtstring
有効期限

例: 2027-04-02 03:00:00.204518

data[].createdAtstring
購入日時

例: 2026-04-02 03:00:00.204518

pageobject
ページネーションカーソル
page.nextstring?
次のページのカーソル

例: null

page.prevstring?
前のページのカーソル

例: null