> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wyzecash.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Movimentos da subconta

> Os movimentos SUB- de uma subconta, com filtro por período e tipo: vendas, envios, transferências, saques, devoluções, estornos e MED.

Escopo `transactions:read`.

**id** `string` *required*

`sacc_` + 32 hex ou o seu `externalId`.

**from** `string`

Início do período: `AAAA-MM-DD` (o dia inteiro, horário de Brasília) ou data e hora ISO.

**to** `string`

Fim do período: `AAAA-MM-DD` (inclui o dia) ou data e hora ISO (exclusivo). Início depois do fim ou data inválida: `422 INVALID_PERIOD`.

**kind** `string`

Tipos separados por vírgula, por exemplo `sale,withdraw`. Tipo desconhecido: `422 INVALID_KIND`.

**limit** `integer` (default: 50)

De 1 a 100.

**cursor** `string`

O `nextCursor` da página anterior (mande os mesmos filtros).

## Resposta

**items** `object[]`

**propriedades de cada item**

**id** `string`

`SUB-` + 12.

**kind** `string`

`sale` (venda creditada), `fund` (enviado da principal), `transfer` (transferência entre subcontas), `withdraw` (saque para o cliente), `return` (devolvido à principal), `refund` (estorno de venda), `med` (devolução MED) ou `adjust` (ajuste).

**kindTitle** `string`

Venda creditada, Enviado da principal, Transferência entre subcontas, Saque para o cliente, Devolvido à principal, Estorno de venda, Devolução MED ou Ajuste.

**direction** `string`

`credit` ou `debit`.

**amount** `integer`

O que entrou ou saiu da subconta.

**gross** `integer | null`

Na venda: o valor da cobrança.

**fee** `integer | null`

Na venda: tarifa da WyzeCash + sua comissão.

**description** `string | null`

Descrição.

**createdAt** `string`

Data e hora.

**nextCursor** `string | null`

Próxima página; `null` quando acabou.

```bash cURL theme={null}
curl "https://api.wyzecash.com.br/v1/subaccounts/vendedor-42/entries?from=2026-10-01&to=2026-10-31&kind=sale,withdraw&limit=20" \
  -H "Authorization: Bearer bk_live_..."
```

```json 200 theme={null}
{
  "items": [
    {
      "id": "SUB-2W8M4Z3F7K9Q",
      "kind": "sale",
      "kindTitle": "Venda creditada",
      "direction": "credit",
      "amount": 14200,
      "gross": 15000,
      "fee": 800,
      "description": "Cobrança BKY-7KQ2M9XP4RZT",
      "createdAt": "2026-10-08T15:04:11.000Z"
    }
  ],
  "nextCursor": null
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.