Openi DeveloperDeveloper
Contas bancárias

Fluxo de Caixa por Dia

Fluxo de caixa diário consolidado no período informado, com filtro por conta e por qualquer campo das transações.

Endpoint

Método e URL:

GET /api/v1/companies/:companyId/bank-accounts/transactions/cashflow/by-day

Parâmetros da URL:

  • companyId (uuid, obrigatório): Identificador da empresa

Parâmetros de query:

  • from, to (data YYYY-MM-DD ou data-hora ISO 8601, obrigatórios): Período sobre transactionAt, ambos inclusivos — to=2026-08-31 inclui o dia 31 inteiro. Veja Período
  • accountId (uuid, opcional, repetível): Restringe a uma ou mais contas. Sem o parâmetro, consolida todas as contas da empresa
  • filters (JSON, opcional): Condições sobre os campos filtráveis das transações — só as transações que passam pelos filtros entram na soma
  • joinOperator (opcional): and (padrão) ou or

Não aceita sort, search nem paginação: retorna um item por dia com movimento, em ordem crescente de data.

Exemplos

Primeira semana de agosto de 2026, todas as contas:

curl "https://api-business.openi.com.br/api/v1/companies/{companyId}/bank-accounts/transactions/cashflow/by-day?from=2026-08-01&to=2026-08-07" \
  -H "Authorization: Bearer oak_368ba506f7b2_9f2c..."

Somente PIX de uma conta:

curl -G "https://api-business.openi.com.br/api/v1/companies/{companyId}/bank-accounts/transactions/cashflow/by-day" \
  -H "Authorization: Bearer oak_368ba506f7b2_9f2c..." \
  --data-urlencode 'from=2026-08-01' \
  --data-urlencode 'to=2026-08-31' \
  --data-urlencode 'accountId=6f1c2b3a-8d4e-4a5b-9c0d-1e2f3a4b5c6d' \
  --data-urlencode 'filters=[{"id":"operationType","operator":"eq","value":"PIX"}]'

Resposta

{
  "status": "success",
  "data": {
    "rows": [
      { "date": "2026-08-01", "inflows": 25400.5, "outflows": 18220.3, "net": 7180.2 },
      { "date": "2026-08-02", "inflows": 0, "outflows": 4500, "net": -4500 }
    ]
  }
}

Cada item agrega um dia com movimento: entradas (inflows), saídas em valor absoluto (outflows) e resultado líquido (net), todos como números. Dias sem transações não aparecem.

On this page