---
title: "Bulk Store Credit customers"
method: POST
path: "/store_credits/bulk"
tags: ["Store Credits"]
---

# Bulk Store Credit customers

`POST /store_credits/bulk`

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

## Request body

- string[]

## Response `200`

A list of customers with associated store credit balances.

- StoreCreditBulkResponse — Store credit customer list with balance and transactions
  - `data` StoreCreditCustomer[], required — An array of Store Credit Customers
    - `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)