Consultar limites

GET/api/v2/baas/accounts/limits

Produto BaaS (titular). Requer Bearer JWT do login da conta e assinatura HMAC obrigatória. Scope: baas.accounts.read. Guia: documentação técnica.

Parâmetros

AcceptObrigatório

header

Tipo:string

X-SignatureObrigatório

header

Assinatura HMAC-SHA256 da requisição (hex).

Tipo:string

X-TimestampObrigatório

header

Timestamp Unix (segundos, UTC) usado na assinatura.

Tipo:string

X-NonceObrigatório

header

Nonce único por requisição (anti-replay).

Tipo:string

Autenticação e headers

Requer Bearer JWT do login da conta e assinatura HMAC obrigatórios. Scope: baas.accounts.read.

Envie X-Signature, X-Timestamp e X-Nonce em todo pedido assinado. Veja Autenticação do parceiro (HMAC).

Header	Obrigatório	Descrição
`Authorization`	Sim	`Bearer {{access_token}}`
`Accept`	Sim	`application/json`
`X-Signature`	Sim	Assinatura HMAC
`X-Timestamp`	Sim	Timestamp da assinatura
`X-Nonce`	Sim	Nonce único por requisição

GET assinado: BODY [] na mensagem HMAC.

Valores monetários

Limites em centavos (ex.: 300000 = R$ 3.000,00). Consulte antes do POST de alteração.

Códigos

Código	Descrição
200	OK
201	Recurso criado
400	Parâmetros inválidos
401	Token ou HMAC inválido
403	Scope ausente
404	Não encontrado
422	Validação ou regra de negócio
500	Erro interno

Notas

Técnica: Gestão da conta.
Visão geral BaaS: Sobre o BaaS.

curl --request GET \
  --url 'https://api-h.nuvende.com.br/api/v2/baas/accounts/limits' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {{access_token}}' \
  --header 'X-Timestamp: {{timestamp}}' \
  --header 'X-Nonce: {{nonce}}' \
  --header 'X-Signature: {{signature}}'

const axios = require("axios");

axios({
  method: "get",
  url: "https://api-h.nuvende.com.br/api/v2/baas/accounts/limits",
  headers: {
    Accept: "application/json",
    Authorization: "Bearer {{access_token}}",
    "X-Timestamp": "{{timestamp}}",
    "X-Nonce": "{{nonce}}",
    "X-Signature": "{{signature}}",
  },
})
  .then((response) => console.log(JSON.stringify(response.data)))
  .catch((error) => console.log(error.response?.data || error.message));

import requests

url = "https://api-h.nuvende.com.br/api/v2/baas/accounts/limits"
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer {{access_token}}",
    "X-Timestamp": "{{timestamp}}",
    "X-Nonce": "{{nonce}}",
    "X-Signature": "{{signature}}",
}
response = requests.get(url, headers=headers)
print(response.text)

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://api-h.nuvende.com.br/api/v2/baas/accounts/limits',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Accept: application/json',
    'Authorization: Bearer {{access_token}}',
    'X-Timestamp: {{timestamp}}',
    'X-Nonce: {{nonce}}',
    'X-Signature: {{signature}}',
  ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

{
  "natural_daytime_limit": 300000,
  "natural_nighttime_limit": 100000,
  "legal_daily_limit": 300000,
  "pix_automatic": 100000,
  "pix_scheduled": 100000
}