Balance: {balance} credits
Tier: {tier}
{isLowBalance &&
Low balance!}
Next allocation: {new Date(nextAllocationDate).toLocaleDateString()}
);
}
}
```
**API Endpoint:**
```bash theme={null}
GET /api/auth/user
Response:
{
"id": "user123",
"email": "user@example.com",
"credits": {
"balance": 150,
"tier": "free",
"isLowBalance": false,
"nextAllocationDate": "2026-04-01T00:00:00.000Z"
}
}
```
### Low Balance Warning
The system warns you when your balance falls below **20 credits** (configurable).
```typescript theme={null}
// Low balance threshold check
const threshold = 20; // Default
const isLowBalance = balance < threshold;
```
## Transaction History
### Viewing Transactions
All credit transactions are logged with full details:
```typescript theme={null}
interface CreditTransaction {
id: number;
userId: string;
amount: number; // Positive = credit, Negative = debit
balanceAfter: number; // Balance after this transaction
type: 'purchase' | 'allocation' | 'usage' | 'refund' | 'admin_grant' | 'bonus';
feature?: string; // Which feature was used (for 'usage' type)
description: string; // Human-readable description
relatedEntityType?: string; // 'session', 'media', etc.
relatedEntityId?: string; // ID of related entity
metadata?: object; // Additional transaction data
createdAt: timestamp;
}
```
### Transaction Types
| Type | Description | Amount |
| ------------- | ------------------------------ | -------- |
| `purchase` | Bought credits via payment | Positive |
| `allocation` | Monthly tier allocation | Positive |
| `usage` | Used a paid feature | Negative |
| `refund` | Refund for failed operation | Positive |
| `admin_grant` | Admin manually granted credits | Positive |
| `bonus` | Referral or promotional bonus | Positive |
### API Endpoints