curl --request GET \
--url https://api.malvo.io/connectors/{id} \
--header 'X-API-KEY: <api-key>'const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api.malvo.io/connectors/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.malvo.io/connectors/{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/connectors/{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": 612,
"name": "Nubank",
"institutionUrl": "https://nubank.com.br",
"imageUrl": "https://malvo.io/connectors/nubank.svg",
"primaryColor": "820AD1",
"country": "BR",
"type": "PERSONAL_BANK",
"credentials": [
{
"label": "CPF",
"name": "cpf",
"type": "number",
"placeholder": "999.999.999-99",
"validation": "^\\d{3}\\.?\\d{3}\\.?\\d{3}-?\\d{2}$",
"validationMessage": "CPF deve ter 11 dígitos",
"optional": false
}
],
"products": [
"ACCOUNTS",
"CREDIT_CARDS",
"TRANSACTIONS",
"INVESTMENTS",
"IDENTITY"
],
"isOpenFinance": true,
"isSandbox": false,
"oauth": true,
"oauthUrl": null,
"hasMFA": false,
"supportsPaymentInitiation": false,
"health": {
"status": "ONLINE",
"stage": null
},
"createdAt": "2024-06-01T00:00:00.000Z",
"updatedAt": "2025-01-01T00:00:00.000Z"
}{
"code": 401,
"message": "Missing or invalid authorization token",
"codeDescription": "CLIENT_KEYS_UNAUTHORIZED"
}{
"code": 404,
"message": "Connector not found"
}Consulta um conector pelo id
Retorna um único conector pelo seu id inteiro. Conectores sandbox não são visíveis sem o opt-in de sandbox.
curl --request GET \
--url https://api.malvo.io/connectors/{id} \
--header 'X-API-KEY: <api-key>'const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api.malvo.io/connectors/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.malvo.io/connectors/{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/connectors/{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": 612,
"name": "Nubank",
"institutionUrl": "https://nubank.com.br",
"imageUrl": "https://malvo.io/connectors/nubank.svg",
"primaryColor": "820AD1",
"country": "BR",
"type": "PERSONAL_BANK",
"credentials": [
{
"label": "CPF",
"name": "cpf",
"type": "number",
"placeholder": "999.999.999-99",
"validation": "^\\d{3}\\.?\\d{3}\\.?\\d{3}-?\\d{2}$",
"validationMessage": "CPF deve ter 11 dígitos",
"optional": false
}
],
"products": [
"ACCOUNTS",
"CREDIT_CARDS",
"TRANSACTIONS",
"INVESTMENTS",
"IDENTITY"
],
"isOpenFinance": true,
"isSandbox": false,
"oauth": true,
"oauthUrl": null,
"hasMFA": false,
"supportsPaymentInitiation": false,
"health": {
"status": "ONLINE",
"stage": null
},
"createdAt": "2024-06-01T00:00:00.000Z",
"updatedAt": "2025-01-01T00:00:00.000Z"
}{
"code": 401,
"message": "Missing or invalid authorization token",
"codeDescription": "CLIENT_KEYS_UNAUTHORIZED"
}{
"code": 404,
"message": "Connector not found"
}Authorizations
Path Parameters
Id inteiro do conector.
Response
Conector encontrado.
Integração com uma instituição financeira específica. Declara credenciais necessárias, produtos suportados e saúde.
Id estável para este conector. Trate como opaco e descubra em GET /connectors; somente 0–99 é reservado aos mocks locais.
612
Nome de exibição da instituição.
"Nubank"
Site da instituição.
"https://nubank.com.br"
Logo (SVG/PNG) servido via CDN.
"https://malvo.io/connectors/nubank.svg"
Cor hexadecimal SEM prefixo #.
"820AD1"
ISO-3166-1 alpha-2.
"BR"
Tipo do conector.
PERSONAL_BANK, BUSINESS_BANK, INVESTMENT, OTHER "PERSONAL_BANK"
Descritores de entrada antes do redirect. No Brasil normalmente CPF/CNPJ; no fluxo internacional geralmente é [], mas pode conter o select authMethod quando uma jornada precisa ou pode ser selecionada via API. Nunca contém senha bancária.
Show child attributes
Show child attributes
Produtos anunciados por este conector. O Open Banking internacional anuncia ACCOUNTS e TRANSACTIONS.
Produto de dados coletável. Valores exatos e case-sensitive.
ACCOUNTS, TRANSACTIONS, CREDIT_CARDS, INVESTMENTS, INVESTMENTS_TRANSACTIONS, LOANS, IDENTITY, OPPORTUNITIES, PORTFOLIO, INCOME_REPORTS [
"ACCOUNTS",
"CREDIT_CARDS",
"TRANSACTIONS",
"INVESTMENTS",
"IDENTITY"
]
true = conector regulado de Open Finance Brasil ou Open Banking/AIS.
true
true = conector de teste local ou do ambiente sandbox do provedor.
false
true = conexão exige redirect OAuth para a instituição.
true
URL efêmera de autorização no contexto de criação/reconsentimento do Item; normalmente null no catálogo.
null
true = conector pode emitir um desafio de MFA (conectores diretos).
false
Sempre false na Malvo (mantido por compatibilidade de wire).
false
Saúde operacional do conector.
Show child attributes
Show child attributes
{ "status": "ONLINE", "stage": null }
Timestamp ISO-8601 de criação do registro do conector.
"2024-06-01T00:00:00.000Z"
Timestamp ISO-8601 da última atualização do registro do conector.
"2025-01-01T00:00:00.000Z"