---
title: "Get Customer Balance Transactions"
method: GET
path: "/v1/shops/{shopId}/customers/{customerId}/balance-transactions"
tags: ["Customers"]
---

# Get Customer Balance Transactions

`GET /v1/shops/{shopId}/customers/{customerId}/balance-transactions`

## Request

- Base URL: `https://api.sellauth.com`
- URL: `https://api.sellauth.com/v1/shops/{shopId}/customers/{customerId}/balance-transactions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sellauth/apis/sellauth-api/docs/v1/shops/:shopId/customers/:customerId/balance-transactions/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the balance transactions for a customer in a shop.

## Response `200`

- object
  - `current_page` integer
  - `data` object[]
    - `id` string
    - `type` string
    - `description` string
    - `shop_customer_id` integer
    - `invoice_id` string, nullable
    - `amount` string
    - `currency` string
    - `created_at` string
    - `invoice` string, nullable
  - `first_page_url` string
  - `from` integer
  - `last_page` integer
  - `last_page_url` string
  - `links` object[]
    - `url` string, nullable
    - `label` string
    - `page` string, nullable
    - `active` boolean
  - `next_page_url` string, nullable
  - `path` string
  - `per_page` integer
  - `prev_page_url` string, nullable
  - `to` integer
  - `total` integer

## Changes

- **2026-11-02** `ff0d59c98d7a`: 5 breaking, 1 info
  - the response property `data/items/invoice` became nullable for the status `200`
  - the response property `data/items/invoice_id` became nullable for the status `200`
  - the response property `links/items/url` became nullable for the status `200`
  - the response property `next_page_url` became nullable for the status `200`
  - …2 more

[Operation history](https://skmtc.dev/sellauth/apis/sellauth-api/changes/v1/shops/:shopId/customers/:customerId/balance-transactions/get.md)

---

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