---
title: "Get Credits Received"
method: GET
path: "/api/billing/credits-received"
tags: ["billing"]
---

# Get Credits Received

`GET /api/billing/credits-received`

## Request

- Base URL: `https://api.tintin-x.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tintin-x.com/api/billing/credits-received`
- Auth: HTTP bearer

List positive ledger entries (purchases, admin grants, refunds, etc.)
across the caller's accessible wallets.

Aggregates the user's personal wallet AND their team wallet (if any),
so team users see purchases that landed on the team wallet — which is
where credit_purchase actually writes for team members. The
`target.kind` field disambiguates per-row.

Each row carries `action_type` raw (frontend i18n via
`billing.creditSource.{action_type}`) and an optional `agent` block
that's populated when `ledger_transactions.agent_id` is set — refunds
issued in response to a complaint about a specific agent should write
that agent's ID, so a future "refund tied to agent" trail comes for
free without schema changes.

Per-user rate-limited (`usage` bucket — same as the agent-scoped
usage endpoints — heavy refreshing across views counts together).

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- CreditsReceivedResponse: Paginated positive ledger entries across user's accessible wallets.
  - `items` CreditsReceivedItem[], required
    - `id` string, uuid, required
    - `amount_cents` integer, required
    - `action_type` string, nullable, required
    - `target` CreditsReceivedTarget, required: Wallet that received the credits — team or personal.
      - `kind` string, required
      - `id` string, uuid, required
      - `name` string, required
    - `agent` CreditsReceivedAgent, required: Agent attached to a credits entry (refund target).
      - `id` string, uuid, required
      - `name` string, required
    - `created_at` string, date-time, required
    - `metadata` object, nullable, required
  - `has_more` boolean, required
  - `total_credits_received_cents` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tintin-x/apis/tintin-api.md) · [All operations](https://skmtc.dev/tintin-x/apis/tintin-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tintin-x/apis/tintin-api/revisions/8839a8d0a66c?raw)