---
title: "Subcontas (clientes finais) com saldo, paginadas"
method: GET
path: "/saldo/clientes"
tags: ["Conta"]
---

# Subcontas (clientes finais) com saldo, paginadas

`GET /saldo/clientes`

## Request

- Base URL: `https://api.luniumpay.com`
- URL: `https://api.luniumpay.com/saldo/clientes`
- Auth: API key in header `X-API-Key`

Lista cada `customer_ref` da chave com disponível, bloqueado e total. Ordenado por `customer_ref`; pagine com `cursor=next_cursor`. `com_saldo=1` esconde subcontas zeradas.

## Query parameters

- `limit` integer
- `cursor` string
- `com_saldo` '0' | '1'

## Response `200`

Página de subcontas.

- object
  - `clientes` object[]
    - `customer_ref` string
    - `disponivel_cents` integer
    - `bloqueado_cents` integer
    - `total_cents` integer
    - `movimentos` integer
    - `primeiro_movimento_em` string, date-time
    - `ultimo_movimento_em` string, date-time
  - `has_more` boolean
  - `next_cursor` string, nullable

---

[API](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil.md) · [All operations](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/llms.txt) · [OpenAPI document](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/revisions/0b5a340fa9dd?raw)