---
title: "List balance history for the current account"
method: GET
path: "/profile/activities/balance-logs"
tags: ["Profile"]
---

# List balance history for the current account

`GET /profile/activities/balance-logs`

## Request

- Base URL: `https://api.leakradar.io`
- URL: `https://api.leakradar.io/profile/activities/balance-logs`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/leakradar/apis/leakradar-io-api/docs/profile/activities/balance-logs/get.ts> (a function with typed inputs; its response is checked against the schema)

Return a paginated list of balance log entries (points and GB changes) for the authenticated user's account.

Team members see the owner's aggregated logs.

## Query parameters

- `page` integer: Page number (starts at 1).
- `page_size` integer: Items per page.
- `order_by` string: Field to sort by.
- `order_dir` string: Sort direction: asc or desc.
- `q` string, nullable
- `kind` 'points' | 'gb', nullable
- `direction` 'credit' | 'debit', nullable
- `date_from` string, date, nullable
- `date_to` string, date, nullable

## Response `200`

Balance logs returned successfully.

- PaginatedResponseBalanceLogItem
  - `items` BalanceLogItem[], required: List of items for the current page.
    - `id` integer, required: Balance log entry ID.
    - `user_id` integer, required: User ID.
    - `user_email` string, nullable: User email address.
    - `kind` string, required: Type of balance change (e.g. unlock, topup, subscription).
    - `delta_total` integer, required: Total points change (positive = credit, negative = debit).
    - `delta_subscription` integer, required: Subscription points portion of the change.
    - `delta_extra` integer, required: Extra points portion of the change.
    - `reason` string, nullable: Human-readable reason for the balance change.
    - `metadata` object, nullable: Additional metadata about the operation.
    - `created_at` string, date-time, required: Date of the balance change.
  - `total` integer, required: Total number of matching items.
  - `page` integer, required: Current page number.
  - `page_size` integer, required: Number of items per page.
  - `blacklisted_value` string, nullable: If a filter value matched a blacklist entry, this field contains the matched value.

## Other responses

- `401`: Authentication required.
- `404`: Page out of range.
- `422`: Validation Error

## Changes

- **2026-09-10** `d6188beb217d`: 5 info
  - added the new optional `query` request parameter `date_from`
  - added the new optional `query` request parameter `date_to`
  - added the new optional `query` request parameter `direction`
  - added the new optional `query` request parameter `kind`
  - …1 more
- **2026-09-01** `82a99c608e1a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/leakradar/apis/leakradar-io-api/changes/profile/activities/balance-logs/get.md)

---

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