Tier 1 월별 청구 요약 조회

Tier 1 파트너의 관리 플랫폼 전체 월별 청구 요약을 조회합니다. 플랫폼별 기본 요금과 토큰·문서 페이지 초과 요금을 반환합니다. 당월은 기존 예상 청구액 계산 규칙(ESTIMATED), 과거 월은 정산 영수증 기준 확정 금액(FINALIZED)입니다. 모든 금액은 통화를 명시하며, 서로 다른 통화는 합산하지 않고 플랫폼별·전체 totalsByCurrency로 통화별 합계를 구분합니다. 구독이 없거나(당월) 정산 영수증이 없는(과거 월) 플랫폼은 요약에서 제외됩니다. Tier 2 파트너의 요청은 거절합니다.

Responses

🟢200OK

application/json

Tier 1 월별 청구 요약

Bodyapplication/json

Example

{
    "yearMonth": "2026-08",
    "status": "ESTIMATED",
    "platforms": [
        {
            "teamId": "customer-team-1",
            "name": "Customer Platform 1",
            "relationshipType": "DIRECT",
            "viaPartnerTeam": null,
            "planName": "Business",
            "baseFee": {
                "amount": 5000,
                "currency": "JPY"
            },
            "tokenOverage": {
                "amount": 480,
                "currency": "JPY"
            },
            "pageOverage": {
                "amount": 1000,
                "currency": "JPY"
            },
            "totalsByCurrency": {
                "JPY": 6480
            }
        },
        {
            "teamId": "customer-team-2",
            "name": "Customer Platform 2",
            "relationshipType": "VIA_PARTNER",
            "viaPartnerTeam": {
                "id": "tier-2-team",
                "name": "Tier 2 Partner",
                "corporateName": null,
                "partnerTier": 2
            },
            "planName": "Pro",
            "baseFee": {
                "amount": 40,
                "currency": "USD"
            },
            "tokenOverage": {
                "amount": 26,
                "currency": "USD"
            },
            "pageOverage": {
                "amount": 60,
                "currency": "USD"
            },
            "totalsByCurrency": {
                "USD": 126
            }
        }
    ],
    "totalsByCurrency": {
        "JPY": 6480,
        "USD": 126
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden