---
title: "Get store credit usage for the store"
method: GET
path: "/store_credits"
tags: ["Store Credits"]
---

# Get store credit usage for the store

`GET /store_credits`

Returns all the store credit customers in a store with their store credit balance
and a list of last store credit transactions for each customer

🔒 Requires: `store_credits:read` scope

## Query parameters

- `page_size` integer
- `includes[]` string

## Response `200`

The list of store credit customers.

- StoreCreditCustomer[] — Store Credit customer data in the shop
  - `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.

---

[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)