cURL
curl --request GET \
--url https://www.pierre.finance/tools/api/get-accounts \
--header 'Authorization: Bearer <token>'import requests
url = "https://www.pierre.finance/tools/api/get-accounts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.pierre.finance/tools/api/get-accounts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://www.pierre.finance/tools/api/get-accounts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://www.pierre.finance/tools/api/get-accounts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://www.pierre.finance/tools/api/get-accounts")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://www.pierre.finance/tools/api/get-accounts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": [
{
"accountId": "acc_123456789",
"providerCode": "NUBANK",
"accountName": "Conta Corrente",
"accountType": "BANK",
"accountSubtype": "CHECKING_ACCOUNT",
"accountBalance": 1500.50,
"accountCurrencyCode": "BRL",
"accountMarketingName": "Nubank Conta",
"bankData": {
"transferNumber": "123456789",
"closingBalance": 1500.50,
"automaticallyInvestedBalance": 0
}
},
{
"accountId": "acc_987654321",
"providerCode": "ITAU",
"accountName": "Cartão de Crédito",
"accountType": "CREDIT",
"accountSubtype": "CREDIT_CARD",
"accountBalance": -2500.00,
"accountCurrencyCode": "BRL",
"accountMarketingName": "Itaú Cartão",
"creditData": {
"brand": "VISA",
"level": "GOLD",
"status": "ACTIVE",
"creditLimit": 10000.00,
"balanceDueDate": "2024-02-15",
"minimumPayment": 250.00,
"balanceCloseDate": "2024-01-31",
"availableCreditLimit": 7500.00,
"balanceForeignCurrency": null
}
}
],
"count": 2,
"timestamp": "2024-01-15T10:30:00Z"
}
Accounts & Balance
Get Accounts
Retorna todas as contas financeiras do usuário. Requer API key para autenticação e assinatura ativa.
GET
/
tools
/
api
/
get-accounts
cURL
curl --request GET \
--url https://www.pierre.finance/tools/api/get-accounts \
--header 'Authorization: Bearer <token>'import requests
url = "https://www.pierre.finance/tools/api/get-accounts"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.pierre.finance/tools/api/get-accounts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://www.pierre.finance/tools/api/get-accounts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://www.pierre.finance/tools/api/get-accounts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://www.pierre.finance/tools/api/get-accounts")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://www.pierre.finance/tools/api/get-accounts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"data": [
{
"accountId": "acc_123456789",
"providerCode": "NUBANK",
"accountName": "Conta Corrente",
"accountType": "BANK",
"accountSubtype": "CHECKING_ACCOUNT",
"accountBalance": 1500.50,
"accountCurrencyCode": "BRL",
"accountMarketingName": "Nubank Conta",
"bankData": {
"transferNumber": "123456789",
"closingBalance": 1500.50,
"automaticallyInvestedBalance": 0
}
},
{
"accountId": "acc_987654321",
"providerCode": "ITAU",
"accountName": "Cartão de Crédito",
"accountType": "CREDIT",
"accountSubtype": "CREDIT_CARD",
"accountBalance": -2500.00,
"accountCurrencyCode": "BRL",
"accountMarketingName": "Itaú Cartão",
"creditData": {
"brand": "VISA",
"level": "GOLD",
"status": "ACTIVE",
"creditLimit": 10000.00,
"balanceDueDate": "2024-02-15",
"minimumPayment": 250.00,
"balanceCloseDate": "2024-01-31",
"availableCreditLimit": 7500.00,
"balanceForeignCurrency": null
}
}
],
"count": 2,
"timestamp": "2024-01-15T10:30:00Z"
}
Este endpoint retorna todas as contas financeiras do usuário autenticado.
Descrição
O endpointGET /tools/api/get-accounts retorna todas as contas financeiras associadas ao usuário autenticado, incluindo contas bancárias, cartões de crédito, investimentos e empréstimos.
Autenticação
Este endpoint requer autenticação via Bearer token e assinatura ativa.string
required
Bearer token com a API key do usuário. Formato:
Bearer sk-your-api-key-hereParâmetros de Query
Resposta
Sucesso (200)
{
"success": true,
"data": [
{
"accountId": "acc_123456789",
"providerCode": "NUBANK",
"accountName": "Conta Corrente",
"accountType": "BANK",
"accountSubtype": "CHECKING_ACCOUNT",
"accountBalance": 1500.50,
"accountCurrencyCode": "BRL",
"accountMarketingName": "Nubank Conta",
"bankData": {
"transferNumber": "123456789",
"closingBalance": 1500.50,
"automaticallyInvestedBalance": 0
}
},
{
"accountId": "acc_987654321",
"providerCode": "ITAU",
"accountName": "Cartão de Crédito",
"accountType": "CREDIT",
"accountSubtype": "CREDIT_CARD",
"accountBalance": -2500.00,
"accountCurrencyCode": "BRL",
"accountMarketingName": "Itaú Cartão",
"creditData": {
"brand": "VISA",
"level": "GOLD",
"status": "ACTIVE",
"creditLimit": 10000.00,
"balanceDueDate": "2024-02-15",
"minimumPayment": 250.00,
"balanceCloseDate": "2024-01-31",
"availableCreditLimit": 7500.00,
"balanceForeignCurrency": null
}
}
],
"count": 2,
"timestamp": "2024-01-15T10:30:00Z"
}
Erro de Autenticação (401)
{
"error": "Invalid or inactive API key",
"message": "Please check your API key and try again",
"type": "invalid_api_key"
}
Erro de Assinatura (401)
{
"error": "No active subscription found",
"message": "Please activate your subscription to access financial data",
"type": "no_subscription",
"nextSteps": [
"Visit https://pierre.finance to activate your subscription",
"Contact support if you need assistance"
]
}
Campos da Resposta
boolean
required
Indica se a requisição foi bem-sucedida
array
required
Array com as contas financeiras do usuário
Show Account Object
Show Account Object
string
required
Identificador único da conta
string
required
Código do provedor da conta (ex: NUBANK, ITAU)
string
required
Nome da conta
string
required
Tipo da conta (BANK, CREDIT, INVESTMENT, LOAN)
string
required
Subtipo da conta (CHECKING_ACCOUNT, SAVINGS_ACCOUNT, CREDIT_CARD, PAYMENT_ACCOUNT)
number
required
Saldo atual da conta
string
required
Código da moeda da conta (ex: BRL, USD)
string
required
Nome de marketing da conta
object
object
Dados específicos de cartões de crédito
Show Credit Data
Show Credit Data
string
Bandeira do cartão (MASTERCARD, VISA, ELO)
string
Nível do cartão (ex: GOLD, PLATINUM)
string
Status do cartão (ACTIVE, BLOCKED, CANCELLED)
number
Limite de crédito
string
Data de vencimento da fatura
number
Valor mínimo para pagamento
string
Data de fechamento da fatura
number
Limite de crédito disponível
number
Saldo em moeda estrangeira
number
required
Número total de contas retornadas
string
required
Timestamp da requisição em formato ISO 8601
Exemplos de Uso
cURL
curl -X GET 'https://www.pierre.finance/tools/api/get-accounts' \
-H 'Authorization: Bearer sk-your-api-key-here'
JavaScript
const response = await fetch('https://www.pierre.finance/tools/api/get-accounts', {
headers: {
'Authorization': 'Bearer sk-your-api-key-here'
}
});
const data = await response.json();
console.log(data);
Python
import requests
headers = {
'Authorization': 'Bearer sk-your-api-key-here'
}
response = requests.get('https://www.pierre.finance/tools/api/get-accounts', headers=headers)
data = response.json()
print(data)
Códigos de Status
200: Sucesso - Contas retornadas401: Erro de autenticação ou assinatura500: Erro interno do servidor
Este endpoint retorna dados em tempo real das contas conectadas. Para dados mais recentes, use o endpoint de sincronização manual.
⌘I

