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

# Dados financeiros

> Leia a visão geral, cartões e faturas, despesas recorrentes, parcelamentos, metas, investimentos, conexões e notificações.

Estas operações só leem dados e precisam do escopo `pfm:read`. Valores em dinheiro são texto decimal com um `currency_code`, como `"1842.90"`. Datas usam `YYYY-MM-DD`, e horários usam ISO 8601 em UTC. Os números são os mesmos que o app do Visor mostra.

## Visão geral

[`GET /v1/spaces/{space_id}/overview`](https://docs.visorfinance.app/api-reference/overview/get-the-financial-overview) traz um resumo do espaço no período financeiro atual. O período segue o dia de início do mês do espaço, não o mês do calendário.

| Campo | Significado |
| - | - |
| `bank_balance` | Saldo das contas bancárias visíveis |
| `credit_card_debt` | Valor devido nos cartões de crédito |
| `net_worth` | Contas e investimentos menos dívidas |
| `open_bills_total` | Valor que ainda falta pagar nas faturas abertas |
| `upcoming_bills` | Faturas que vencem nos próximos 30 dias, da mais próxima para a mais distante |
| `period` | `income`, `expenses` e `result` do período |
| `projection` | Saldo previsto no fim do período, com as receitas esperadas e as saídas já comprometidas |

Todos os valores estão na moeda de exibição do usuário.

## Cartões e faturas

[`GET /v1/spaces/{space_id}/cards`](https://docs.visorfinance.app/api-reference/cards/list-credit-cards) lista os cartões de crédito visíveis do espaço, com o limite, o limite usado e as datas da fatura atual. O `id` do cartão é o mesmo `id` da conta.

[`GET /v1/spaces/{space_id}/cards/{card_id}/bills`](https://docs.visorfinance.app/api-reference/cards/list-the-bills-of-a-credit-card) lista as faturas de um cartão. Filtre pelo vencimento com `from` e `to`. Sem eles, a lista mostra o mês atual. Quando `amount_is_estimate` é `true`, o Visor montou o total a partir das transações sincronizadas, e o banco ainda pode mudar esse valor.

## Assinaturas e contas fixas

O Visor separa as despesas recorrentes em duas listas:

* [`GET /v1/spaces/{space_id}/subscriptions`](https://docs.visorfinance.app/api-reference/recurring-expenses/list-subscriptions) lista as assinaturas que você pode cancelar, como serviços de streaming.
* [`GET /v1/spaces/{space_id}/fixed-bills`](https://docs.visorfinance.app/api-reference/recurring-expenses/list-fixed-bills) lista as contas fixas, como aluguel, contas de consumo e escola.

Cada despesa recorrente aparece em uma lista só. As duas listas mostram as despesas ativas, com o próximo vencimento e a data da última cobrança encontrada.

## Parcelamentos

[`GET /v1/spaces/{space_id}/installment-plans`](https://docs.visorfinance.app/api-reference/installments/list-installment-plans) lista as compras parceladas. `paid_installments` e `total_installments` são o `X de N` do app. Use `status=completed` para listar os parcelamentos que você marcou como concluídos.

## Metas

[`GET /v1/spaces/{space_id}/goals`](https://docs.visorfinance.app/api-reference/goals/list-goals) lista as metas ativas e concluídas, com o objetivo, o valor guardado e o progresso. A reserva de emergência é uma meta com `kind: emergency_fund`. Filtre com `status=active`, `completed` ou `archived`.

## Investimentos

[`GET /v1/spaces/{space_id}/investments`](https://docs.visorfinance.app/api-reference/investments/list-investments) lista os investimentos conectados e manuais, do maior para o menor. `summary.total_value` é o total na moeda de exibição e não soma os investimentos que você tirou do patrimônio.

## Conexões Open Finance

[`GET /v1/spaces/{space_id}/connections`](https://docs.visorfinance.app/api-reference/connections/list-open-finance-connections) lista as conexões bancárias que alimentam contas do espaço, com o status da sincronização e a última sincronização concluída. Quando `requires_reauth` é `true`, reconecte o banco no app do Visor.

## Seu perfil e notificações

[`GET /v1/me`](https://docs.visorfinance.app/api-reference/user/show-the-current-user) traz seu nome, e-mail, idioma, moeda de exibição, plano em vigor e espaço ativo.

[`GET /v1/notifications`](https://docs.visorfinance.app/api-reference/notifications/list-notifications) lista suas notificações de todos os espaços, da mais nova para a mais antiga. Use `unread=true` para listar só as não lidas. A lista tem páginas, como a [lista de transações](https://docs.visorfinance.app/pt-BR/transactions.md): passe `next_cursor` como `after` para ler a próxima página.


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