curl --request GET \
--url https://api.malvo.io/transactions \
--header 'X-API-KEY: <api-key>'const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api.malvo.io/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.malvo.io/transactions"
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/transactions",
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;
}{
"total": 8,
"totalPages": 1,
"page": 1,
"results": [
{
"id": "a8534c85-53ce-4f21-94d7-50e9d2ee4957",
"description": "* PROV * COMPRA TESOURO DIRETO CLIENTES",
"descriptionRaw": "* PROV * COMPRA TESOURO DIRETO CLIENTES",
"currencyCode": "BRL",
"amount": -212.45,
"date": "2020-10-15T00:00:00.000Z",
"balance": 4439.4,
"category": "Fixed Income Investment",
"accountId": "562b795d-1653-429f-be86-74ead9502813",
"providerCode": null,
"status": "POSTED",
"paymentData": null,
"type": "DEBIT",
"providerId": null
},
{
"id": "05c693bf-c196-47ea-a28c-8251d6bb8a06",
"description": "PAGO NETFLIX SERV",
"descriptionRaw": "PAGO NETFLIX SERV",
"currencyCode": "USD",
"amount": -58,
"amountInAccountCurrency": -298.19,
"date": "2020-10-15T00:00:00.000Z",
"balance": 4651.85,
"category": "Video streaming",
"accountId": "562b795d-1653-429f-be86-74ead9502813",
"providerCode": null,
"status": "POSTED",
"paymentData": null,
"type": "DEBIT",
"providerId": null,
"merchant": {
"name": "Netflix",
"businessName": "NETFLIX ENTRETENIMENTO BRASIL LTDA.",
"cnpj": "00000000000000",
"category": "Video streaming",
"cnae": "5911100"
}
},
{
"id": "ff9ed929-edc4-408c-a959-d51f79ab1814",
"description": "MERCADOLIVRE*2PRODUTOS",
"currencyCode": "BRL",
"amount": 159.2,
"date": "2020-10-14T00:00:00.000Z",
"balance": 2468.84,
"category": "Investment",
"accountId": "562b795d-1653-429f-be86-74ead9502813",
"providerCode": null,
"status": "POSTED",
"paymentData": null,
"type": "CREDIT",
"creditCardMetadata": {
"totalAmount": 320,
"totalInstallments": 2,
"installmentNumber": 2,
"purchaseDate": "2020-09-14T00:00:00.000Z",
"payeeMCC": 1234,
"cardNumber": "0597",
"billId": "abced929-edc4-408c-a959-d51f79ab1123"
},
"providerId": null
},
{
"id": "6ec156fe-e8ac-4d9a-a4b3-7770529ab01c",
"description": "TED Example",
"descriptionRaw": null,
"currencyCode": "BRL",
"amount": 1500,
"date": "2020-10-14T00:00:00.000Z",
"balance": 3500,
"category": "Transfer",
"accountId": "03cc0eff-4ec5-495c-adb3-1ef9611624fc",
"providerCode": "123456",
"type": "CREDIT",
"status": "POSTED",
"operationType": "TED",
"paymentData": {
"payer": {
"name": "Tiago Rodrigues Santos",
"branchNumber": "090",
"accountNumber": "1234-5",
"routingNumber": "001",
"documentNumber": {
"type": "CPF",
"value": "882.937.076-23"
}
},
"reason": "Taxa de serviço",
"receiver": {
"name": "Loja Exemplo Ltda",
"branchNumber": "999",
"accountNumber": "9876-1",
"routingNumber": "002",
"documentNumber": {
"type": "CNPJ",
"value": "08.050.608/0001-32"
}
},
"paymentMethod": "TED",
"referenceNumber": "123456789"
},
"providerId": null
}
]
}{
"message": "accountId should not be null or undefined,accountId must be a UUID",
"code": 400
}{
"code": 500,
"codeDescription": "INTERNAL_SERVER_ERROR",
"message": "Internal Server Error"
}Listar transações (page-based, deprecado)
Deprecado. Lista as transações de uma conta usando paginação por página (envelope { total, totalPages, page, results }). Mantido por compatibilidade. Prefira GET /v2/transactions (cursor-based).
Filtra por accountId (obrigatório) — não há filtro por itemId. Se ids for informado, from/to são descartados. Cobre até 12 meses de histórico.
curl --request GET \
--url https://api.malvo.io/transactions \
--header 'X-API-KEY: <api-key>'const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api.malvo.io/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.malvo.io/transactions"
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/transactions",
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;
}{
"total": 8,
"totalPages": 1,
"page": 1,
"results": [
{
"id": "a8534c85-53ce-4f21-94d7-50e9d2ee4957",
"description": "* PROV * COMPRA TESOURO DIRETO CLIENTES",
"descriptionRaw": "* PROV * COMPRA TESOURO DIRETO CLIENTES",
"currencyCode": "BRL",
"amount": -212.45,
"date": "2020-10-15T00:00:00.000Z",
"balance": 4439.4,
"category": "Fixed Income Investment",
"accountId": "562b795d-1653-429f-be86-74ead9502813",
"providerCode": null,
"status": "POSTED",
"paymentData": null,
"type": "DEBIT",
"providerId": null
},
{
"id": "05c693bf-c196-47ea-a28c-8251d6bb8a06",
"description": "PAGO NETFLIX SERV",
"descriptionRaw": "PAGO NETFLIX SERV",
"currencyCode": "USD",
"amount": -58,
"amountInAccountCurrency": -298.19,
"date": "2020-10-15T00:00:00.000Z",
"balance": 4651.85,
"category": "Video streaming",
"accountId": "562b795d-1653-429f-be86-74ead9502813",
"providerCode": null,
"status": "POSTED",
"paymentData": null,
"type": "DEBIT",
"providerId": null,
"merchant": {
"name": "Netflix",
"businessName": "NETFLIX ENTRETENIMENTO BRASIL LTDA.",
"cnpj": "00000000000000",
"category": "Video streaming",
"cnae": "5911100"
}
},
{
"id": "ff9ed929-edc4-408c-a959-d51f79ab1814",
"description": "MERCADOLIVRE*2PRODUTOS",
"currencyCode": "BRL",
"amount": 159.2,
"date": "2020-10-14T00:00:00.000Z",
"balance": 2468.84,
"category": "Investment",
"accountId": "562b795d-1653-429f-be86-74ead9502813",
"providerCode": null,
"status": "POSTED",
"paymentData": null,
"type": "CREDIT",
"creditCardMetadata": {
"totalAmount": 320,
"totalInstallments": 2,
"installmentNumber": 2,
"purchaseDate": "2020-09-14T00:00:00.000Z",
"payeeMCC": 1234,
"cardNumber": "0597",
"billId": "abced929-edc4-408c-a959-d51f79ab1123"
},
"providerId": null
},
{
"id": "6ec156fe-e8ac-4d9a-a4b3-7770529ab01c",
"description": "TED Example",
"descriptionRaw": null,
"currencyCode": "BRL",
"amount": 1500,
"date": "2020-10-14T00:00:00.000Z",
"balance": 3500,
"category": "Transfer",
"accountId": "03cc0eff-4ec5-495c-adb3-1ef9611624fc",
"providerCode": "123456",
"type": "CREDIT",
"status": "POSTED",
"operationType": "TED",
"paymentData": {
"payer": {
"name": "Tiago Rodrigues Santos",
"branchNumber": "090",
"accountNumber": "1234-5",
"routingNumber": "001",
"documentNumber": {
"type": "CPF",
"value": "882.937.076-23"
}
},
"reason": "Taxa de serviço",
"receiver": {
"name": "Loja Exemplo Ltda",
"branchNumber": "999",
"accountNumber": "9876-1",
"routingNumber": "002",
"documentNumber": {
"type": "CNPJ",
"value": "08.050.608/0001-32"
}
},
"paymentMethod": "TED",
"referenceNumber": "123456789"
},
"providerId": null
}
]
}{
"message": "accountId should not be null or undefined,accountId must be a UUID",
"code": 400
}{
"code": 500,
"codeDescription": "INTERNAL_SERVER_ERROR",
"message": "Internal Server Error"
}Authorizations
Chave de API da aplicação. Obrigatória em todos os endpoints. Renove via POST /auth.
Query Parameters
Identificador primário da conta.
Lista de ids de transação. Se informado, from/to são descartados.
Filtra date >= from. Formato yyyy-mm-dd.
Filtra date <= to. Formato yyyy-mm-dd.
Tamanho da página (1–500). Padrão 500.
1 <= x <= 500Página (1-based). Padrão 1.
x >= 1Filtra por horário de ingestão. Formato yyyy-mm-ddThh:mm:ss.000Z.
Response
Página de transações (envelope paginado).
Envelope de paginação por página para transações.