Lista as contas
Todas as contas do workspace: correntes, dinheiro, cartões de crédito, investimentos,
poupança, imóveis, empréstimos e as demais contas do balanço. Inclui as inativas e as
encerradas; filtre com status=active para só as que estão em uso. Não traz saldo.
Conta oculta para a credencial não aparece (e responde 404 na consulta por id); conta somente leitura aparece normalmente.
accessTokenAuthorizationBearer <token>Access token (mda_…) obtido em POST /auth/token. Vale 1 hora.
limit?integerItens por página.
1 <= value <= 500100cursor?stringO next_cursor da página anterior. Omita na primeira página.
tipo?stringO tipo da conta como o app mostra. A carteira de investimentos, que o Meu Dinheiro cria
para os investimentos, não aparece na API; contas_a_receber, contas_a_pagar, outros_ativos_imobilizados e capital_social
existem só em workspace de pessoa jurídica.
"conta_corrente""dinheiro""cartao_credito""carteira_ativos""poupanca""aplicacao_financeira""imovel""contas_a_receber""contas_a_pagar""emprestimo_concedido""emprestimo_contratado""outros_ativos""outros_ativos_imobilizados""outros_passivos""capital_social"status?stringactive em uso; inactive desativada; closed encerrada, só histórico.
"active""inactive""closed"Uma página de contas.
application/json- response
data*array<>next_cursor*|Cursor da próxima página; nulo na última.
curl -X GET "https://example.com/contas"{ "data": [ { "id": 2051, "nome": "Inter PJ", "tipo": "conta_corrente", "status": "active", "moeda": "BRL", "banco": { "codigo": "077", "nome": "Banco Inter S.A." }, "agencia": "0001", "numero_conta": "12345-6", "finalidade": "custos_operacionais" } ], "next_cursor": "string"}O workspace e a credencial ou a conexão do token GET
A primeira chamada de quem integra, para conferir o token. Token de credencial (Key + Secret) traz `credential`; token de uma conexão MCP aprovada por um usuário traz `connection`.
Cria uma conta POST
Cria uma conta do workspace, com o saldo inicial lançado na data informada. Exige o papel **Editor** ou um papel com permissão de editar Contas. Cartão de crédito se cria em `POST /cartoes`, e esta versão não cria `aplicacao_financeira`; os dois tipos aqui respondem 400. Em `contas_a_pagar` a `finalidade` é obrigatória (nos outros tipos, 400), e o tipo só existe em workspace de pessoa jurídica: em pessoa física responde 422, como o app, que não o oferece. Em conta de passivo e de patrimônio líquido (`emprestimo_contratado`, `outros_passivos`, `capital_social`, `contas_a_pagar`) o saldo inicial é gravado negativo, como no app. Poupança só existe em BRL. A resposta é a conta criada, no mesmo formato do `GET /contas/{id}`. Campo fora da lista responde 400.