Contas

Saldo & extrato

Endpoints de leitura para acompanhar movimentação financeira de uma conta.

Saldo (ledger interno)

GET/v1/accounts/:accountId/balance

Escopo: accounts:read. Retorna o saldo do ledger interno — pode haver delay em relação ao provedor.

Conta MOTHER não é transacionável: 422 account_not_transactable.

O campo balance é uma string com inteiros em centavos.

Extrato (movimentos)

GET/v1/accounts/:accountId/statement

Escopo: ledger:read. Paginação por cursor.

Query params

limitintegeroptionaldefault: 30

1 a 100.

cursorstringoptional

ID do último item da página anterior.

nextCursor é null quando não há próxima página.

Ledger entries (sem join)

GET/v1/accounts/:accountId/ledger-entries

Mesma paginação, formato simplificado: id, tenantId, accountId, movementId, amount, description, createdAt.

bash· GET balance

curl https://stater.stric.io/v1/accounts/$ID/balance \
  -H "Authorization: Bearer $TOKEN"

json· 200 OK

{
  "accountId": "...",
  "balance": "12345",
  "updatedAt": "2026-04-17T12:00:00.000Z"
}

bash· GET statement

curl "https://stater.stric.io/v1/accounts/$ID/statement?limit=30&cursor=..." \
  -H "Authorization: Bearer $TOKEN"

json· Statement response

{
  "data": [
    {
      "id": "...",
      "accountId": "...",
      "movementId": "...",
      "movementType": "PIX_IN",
      "reference": "pixin:...",
      "amount": "1000",
      "description": "...",
      "metadata": {},
      "createdAt": "..."
    }
  ],
  "nextCursor": "..."
}