Pular para o conteúdo principal
A maioria das operações age sobre um espaço. Leia os IDs que você precisa uma vez, guarde-os no seu script e leia de novo quando sua configuração no Visor mudar. As listas desta página trazem todos os itens numa resposta só; elas não têm páginas. Só a lista de transações e a lista de notificações são paginadas.

​
Espaços

GET /v1/spaces lista os espaços que você criou e os espaços para os quais foi convidado. Todas as outras operações recebem o id de um espaço no caminho:
Um ID de espaço que não existe, ou de um espaço que você não acessa, recebe 404 NOT_FOUND. A resposta é a mesma nos dois casos.

​
Contas

GET /v1/spaces/{space_id}/accounts lista as contas bancárias, os cartões de crédito e as contas de investimento do espaço. A resposta nunca traz número de conta, número de cartão ou credenciais do banco.

​
Categorias

GET /v1/spaces/{space_id}/categories lista as categorias que o Visor oferece (kind: system) e as categorias que você criou no espaço (kind: custom).
  • Identifique uma categoria do sistema pela key, como category.food_and_drinks. A chave não muda.
  • O name é o nome que o seu espaço mostra. Uma categoria do sistema está em inglês, a menos que você a tenha renomeado no espaço, e o nome pode mudar. O name de uma categoria personalizada é o nome que você deu a ela.
  • names traz os nomes em inglês (en) e português brasileiro (pt-BR), como {"en": "Groceries", "pt-BR": "Supermercado"}. Os dois nomes usam as traduções e os fallbacks do app, e renomear no espaço não os altera. Para uma categoria personalizada, os dois trazem o nome que você escolheu.
  • type é expense ou income. Ele é null numa categoria do sistema que o Visor criou a partir de uma categoria do banco e ainda não classificou.
  • Uma subcategoria traz o id da categoria pai em parent_id, do jeito que o seu espaço a mostra: você pode mover uma categoria do sistema para outra categoria ou para o nível principal. Uma categoria principal tem parent_id: null.

​
Tags

GET /v1/spaces/{space_id}/tags lista as tags do espaço, em ordem alfabética.

​
Contas e categorias ocultas

As listas de contas e de categorias deixam de fora o que você ocultou no Visor. Adicione include_hidden=true para incluir esses itens, com hidden: true:
Um valor inválido, como yes, recebe 400 BAD_REQUEST com o nome do parâmetro em details.parameter.