# Credit History (/docs/organizations/credit-history)



**Org → Credit history** shows every credit movement on your account.

## Event types [#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 [#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 [#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 [#pagination]

Up to 100 events per request via `limit` / `offset` on the credit events
API (`GET /api/organizations/{orgId}/credit-events`).

## Wallet vs credits [#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.