---
title: "Get Credit History"
method: GET
path: "/api/v1/subscriptions/me/credits"
tags: ["Subscriptions"]
---

# Get Credit History

`GET /api/v1/subscriptions/me/credits`

## Request

- Base URL: `https://api.gemina.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gemina.co/api/v1/subscriptions/me/credits`
- Auth: OAuth 2 (password, token URL `token`)

## Query parameters

- `skip` integer
- `limit` integer
- `meter` 'processing_credits' | 'filetag_credits' | 'all': Query-param filter for credit history endpoints. Superset of :class:`CreditMeter` with an ``all`` sentinel for admin and unified-history views that want both meters interleaved. Read endpoints default to ``processing_credits`` so pre-audit-trail behavior is preserved — mixing meters in a single page confuses ``balance_after`` readings since each meter has its own running balance.

## Response `200`

Successful Response

- CreditTransactionListOutDTO
  - `servedAt` string, date-time
  - `servedAtTimestamp` number
  - `createdAt` string, date-time, nullable
  - `createdAtTimestamp` number, nullable
  - `transactions` CreditTransactionOutDTO[], required
    - `createdAt` string, date-time, nullable
    - `createdAtTimestamp` number, nullable
    - `id` string, uuid, required
    - `type` 'trial_grant' | 'subscription_grant' | 'top_up' | 'usage' | 'expiry' | 'adjustment' | 'reservation' | 'refund' | 'filetag_grant', required
    - `meter` 'processing_credits' | 'filetag_credits', required: Discriminates which balance a credit transaction debits/credits. ``processing_credits`` covers both subscription and enterprise ledgers (distinguished by ``subscription_id IS NULL`` on enterprise rows). ``filetag_credits`` covers the per-user FileTag allowance stored in ``filetag_credit_balances``. Separate meters so reports and history views can filter cleanly without conflating the two accounting pools.
    - `creditsDelta` string, required
    - `creditsBalanceAfter` string, required
    - `referenceId` string, uuid, nullable
    - `referenceFilename` string, nullable
    - `referenceExternalId` string, nullable
    - `description` string, nullable
  - `total` integer: Total number of transactions matching the filter, across all pages. Clients can use this to render 'Page X of Y' without a second count call. Scoped to the same ``meter`` filter as ``transactions`` when one is applied.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/gemina/apis/gemina-api.md) · [All operations](https://skmtc.dev/gemina/apis/gemina-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gemina/apis/gemina-api/revisions/152fd3f6f6ec?raw)