---
title: "List transactions"
method: GET
path: "/v1/account/transactions"
tags: ["Account"]
---

# List transactions

`GET /v1/account/transactions`

List transaction history for the authenticated user.

**Authentication:** API Key required (`x-api-key` header) or JWT token

**Pagination:** Use `limit` and `offset` query parameters.

**Transaction types:**
- `PDFGEN`: PDF generation (consumes credits)
- `REFUND`: Credit refund (on failed generation)
- `PURCHASE`: Credit purchase
- `BONUS`: Bonus credits

**Credits field:**
- Positive value = credits consumed
- Negative value = credits added

**No credits consumed:** This is a read-only endpoint.

**Rate Limits:** 60 requests/min (free), 120 requests/min (paid). Headers included in response.

## Query parameters

- `limit` integer — Number of records to return
- `offset` integer — Number of records to skip

## Response `200`

Transaction history

- TransactionsResponse — Response for transactions list endpoint
  - `transactions` Transaction[], required
    - `transaction_ref` string, required — Unique transaction reference (UUID)
    - `transaction_type` string, required — Transaction type: PDFGEN, PURCHASE, REFUND, BONUS
    - `template_id` string, nullable — Template short ID (for PDFGEN)
    - `exec_tm` integer, nullable — Execution time in milliseconds
    - `credits` integer, required — Credits consumed (positive) or added (negative)
    - `created_at` string, required — ISO 8601 timestamp
  - `total` integer, required — Total number of transactions
  - `limit` integer, required — Number of records returned
  - `offset` integer, required — Number of records skipped

## Other responses

- `403` — Invalid or missing API key
- `422` — Validation Error

---

[API](https://skmtc.net/pdftemplateapi/apis/templatefox-api.md) · [All operations](https://skmtc.net/pdftemplateapi/apis/templatefox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pdftemplateapi/templatefox-api/revisions/5673fc0d5fad/schema)