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.

GET /v1/subaccounts/{id}/entries

cURL

curl "https://bukio-backend-production.up.railway.app/v1/subaccounts/vendedor-42/entries?from=2026-10-01&to=2026-10-31&kind=sale,withdraw&limit=20" \
  -H "Authorization: Bearer bk_live_..."

200

{
  "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
}

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

Show 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.

cURL

curl "https://bukio-backend-production.up.railway.app/v1/subaccounts/vendedor-42/entries?from=2026-10-01&to=2026-10-31&kind=sale,withdraw&limit=20" \
  -H "Authorization: Bearer bk_live_..."

200

{
  "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
}