---
title: "List group balance transactions"
method: GET
path: "/api/v1/groups/transactions/{id}/"
tags: ["Groups"]
---

# List group balance transactions

`GET /api/v1/groups/transactions/{id}/`

Return paginated balance transactions for a group. The authenticated user must be allowed to view the group. Use `search` or `userId` to filter the transaction history.

## Path parameters

- `id` integer, required

## Query parameters

- `search` string
- `userId` integer
- `page` integer
- `size` integer

## Response `200`

The request succeeded and returned paginated group balance transactions.

- object
  - `success` boolean
  - `data` object
    - `transactions` Transaction[]
      - `id` integer — Numeric transaction ID.
      - `type` 1 | 2 | 3 | 4 | 7 | 8 | 9 | 10 | 11 | 12 — | ID | Name | Description | |:---|:-------|------------:| | 1 | TYPE_CHARGE_FOR_CHECK | Charge for check | | 2 | TYPE_CANCEL_CHARGE_FOR_CHECK | Cancel charge for check | | 3 | TYPE_LOAD_BALANCE | Load to balance | | 4 | TYPE_BONUS | Load bonus | | 7 | TYPE_HOLD | Pages on hold | | 8 | TYPE_RELEASE_HOLD | Release hold | | 9 | TYPE_CANCEL_HOLD | Cancel hold | | 10 | TYPE_ADDED_BY_ADMIN | Load by admin | | 11 | TYPE_PAYMENT_LINK | Payment link | | 12 | TYPE_CHARGE_FOR_GRAMMAR_CHECK | Charge for grammar check |
      - `adjustment` Account — Balance counters for a user or group account.
        - `balance` integer, required — Available balance in pages. One page is 275 words.
        - `bonus` integer, required — Available bonus balance in pages. One page is 275 words.
        - `hold` integer, required — Balance on hold. This field is deprecated.
        - `hold_bonus` integer, required — Bonus balance on hold. This field is deprecated.
        - `ai_balance` integer, required — Available AI-check balance.
      - `balance` Account — Balance counters for a user or group account.
        - `balance` integer, required — Available balance in pages. One page is 275 words.
        - `bonus` integer, required — Available bonus balance in pages. One page is 275 words.
        - `hold` integer, required — Balance on hold. This field is deprecated.
        - `hold_bonus` integer, required — Bonus balance on hold. This field is deprecated.
        - `ai_balance` integer, required — Available AI-check balance.
      - `created_at` integer — Transaction creation timestamp in milliseconds.
      - `text_id` integer, nullable — Text check ID associated with the transaction, when applicable.
      - `order` object, nullable — Related order data, or `null` when the transaction is not tied to an order.
      - `parent_id` integer, nullable — Parent transaction or order ID when this transaction reverses or adjusts another transaction.
      - `user` User — User account summary.
        - `id` integer — Numeric user ID.
        - `name` string — User display name.
        - `email` string, email — User email address.
        - `created_at` integer — User creation timestamp in milliseconds.
        - `updated_at` integer — User update timestamp in milliseconds.
        - `is_blocked` boolean — Whether the user account is blocked.
        - `allowed_languages` string[] — Language codes the user can submit for checking.
        - `balance` Account — Balance counters for a user or group account.
          - `balance` integer, required — Available balance in pages. One page is 275 words.
          - `bonus` integer, required — Available bonus balance in pages. One page is 275 words.
          - `hold` integer, required — Balance on hold. This field is deprecated.
          - `hold_bonus` integer, required — Bonus balance on hold. This field is deprecated.
          - `ai_balance` integer, required — Available AI-check balance.
        - `balance_type` integer — User billing/balance type.
        - `avatar` string, nullable — URL of the user avatar image, when available.
        - `sale_role` integer, nullable — Internal sale role for the user, when assigned.
        - `ai_checks_enabled` boolean — Whether AI detection checks are enabled for this user.
        - `is_test` boolean — Whether this is a test account.
        - `is_guest` boolean — Whether this account is a guest account.
        - `is_change_password_needed` boolean — Whether the user must change an autogenerated password.
        - `is_email_verification_needed` boolean — Whether this user should complete email verification.
        - `orders` integer — Number of paid orders for the user.
        - `not_ai_orders` integer — Number of paid non-AI orders for the user.
        - `last_ai_order_paid_days_ago` integer, nullable — Days since the user's most recent paid AI order, or `null`.
  - `pagination` Pagination — Pagination metadata returned by list endpoints.
    - `last` integer — Last available page number.
    - `current` integer — Current page number.
    - `num_items_per_page` integer — Requested page size.
    - `first` integer — First available page number.
    - `page_count` integer — Total number of pages.
    - `total_count` integer — Total number of items across all pages.
    - `page_range` integer — Number of page links included in the current range.
    - `start_page` integer — First page number in the displayed range.
    - `end_page` integer — Last page number in the displayed range.
    - `first_page_in_range` integer — First page number available in the current range.
    - `lastPage_in_range` integer — Last page number available in the current range.
    - `current_item_count` integer — Number of items returned on the current page.
    - `first_item_number` integer — One-based index of the first item on the current page.
    - `last_item_number` integer — One-based index of the last item on the current page.

## Other responses

- `400` — The request is invalid. Check required fields, field formats, and resource ownership.
- `403` — Authentication or authorization failed because the token is missing, invalid, blocked, or not allowed to access the resource.

---

[API](https://skmtc.net/plagiarismcheck/apis/plagiarismcheck-org-api.md) · [All operations](https://skmtc.net/plagiarismcheck/apis/plagiarismcheck-org-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/plagiarismcheck/plagiarismcheck-org-api/versions/034b4999350e/schema)
