> ## 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.

# Espaços e dados de referência

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

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](https://docs.visorfinance.app/pt-BR/transactions.md) e a [lista de notificações](https://docs.visorfinance.app/pt-BR/financial-data.md#seu-perfil-e-notificações) são paginadas.

## Espaços

[`GET /v1/spaces`](https://docs.visorfinance.app/api-reference/spaces/list-accessible-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:

```text theme={null}
/v1/spaces/{space_id}/accounts
```

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`](https://docs.visorfinance.app/api-reference/accounts/list-accounts) lista as contas bancárias, os cartões de crédito e as contas de investimento do espaço.

| Campo | Significado |
| - | - |
| `type` | `bank`, `credit` ou `investment` |
| `source` | `connected` para uma conta que sincroniza com o banco, `manual` para uma conta que você criou |
| `balance` | Texto decimal com sinal. O saldo de um cartão de crédito é negativo quando há valor a pagar. |
| `currency_code` | Código ISO 4217 do saldo, como `BRL` |
| `provider_name` | O banco de uma conta conectada, ou `null` para uma conta manual |

A resposta nunca traz número de conta, número de cartão ou credenciais do banco.

## Categorias

[`GET /v1/spaces/{space_id}/categories`](https://docs.visorfinance.app/api-reference/categories/list-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`](https://docs.visorfinance.app/api-reference/tags/list-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`:

```bash theme={null}
curl "https://api.visorfinance.app/v1/spaces/SPACE_ID/categories?include_hidden=true" \
  --header "Authorization: Bearer $VISOR_TOKEN"
```

Um valor inválido, como `yes`, recebe `400 BAD_REQUEST` com o nome do parâmetro em `details.parameter`.


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