---
title: "List customer credits accounts"
method: GET
path: "/v1/customer-credits/accounts"
tags: ["Customer Credits - Accounts"]
---

# List customer credits accounts

`GET /v1/customer-credits/accounts`

## Request

- Base URL: `https://api.creem.io`
- URL: `https://api.creem.io/v1/customer-credits/accounts`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/creem/apis/creem-api/docs/v1/customer-credits/accounts/get.ts> (a function with typed inputs; its response is checked against the schema)

List accounts for the authenticated store with cursor pagination. System accounts are excluded.

## Query parameters

- `limit` number
- `customer_id` string
- `starting_after` string
- `ending_before` string

## Response `200`

Paginated list of accounts

- AccountListResponseDto
  - `object` string, required: Object type
  - `data` AccountResponseDto[], required: Array of accounts
    - `id` string, required: Account ID
    - `store_id` string, required: Store ID
    - `customer_id` string, required: Owner ID
    - `name` string, required: Account name
    - `unit_label` string, required: Unit label
    - `status` 'active' | 'frozen' | 'closed', required: Account status
    - `created_at` string, required: Creation timestamp
    - `updated_at` string, required: Last update timestamp
  - `has_more` boolean, required: Whether more items exist beyond this page

## Other responses

- `400`: Bad Request - Invalid input parameters
- `401`: Unauthorized - Invalid or missing API key
- `404`: Not Found - Resource does not exist

## Changes

- **2026-09-15** `071301350724`: 2 info
  - api tag `Customer Credits - Accounts` added
  - api tag `Customer Credits - Accounts (Experimental)` removed

[Operation history](https://skmtc.dev/creem/apis/creem-api/changes/v1/customer-credits/accounts/get.md)

---

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