> ## Documentation Index
> Fetch the complete documentation index at: https://juridiqsoftware.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Demonstrativo do fluxo de caixa (DFC)

> DFC pelo método direto, mês a mês, no período from–to (até 36 meses). Regime de caixa: o pago conta na data da baixa e a baixa parcial na data de cada pagamento, a mesma regra do saldo das contas. Traz o saldo inicial, os grupos (`sections`: operacional, investimento, financiamento, ajustes e, com `billId`, transferências entre contas), cada um com entradas (`inflows`) e saídas (`outflows`, valores negativos) por categoria, a variação do caixa e o saldo final de cada mês (`periods`, `openingBalances`, `closingBalances`). Movimentação patrimonial entra pela espécie: investimento, financiamento e sócios, ajuste. Inclui repasse a terceiros e o que está fora do DRE. Com `forecast=true`, cada linha traz também o previsto (`forecast`) e o bloco `forecast` traz o saldo projetado. O previsto vai de hoje até o fim do período, pelo vencimento: lançamento em aberto já vencido não entra.



## OpenAPI

````yaml https://api.juridiq.com.br/api-docs/client/openapi.json get /financial/reports/cash-flow/statement
openapi: 3.1.0
info:
  title: Juridiq API — Documentação para Integradores
  description: >-
    API REST para integradores autenticados com chave (`x-juridiq-api-key`).


    ## Rate limit


    A API aberta limita **240 requisições a cada 60s por chave**.

    O escritório também tem um limite conjunto de **240 requisições por minuto**
    e **15000 por dia** (renova à 00h de Brasília), somando todas as suas
    chaves. Os gestores e os donos das chaves recebem e-mail aos 50% da cota
    diária e quando houver bloqueio.

    Ao exceder, a resposta é `429 Too Many Requests` com os headers
    `x-ratelimit-limit`, `x-ratelimit-remaining`, `x-ratelimit-reset` e
    `retry-after`.

    Respeite o `retry-after` antes de tentar de novo. Sincronizações em lote
    devem paginar e tratar 429 com backoff.
  version: 1.0.0
servers:
  - url: https://api.juridiq.com.br
    description: Production server
security:
  - apiKeyAuth: []
tags: []
paths:
  /financial/reports/cash-flow/statement:
    get:
      tags:
        - Financial
      summary: Demonstrativo do fluxo de caixa (DFC)
      description: >-
        DFC pelo método direto, mês a mês, no período from–to (até 36 meses).
        Regime de caixa: o pago conta na data da baixa e a baixa parcial na data
        de cada pagamento, a mesma regra do saldo das contas. Traz o saldo
        inicial, os grupos (`sections`: operacional, investimento,
        financiamento, ajustes e, com `billId`, transferências entre contas),
        cada um com entradas (`inflows`) e saídas (`outflows`, valores
        negativos) por categoria, a variação do caixa e o saldo final de cada
        mês (`periods`, `openingBalances`, `closingBalances`). Movimentação
        patrimonial entra pela espécie: investimento, financiamento e sócios,
        ajuste. Inclui repasse a terceiros e o que está fora do DRE. Com
        `forecast=true`, cada linha traz também o previsto (`forecast`) e o
        bloco `forecast` traz o saldo projetado. O previsto vai de hoje até o
        fim do período, pelo vencimento: lançamento em aberto já vencido não
        entra.
      parameters:
        - schema:
            type: string
            pattern: ^\d{4}-\d{2}-\d{2}$
          in: query
          name: from
          required: true
          description: 'Início (AAAA-MM-DD). Um mês: 2026-06-01; um ano: 2026-01-01'
        - schema:
            type: string
            pattern: ^\d{4}-\d{2}-\d{2}$
          in: query
          name: to
          required: true
          description: >-
            Fim (AAAA-MM-DD), inclusive. Um mês: 2026-06-30; um ano: 2026-12-31.
            Até 36 meses
        - schema:
            type: string
            format: uuid
          in: query
          name: billId
          required: false
          description: >-
            Só uma conta. Sem ele, todas as contas que a pessoa pode ver e os
            lançamentos sem conta
        - schema:
            anyOf:
              - type: boolean
              - type: string
                enum:
                  - 'true'
                  - 'false'
          in: query
          name: forecast
          required: false
          description: >-
            true soma o previsto: o que está em aberto, pelo vencimento, de hoje
            até o fim do período (vencido em aberto não entra)
      responses:
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      message:
                        type: string
                      issues: {}
                    required:
                      - message
                    additionalProperties: false
                  - type: object
                    properties:
                      message:
                        type: string
                      statusCode:
                        type: number
                      translateMessage:
                        type: string
                    required:
                      - message
                      - statusCode
                      - translateMessage
                    additionalProperties: false
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  statusCode:
                    type: number
                  translateMessage:
                    type: string
                required:
                  - message
                  - statusCode
                  - translateMessage
                additionalProperties: false
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  statusCode:
                    type: number
                  translateMessage:
                    type: string
                required:
                  - message
                  - statusCode
                  - translateMessage
                additionalProperties: false
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  statusCode:
                    type: number
                  translateMessage:
                    type: string
                required:
                  - message
                  - statusCode
                  - translateMessage
                additionalProperties: false
        '409':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  statusCode:
                    type: number
                  translateMessage:
                    type: string
                required:
                  - message
                  - statusCode
                  - translateMessage
                additionalProperties: false
        '422':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  statusCode:
                    type: number
                  translateMessage:
                    type: string
                required:
                  - message
                  - statusCode
                  - translateMessage
                additionalProperties: false
      security:
        - apiKeyAuth: []
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-juridiq-api-key
      description: >-
        Chave de API do escritório (criada no painel). Envie o valor no header
        x-juridiq-api-key. A API aberta aplica rate limit por chave (veja a
        documentação de integradores).

````

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