curl --request GET \
--url https://api.malvo.io/accounts/{id} \
--header 'X-API-KEY: <api-key>'const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api.malvo.io/accounts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.malvo.io/accounts/{id}"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.malvo.io/accounts/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"id": "a658c848-e475-457b-8565-d1fffba127c4",
"type": "BANK",
"subtype": "CHECKING_ACCOUNT",
"number": "0001/12345-0",
"name": "Conta Corrente",
"marketingName": "GOLD Conta Corrente",
"balance": 120950,
"balanceAvailable": true,
"balanceUpdatedAt": "2026-07-19T12:00:00.000Z",
"itemId": "a0922d6f-2007-4169-a181-b961500608db",
"taxNumber": "416.799.495-00",
"owner": "John Doe",
"currencyCode": "BRL",
"bankData": {
"transferNumber": "0001/12345-0",
"closingBalance": 120950,
"automaticallyInvestedBalance": 100,
"overdraftContractedLimit": 0,
"overdraftUsedLimit": 0,
"unarrangedOverdraftAmount": 0
}
}{
"code": 404,
"codeDescription": "ACCOUNT_NOT_FOUND",
"message": "account not found"
}{
"code": 500,
"codeDescription": "INTERNAL_SERVER_ERROR",
"message": "Internal Server Error"
}Recuperar conta
Recupera uma única conta pelo seu identificador primário.
curl --request GET \
--url https://api.malvo.io/accounts/{id} \
--header 'X-API-KEY: <api-key>'const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api.malvo.io/accounts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.malvo.io/accounts/{id}"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.malvo.io/accounts/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"id": "a658c848-e475-457b-8565-d1fffba127c4",
"type": "BANK",
"subtype": "CHECKING_ACCOUNT",
"number": "0001/12345-0",
"name": "Conta Corrente",
"marketingName": "GOLD Conta Corrente",
"balance": 120950,
"balanceAvailable": true,
"balanceUpdatedAt": "2026-07-19T12:00:00.000Z",
"itemId": "a0922d6f-2007-4169-a181-b961500608db",
"taxNumber": "416.799.495-00",
"owner": "John Doe",
"currencyCode": "BRL",
"bankData": {
"transferNumber": "0001/12345-0",
"closingBalance": 120950,
"automaticallyInvestedBalance": 100,
"overdraftContractedLimit": 0,
"overdraftUsedLimit": 0,
"unarrangedOverdraftAmount": 0
}
}{
"code": 404,
"codeDescription": "ACCOUNT_NOT_FOUND",
"message": "account not found"
}{
"code": 500,
"codeDescription": "INTERNAL_SERVER_ERROR",
"message": "Internal Server Error"
}Authorizations
Chave de API obrigatória em todas as rotas.
Path Parameters
Identificador primário da conta.
Response
Objeto Account.
Conta bancária (type=BANK) ou de cartão de crédito (type=CREDIT) coletada para um item. Consulte balanceAvailable antes de interpretar o scalar balance; balances preserva conjuntos que não podem ser reduzidos com fidelidade.
Identificador primário da conta.
Identificador primário do item ao qual a conta está vinculada.
BANK = contas bancárias, de poupança, empréstimo, caixa ou outros produtos AIS, com bankData populado. CREDIT = contas de cartão de crédito, com creditData populado.
BANK, CREDIT CHECKING_ACCOUNT (corrente), SAVINGS_ACCOUNT (poupança), LOAN_ACCOUNT (empréstimo), CASH_ACCOUNT (caixa) e OTHER_ACCOUNT (outro tipo AIS) usam type=BANK; CREDIT_CARD usa type=CREDIT. Para cartões, number é mascarado nos últimos 4 dígitos.
CHECKING_ACCOUNT, SAVINGS_ACCOUNT, CREDIT_CARD, LOAN_ACCOUNT, CASH_ACCOUNT, OTHER_ACCOUNT Identificador externo da conta (ex.: 0001/12345-0) ou últimos 4 dígitos do cartão.
Nome descritivo da conta (ex.: Conta Corrente).
Scalar normalizado da última coleta. Só deve ser interpretado quando balanceAvailable=true.
Indica se balance representa um scalar fiel na moeda da conta.
ISO 4217 (ex.: BRL).
Quando a conta foi criada no agregador.
Última atualização dos dados da conta.
Nome da marca/produto conforme definido pela instituição.
Momento informado/persistido para a última coleta de saldo.
Conjunto completo de saldos retornado pelo provedor, usado especialmente em contas multimoeda.
Show child attributes
Show child attributes
CPF/CNPJ do titular, formatado (ex.: 416.799.495-00).
Nome completo do titular da conta.
Presente quando type=BANK.
Show child attributes
Show child attributes
Presente quando type=CREDIT.
Show child attributes
Show child attributes