Get account balances
curl --request GET \
--url https://api.floppydata.net/v2/account/balances \
--header 'X-Api-Key: <api-key>'import requests
url = "https://api.floppydata.net/v2/account/balances"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://api.floppydata.net/v2/account/balances', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"webData": {
"requests": {
"total": 100,
"used": 25,
"remaining": 75
}
},
"proxy": {
"rotating": {
"expiring": {
"expiresAt": "2026-01-25T08:33:30Z",
"traffic": {
"availableBytes": 10737418240,
"availableGb": 10
}
},
"nonExpiring": {
"traffic": {
"availableBytes": 5368709120,
"availableGb": 5
}
},
"total": {
"traffic": {
"availableBytes": 16106127360,
"availableGb": 15
}
}
},
"static": {
"activeIpCount": 3,
"pendingIpCount": 1
}
}
}{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters.",
"details": {
"issues": [
{
"path": "country",
"code": "invalid_format",
"message": "Expected a 2-letter country code."
}
]
}
}
}{
"error": {
"code": "unauthorized",
"message": "Unauthorized",
"details": {}
}
}{
"error": {
"code": "insufficient_balance",
"message": "Insufficient proxy traffic balance.",
"details": {}
}
}{
"error": {
"code": "forbidden",
"message": "Forbidden",
"details": {}
}
}{
"error": {
"code": "not_found",
"message": "Rotating proxy credential was not found.",
"details": {}
}
}{
"error": {
"code": "account_not_configured",
"message": "Account is not configured for proxy products.",
"details": {}
}
}{
"error": {
"code": "internal_error",
"message": "Internal Server Error",
"details": {}
}
}{
"error": {
"code": "upstream_error",
"message": "Failed to fetch data from an upstream service.",
"details": {
"upstreamStatus": 503
}
}
}Account
Balances
Returns account-level balance summaries across available products. Use product-scoped balance endpoints when a page only needs one product.
GET
https://api.floppydata.net
/
v2
/
account
/
balances
Get account balances
curl --request GET \
--url https://api.floppydata.net/v2/account/balances \
--header 'X-Api-Key: <api-key>'import requests
url = "https://api.floppydata.net/v2/account/balances"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://api.floppydata.net/v2/account/balances', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"webData": {
"requests": {
"total": 100,
"used": 25,
"remaining": 75
}
},
"proxy": {
"rotating": {
"expiring": {
"expiresAt": "2026-01-25T08:33:30Z",
"traffic": {
"availableBytes": 10737418240,
"availableGb": 10
}
},
"nonExpiring": {
"traffic": {
"availableBytes": 5368709120,
"availableGb": 5
}
},
"total": {
"traffic": {
"availableBytes": 16106127360,
"availableGb": 15
}
}
},
"static": {
"activeIpCount": 3,
"pendingIpCount": 1
}
}
}{
"error": {
"code": "invalid_request",
"message": "Invalid request parameters.",
"details": {
"issues": [
{
"path": "country",
"code": "invalid_format",
"message": "Expected a 2-letter country code."
}
]
}
}
}{
"error": {
"code": "unauthorized",
"message": "Unauthorized",
"details": {}
}
}{
"error": {
"code": "insufficient_balance",
"message": "Insufficient proxy traffic balance.",
"details": {}
}
}{
"error": {
"code": "forbidden",
"message": "Forbidden",
"details": {}
}
}{
"error": {
"code": "not_found",
"message": "Rotating proxy credential was not found.",
"details": {}
}
}{
"error": {
"code": "account_not_configured",
"message": "Account is not configured for proxy products.",
"details": {}
}
}{
"error": {
"code": "internal_error",
"message": "Internal Server Error",
"details": {}
}
}{
"error": {
"code": "upstream_error",
"message": "Failed to fetch data from an upstream service.",
"details": {
"upstreamStatus": 503
}
}
}This is the safest first playground request because it confirms API key access and returns account-level balances.
Was this page helpful?
⌘I