---
title: "List credit transactions"
method: GET
path: "/credits/transactions"
tags: ["Credits"]
---

# List credit transactions

`GET /credits/transactions`

## Request

- Base URL: `https://api.emailchaser.com/r`
- URL: `https://api.emailchaser.com/r/credits/transactions`
- Auth: HTTP bearer

Lists the workspace's credit ledger entries, newest first. Optional filters: kind (movement type), reason (what the credits were for), and since/until on the entry time (both inclusive, RFC3339 or YYYY-MM-DD where a bare date means midnight UTC at the start of that day). Without filters the full ledger is returned as before. An entry with free=true was written while the workspace's credits were free: its amount is what the action would have cost, and no credits moved.

## Query parameters

- `limit` integer
- `page` integer
- `kind` string
- `reason` string
- `since` string
- `until` string

## Response `200`

Ledger entries and total count (both reflect the filters)

- ModelsListCreditTransactionsResponse
  - `total` integer
  - `transactions` ModelsCreditTransactionItem[]
    - `amount` integer: Amount is the signed credit delta: negative for spend, positive for grants and refunds.
    - `balanceAfter` integer: BalanceAfter is the available balance immediately after this entry.
    - `createdAt` string
    - `description` string
    - `free` boolean: Free is true for an entry written while this workspace's credits were free. Its amount is what the action would have cost, no credits moved, and balanceAfter is the balance it found.
    - `id` integer
    - `kind` string: Kind is the movement type: grant, topup, reserve, commit, refund, expire or adjustment.
    - `reason` string: Reason is what the credits were spent on or granted for.
    - `reference` string: Reference correlates the entry to what caused it, e.g. 'prospect_search:123'.

## Other responses

- `400`: Invalid filter value
- `401`: Unauthorized - invalid or missing API key
- `500`: Failed to retrieve credit transactions

---

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