---
title: "List wallet transactions"
method: GET
path: "/wallet/transactions"
tags: ["billingWallet"]
---

# List wallet transactions

`GET /wallet/transactions`

Returns wallet transactions newest first. Use page and per_page for paginated results, or limit for an unpaginated recent subset.

## Query parameters

- `limit` integer
- `page` integer
- `per_page` integer

## Headers

- `Authorization` string, required

## Response `200`

Wallet transactions and optional pagination metadata.

- BillingTransactionsResponse
  - `transactions` BillingWalletTransaction[], required
    - `id` integer
    - `transaction_type` 'credit_purchase' | 'trial_credit' | 'promotion_bonus' | 'usage_deduction' | 'refund' | 'manual_adjustment' | 'subscription_renewal_credit' | 'promotional_credit_adjustment' | 'plan_change' | 'plan_subscription' | 'subscription_cancellation'
    - `amount_cents` number, double — Positive for credits and negative for debits.
    - `balance_after_cents` number, double
    - `description` string, nullable
    - `metadata` object
    - `created_at` string, date-time
  - `pagination` BillingPagination
    - `page` integer
    - `per_page` integer
    - `total_count` integer
    - `total_pages` integer

## Other responses

- `400` — The request could not be parsed or contains invalid parameters.
- `401` — A valid API key was not provided.
- `403` — The API key owner cannot manage billing, or the Billing API is unavailable for the customer's billing arrangement.
- `500` — An unexpected billing error occurred.

---

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