Uma conta
Conta de outro workspace, inexistente ou oculta para a credencial responde 404.
accessTokenAuthorizationBearer <token>Access token (mda_…) obtido em POST /auth/token. Vale 1 hora.
id*integerA conta.
application/json- response
id*integernome*stringtipo*TipoContaO 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*StatusContaactive em uso; inactive desativada; closed encerrada, só histórico.
"active""inactive""closed"moeda*stringCódigo ISO 4217.
banco*|A instituição da conta. Nulo quando não há, ou quando o ícone escolhido para a conta é genérico (uma casa, um carro…), e não um banco.
agencia*string|nullnumero_conta*string|nullfinalidade*|O grupo do passivo no balanço (FinalidadeConta); só em contas_a_pagar, nulo nos outros tipos.
"custos_operacionais""despesas_variaveis""despesas_fixas""lucros""impostos""impostos_sobre_lucro"nullcurl -X GET "https://example.com/contas/0"{ "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"}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.
Altera uma conta (só os campos enviados) PATCH
Altera só os campos enviados; os demais ficam como estão. Nulo limpa `banco`, `agencia` e `numero_conta`. As regras são as do `PUT`. Para tirar a conta de uso sem perder o histórico, mude o `status` para `closed` (encerrada) ou `inactive`.