---
title: "List account-wide credit activity for a customer"
method: GET
path: "/v1/sdk/credits/activity"
tags: ["Credits"]
---

# List account-wide credit activity for a customer

`GET /v1/sdk/credits/activity`

## Request

- Base URL: `https://api.solvapay.com`
- URL: `https://api.solvapay.com/v1/sdk/credits/activity`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/solvapay/apis/solvapay-rest-api/docs/v1/sdk/credits/activity/get.ts> (a function with typed inputs; its response is checked against the schema)

Every credit event on the customer account, newest first, including other products and top-ups. Credits are shared, so the balance only makes sense account-wide.

## Query parameters

- `customerRef` string, required
- `limit` number

## Response `200`

Account-wide credit ledger page.

- CreditActivityResponseDto
  - `entries` CreditActivityEntryDto[], required
    - `amount` number, required: Signed credit units on the USD peg (100 credits = 1 USD cent)
    - `balance` number, required: Running credit balance after this event
    - `productName` string: Product display name when the event is product-scoped
    - `productRef` string: Product reference when the event is product-scoped
    - `reason` string: Machine-readable reason when the ledger stored one
    - `timestamp` string, required: ISO-8601 timestamp
    - `type` 'USAGE' | 'TOPUP' | 'GRANT' | 'REFUND' | 'ADJUSTMENT', required: Ledger event type
  - `hasMore` boolean, required: True when more events exist beyond this page

## Other responses

- `400`: customerRef is required, or limit is invalid
- `404`: Customer not found

## Changes

- **2026-09-18** `aacdf8ae7816`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/solvapay/apis/solvapay-rest-api/changes/v1/sdk/credits/activity/get.md)

---

[API](https://skmtc.dev/solvapay/apis/solvapay-rest-api.md) - [All operations](https://skmtc.dev/solvapay/apis/solvapay-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/solvapay/apis/solvapay-rest-api/revisions/bd3a1cb8cb52?raw)