curl --request GET \
--url https://api.yuvexpay.com/v1/withdrawals/limits \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.yuvexpay.com/v1/withdrawals/limits"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.yuvexpay.com/v1/withdrawals/limits', 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://api.yuvexpay.com/v1/withdrawals/limits",
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://api.yuvexpay.com/v1/withdrawals/limits"
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://api.yuvexpay.com/v1/withdrawals/limits")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.yuvexpay.com/v1/withdrawals/limits")
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{
"currentLimit": 5000,
"used": 1200,
"remaining": 3800,
"isNightTime": false,
"fee": 2.49,
"dayStartHour": 6,
"dayEndHour": 22,
"minAmount": 10,
"perTransactionLimit": 5000
}{
"error": {
"code": "INVALID_API_KEY",
"message": "Invalid or revoked API key"
}
}Get withdrawal limits
Retrieve your current withdrawal limits, usage and fee. A reduced “nightly” limit applies outside the dayStartHour–dayEndHour window (BRT); isNightTime tells you which one currentLimit currently reflects. Day and night share one used counter for the whole Brazilian calendar day.
curl --request GET \
--url https://api.yuvexpay.com/v1/withdrawals/limits \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.yuvexpay.com/v1/withdrawals/limits"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.yuvexpay.com/v1/withdrawals/limits', 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://api.yuvexpay.com/v1/withdrawals/limits",
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://api.yuvexpay.com/v1/withdrawals/limits"
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://api.yuvexpay.com/v1/withdrawals/limits")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.yuvexpay.com/v1/withdrawals/limits")
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{
"currentLimit": 5000,
"used": 1200,
"remaining": 3800,
"isNightTime": false,
"fee": 2.49,
"dayStartHour": 6,
"dayEndHour": 22,
"minAmount": 10,
"perTransactionLimit": 5000
}{
"error": {
"code": "INVALID_API_KEY",
"message": "Invalid or revoked API key"
}
}Authorizations
YuvexPay API key. Include as Authorization: Bearer ypk_<env>_<kid>_<secret> where <env> is test (sandbox) or live (production). Create and manage keys in the dashboard under Settings > API Keys.
Response
Limits retrieved.
Daily (or nightly, when isNightTime is true) limit in BRL.
Amount already consumed today, in BRL. Counts amount + feeAmount of each withdrawal, and is a single counter for the whole Brazilian calendar day — the nightly limit is compared against a total that already includes daytime volume.
Remaining capacity for the current window, in BRL. Because the fee counts towards the limit, the largest amount you can request is remaining - fee.
Whether reduced night limits are active.
Withdrawal fee, a flat amount in BRL charged on top of amount. Read it from here rather than hardcoding it: it is configurable per account.
Hour when daytime limits begin (BRT).
Hour when nighttime limits begin (BRT).
Minimum withdrawal amount in BRL that applies to your account, compared against amount (the net) rather than against amount + fee. Never below the R$ 10.00 platform floor, but it can be higher. Unrelated to the routing provider minimum, which surfaces as WITHDRAWAL_BELOW_PROVIDER_MINIMUM.
Largest single withdrawal your account may request, in BRL, or null when no account-level cap applies. Like the daily limit it is compared against amount + fee, so the largest amount you can request is perTransactionLimit - fee. A second, lower ceiling can apply at the PIX provider that routes the payout; it depends on live routing and is not returned here, but it is still evaluated synchronously and comes back as a 400 WITHDRAWAL_LIMIT_EXCEEDED or 400 WITHDRAWAL_BELOW_PROVIDER_MINIMUM on the create call.

