---
title: "List credit transactions"
method: GET
path: "/v1/customers/{id}/credits/{productId}/transactions"
tags: ["Customers > Credits"]
---

# List credit transactions

`GET /v1/customers/{id}/credits/{productId}/transactions`

Retrieve all credit transactions associated with a credit product.

## Path parameters

- `id` string, required
- `productId` string, required

## Query parameters

- `take` number, nullable
- `skip` number, nullable
- `id` string, nullable
- `type` string, nullable
- `invoice_id` string, nullable
- `created_at` string, nullable

## Response `200`

- PaginatedCreditTransaction
  - `meta` object, required
    - `total` number, required — Total of existing items.
    - `taken` number, required — Number of items returned.
    - `skipped` number, required — Number of items skipped.
  - `data` CreditTransaction[], required — List of CreditTransaction.
    - `id` string, required — Credit transaction ID.
    - `product_id` string, nullable, required — ID of the product related to the transaction.
    - `price` object, nullable, required — Price details related to the transaction.
      - `id` string, required
      - `amount` number, required — Monetary amount. Expressed in currency's smallest unit.
      - `pack_size` number, required
    - `customer_id` string, required — ID of the customer related to the transaction.
    - `payment_method_id` string, nullable, required — ID of the payment method related to the transaction.
    - `invoice_id` string, nullable, required — ID of the invoice related to the transaction.
    - `event_id` string, nullable, required — ID of the event related to the credit consumption.
    - `aggregator_id` string, nullable, required — ID of the aggregator that triggered this usage (for multi-aggregator credits).
    - `expires_at` string, date, nullable, required — Expiration date for credits linked to this transaction
    - `type` 'topup' | 'usage' | 'expiration', required — Type of credit transaction.
    - `source` 'app' | 'portal' | 'api' | 'system', required — Deprecated field, we recommend no longer using it.
    - `amount_excluding_tax` number, nullable, required — Monetary amount. Expressed in currency's smallest unit.
    - `credit_count` number, required — Value of credits related to the transaction.
    - `balance_after` number, required — Credit balance after the transaction.
    - `created_at` string, date-time, required — Credit transaction creation date. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `updated_at` string, date-time, required — Credit transaction last edition date. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.

---

[API](https://skmtc.dev/hyperline/apis/hyperline-api.md) · [All operations](https://skmtc.dev/hyperline/apis/hyperline-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hyperline/hyperline-api/revisions/19fa5f22e39b/schema)