---
title: "Store Credit operations and a balance of a customer"
method: GET
path: "/store_credits/{customerId}"
tags: ["Store Credits"]
---

# Store Credit operations and a balance of a customer

`GET /store_credits/{customerId}`

Returns a balance and a history of store credit operations for the given customer id.

🔒 Requires: `store_credits:read` scope

## Path parameters

- `customerId` string, uuid, required

## Response `200`

The store credit details for the given customer.

- StoreCreditCustomer — The store credit information for a customer.
  - `balance` number, double, required — The customers store credit balance.
  - `created_at` string — Creation timestamp in UTC.
  - `customer_id` string, uuid, required — The customer id.
  - `id` string, string — Store Credit Customer's internal ID.
  - `store_credit_transactions` StoreCreditTransaction[] — The transactions associated with this customer.
    - `amount` number, double — The amount of the transaction
    - `client_id` string — An operation idempotency identifier. The client must provide this and normally it should be the transaction id from the client system. An operation and it's reverse operation must have the same client_id
    - `created_at` string, date-time — The date time the transaction was created.
    - `id` string — transaction unique identifier (base64 encoded)
    - `notes` string — The notes associated with the transaction.
    - `sale_id` string, uuid — The sale id the transaction is associated with. This should be null for transactions initiated outside of Lightspeed Retail. If it is a sale id, it will be in UUID format.
    - `type` 'ISSUE' | 'REDEMPTION' | 'REVERSE' — The type of the transaction
    - `user_id` string, uuid — The user id of the person who performed the transaction (during a sale or a manual issue)
  - `total_credit_issued` number, double, required — Total amount of store credit issued to this customer.
  - `total_credit_redeemed` number, double, required — Total amount of store credit spent by this customer.

## Other responses

- `404` — The given customer not found.

---

[API](https://skmtc.net/lightspeedhq/apis/api-2026-07.md) · [All operations](https://skmtc.net/lightspeedhq/apis/api-2026-07/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightspeedhq/api-2026-07/versions/72d4ceb46dbb/schema)