Credit History
Detailed log of every credit event on your organization.
Org → Credit history shows every credit movement on your account.
Event types
Each event has one of these event_type values:
| Type | Description |
|---|---|
usage | Credit consumption by an activity. |
prepaid_purchase | Prepaid credit top-up via the wallet. |
subscription_credit | Monthly subscription credit allocation. |
billing | Billing event (invoice, charge). |
adjustment | Manual adjustment. |
grant | Admin-granted credits (promotional or goodwill). |
refund | Credit refund. |
reservation | Credits reserved at workflow start to prevent race conditions. |
reservation_released | Reserved credits released on workflow cancel / failure. |
Columns
| Column | Description |
|---|---|
created_at | When the event happened (UTC). |
event_type | See table above. |
source | The system that triggered the event. |
project_id | The project that consumed credits (blank for purchases and grants). |
activity_name | The activity that consumed credits (e.g. a generation workflow). |
credits | Signed credit delta (positive = added, negative = consumed). |
prepaid_balance_after | Prepaid balance immediately after the event. |
period_usage_after | Subscription-period usage count immediately after the event. |
metadata | Event-specific detail. |
Filtering
The credit events endpoint and UI support:
- Date range —
date_from/date_to. - Event type — filter to one or more of the types above.
- Project — focus on events for a single project.
Pagination
Up to 100 events per request via limit / offset on the credit events
API (GET /api/organizations/{orgId}/credit-events).
Wallet vs credits
The wallet holds prepaid balance (purchasable via top-up) and recurring reservations for activities with cost. Subscription credits are granted monthly from your plan and stored alongside the prepaid balance. Both types show up in the credit events log.