플랜 크레딧 목록
QUERY
https://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
}
}
요청
본문
nextstringMaximum 2048 characters
page.next 커서
prevstringMaximum 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_GRANT | YouViCo 지급 |