Beta

플랜 크레딧 목록

QUERYhttps://api.youvico.com/api/workspace/plan-credits
요청 제한
Default
API 권한
credits:read
워크스페이스 역할
소유자관리자

워크스페이스의 플랜 크레딧 지급 내역을 최신순으로 조회합니다. 종료된 지급 내역은 남은 잔액을 그대로 보여 주며, 그 잔액은 더 이상 사용할 수 없습니다.

예시

curl -X QUERY 'https://api.youvico.com/api/workspace/plan-credits' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{}'
{
  "data": [
    {
      "id": "8c4e2f1a-6b3d-4a5e-9f7c-2d1e0b9a8c7f",
      "reason": "MONTHLY_GRANT",
      "remainCredits": 900,
      "reservedCredits": 50,
      "usedCredits": 550,
      "expiredAt": null,
      "createdAt": "2026-04-01 00:00:00.120456"
    }
  ],
  "page": {
    "next": null,
    "prev": null
  }
}
요청
curl -X QUERY 'https://api.youvico.com/api/workspace/plan-credits' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{}'
응답200 OK
{
  "data": [
    {
      "id": "8c4e2f1a-6b3d-4a5e-9f7c-2d1e0b9a8c7f",
      "reason": "MONTHLY_GRANT",
      "remainCredits": 900,
      "reservedCredits": 50,
      "usedCredits": 550,
      "expiredAt": null,
      "createdAt": "2026-04-01 00:00:00.120456"
    }
  ],
  "page": {
    "next": null,
    "prev": null
  }
}

요청

본문

nextstring

Maximum 2048 characters

page.next 커서
prevstring

Maximum 2048 characters

page.prev 커서

응답

200 OK를 반환합니다.

dataarray
플랜 크레딧 지급 내역
data[].idstring
지급 내역 ID

예시: 8c4e2f1a-6b3d-4a5e-9f7c-2d1e0b9a8c7f

data[].reasonstring
지급 사유. 지급 사유 참고

가능한 값: MONTHLY_GRANTBILLING_CYCLESEAT_INCREASEPLAN_CHANGEMIGRATIONOFFERADMIN_GRANT

예시: MONTHLY_GRANT

data[].remainCreditsnumber
예약량을 제외한 잔액

예시: 900

data[].reservedCreditsnumber
진행 중인 AI 작업이 예약한 크레딧

예시: 50

data[].usedCreditsnumber
사용한 크레딧

예시: 550

data[].expiredAtstring?
종료 시각

예시: null

data[].createdAtstring
지급 시각

예시: 2026-04-01 00:00:00.120456

pageobject
페이지 커서
page.nextstring?
다음 페이지 커서

예시: null

page.prevstring?
이전 페이지 커서

예시: null

지급 사유

사유의미
MONTHLY_GRANT결제 기간 시작과 매달 정기 지급
BILLING_CYCLE이전 방식의 정기 지급
SEAT_INCREASE결제 기간 중 좌석 증가
PLAN_CHANGE결제 기간 중 플랜 또는 결제 주기 변경
MIGRATION기존 잔액 이관
OFFER플랜 제공 혜택
ADMIN_GRANTYouViCo 지급