Introdução

A API pessoal do Visor permite que quem tem o Visor Pro ou o Visor Premium conecte seus próprios scripts, planilhas e automações aos seus dados financeiros. Você se autentica com um token pessoal que cria nas Configurações do Visor, e cada requisição tem as mesmas permissões que você tem no app.

O que você já pode fazer

Operação	Endpoint	Escopo
Listar os espaços que você acessa	`GET /v1/spaces`	`pfm:read`
Listar as contas de um espaço	`GET /v1/spaces/{space_id}/accounts`	`pfm:read`
Listar as categorias de um espaço	`GET /v1/spaces/{space_id}/categories`	`pfm:read`
Listar as tags de um espaço	`GET /v1/spaces/{space_id}/tags`	`pfm:read`
Listar transações, página por página	`GET /v1/spaces/{space_id}/transactions`	`pfm:read`
Ver uma transação	`GET /v1/spaces/{space_id}/transactions/{transaction_id}`	`pfm:read`
Ver a visão geral de um espaço	`GET /v1/spaces/{space_id}/overview`	`pfm:read`
Listar os cartões de crédito de um espaço	`GET /v1/spaces/{space_id}/cards`	`pfm:read`
Listar as faturas de um cartão	`GET /v1/spaces/{space_id}/cards/{card_id}/bills`	`pfm:read`
Listar assinaturas	`GET /v1/spaces/{space_id}/subscriptions`	`pfm:read`
Listar contas fixas	`GET /v1/spaces/{space_id}/fixed-bills`	`pfm:read`
Listar parcelamentos	`GET /v1/spaces/{space_id}/installment-plans`	`pfm:read`
Listar metas	`GET /v1/spaces/{space_id}/goals`	`pfm:read`
Listar investimentos	`GET /v1/spaces/{space_id}/investments`	`pfm:read`
Listar conexões Open Finance	`GET /v1/spaces/{space_id}/connections`	`pfm:read`
Ver seu perfil	`GET /v1/me`	`pfm:read`
Listar suas notificações, página por página	`GET /v1/notifications`	`pfm:read`
Registrar uma transação	`POST /v1/spaces/{space_id}/transactions`	`pfm:transactions:write`
Editar uma transação	`PATCH /v1/spaces/{space_id}/transactions/{transaction_id}`	`pfm:transactions:write`
Excluir uma transação	`DELETE /v1/spaces/{space_id}/transactions/{transaction_id}`	`pfm:transactions:write`

Novas operações entram aqui quando forem lançadas. A documentação mostra só o que já está disponível.

Os guias estão em português. A referência da API, com os campos e os códigos de cada operação, está em inglês.

URL base

https://api.visorfinance.app

Todas as requisições e respostas usam JSON sobre HTTPS.

Quem pode usar

Você precisa de um plano Pro ou Premium ativo. Período de teste, período de carência e acesso patrocinado por um escritório de assessoria também valem.
A API pessoal está sendo liberada aos poucos. Se o card API pessoal não aparece em Configurações > Apps Conectados, ela ainda não está disponível para a sua conta.

Primeiros passos

Crie um token e faça sua primeira requisição em poucos minutos.

Espaços e dados de referência

Encontre os IDs dos seus espaços, contas, categorias e tags.

Transações

Exporte seu histórico, registre gastos e edite ou exclua transações.

Linha de comando

Prefere o terminal? A CLI visor roda cada operação desta documentação sem você montar requisições HTTP, e se instala com brew install visor-finance/tap/visor.

API pessoal ou MCP?

A API pessoal é para o código que você escreve e roda. Para conectar um assistente de IA, como Claude, ChatGPT, Codex ou Cursor, use o servidor MCP do Visor. O MCP entra com OAuth, está disponível no Pro e no Premium e não usa tokens da API pessoal.

Comece aqui

Essencial

O que você já pode fazer

URL base

Quem pode usar

Primeiros passos

Espaços e dados de referência

Transações

Linha de comando

API pessoal ou MCP?

​O que você já pode fazer

​URL base

​Quem pode usar

Primeiros passos

Espaços e dados de referência

Transações

​Linha de comando

​API pessoal ou MCP?

O que você já pode fazer

URL base

Quem pode usar

Linha de comando

API pessoal ou MCP?