Get account usage
curl --request GET \
--url https://api.floppydata.net/v2/account/usage \
--header 'X-Api-Key: <api-key>'import requests
url = "https://api.floppydata.net/v2/account/usage"
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/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"webData": {
"requests": {
"yesterday": {
"total": 3,
"successful": 2,
"failed": 1
},
"last7Days": {
"total": 30,
"successful": 28,
"failed": 2
},
"last30Days": {
"total": 120,
"successful": 112,
"failed": 8
},
"requestedRange": {
"total": 30,
"successful": 28,
"failed": 2
}
},
"lastUpdatedAt": "2026-06-10T12:00:00.000Z"
},
"proxy": {
"rotating": {
"traffic": {
"yesterday": {
"totalBytes": 1073741824,
"totalGb": 1,
"txBytes": 536870912,
"rxBytes": 536870912
},
"last7Days": {
"totalBytes": 10737418240,
"totalGb": 10,
"txBytes": 5368709120,
"rxBytes": 5368709120
},
"last30Days": {
"totalBytes": 32212254720,
"totalGb": 30,
"txBytes": 16106127360,
"rxBytes": 16106127360
},
"requestedRange": {
"totalBytes": 10737418240,
"totalGb": 10,
"txBytes": 5368709120,
"rxBytes": 5368709120
}
},
"lastUpdatedAt": "2026-06-10T11:00:00.000Z"
}
},
"lastUpdatedAt": "2026-06-10T12:00:00.000Z",
"filters": {
"from": "2025-01-27T00:00:00.000Z",
"to": "2025-12-28T23:59:59.999Z",
"countryCode": "US",
"proxyType": "residential"
}
}{
"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
Usage
Returns account-level usage across products with usage reporting as UTC period rollups. If from or to is supplied, product usage also includes requestedRange. Static proxies are inventory-only and are not included in usage responses.
GET
https://api.floppydata.net
/
v2
/
account
/
usage
Get account usage
curl --request GET \
--url https://api.floppydata.net/v2/account/usage \
--header 'X-Api-Key: <api-key>'import requests
url = "https://api.floppydata.net/v2/account/usage"
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/usage', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"webData": {
"requests": {
"yesterday": {
"total": 3,
"successful": 2,
"failed": 1
},
"last7Days": {
"total": 30,
"successful": 28,
"failed": 2
},
"last30Days": {
"total": 120,
"successful": 112,
"failed": 8
},
"requestedRange": {
"total": 30,
"successful": 28,
"failed": 2
}
},
"lastUpdatedAt": "2026-06-10T12:00:00.000Z"
},
"proxy": {
"rotating": {
"traffic": {
"yesterday": {
"totalBytes": 1073741824,
"totalGb": 1,
"txBytes": 536870912,
"rxBytes": 536870912
},
"last7Days": {
"totalBytes": 10737418240,
"totalGb": 10,
"txBytes": 5368709120,
"rxBytes": 5368709120
},
"last30Days": {
"totalBytes": 32212254720,
"totalGb": 30,
"txBytes": 16106127360,
"rxBytes": 16106127360
},
"requestedRange": {
"totalBytes": 10737418240,
"totalGb": 10,
"txBytes": 5368709120,
"rxBytes": 5368709120
}
},
"lastUpdatedAt": "2026-06-10T11:00:00.000Z"
}
},
"lastUpdatedAt": "2026-06-10T12:00:00.000Z",
"filters": {
"from": "2025-01-27T00:00:00.000Z",
"to": "2025-12-28T23:59:59.999Z",
"countryCode": "US",
"proxyType": "residential"
}
}{
"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
}
}
}Usage responses include
yesterday, last7Days, last30Days, lastUpdatedAt, and requestedRange when from or to is supplied.Authorizations
Client API key for the authenticated account.
Query Parameters
Available options:
web-data, proxy-rotating Date or datetime in RFC 3339 format
Pattern:
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$Example:
"2025-01-27T00:00:00Z"
Date or datetime in RFC 3339 format
Pattern:
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$Example:
"2025-12-28"
Proxy pool ID. Applies to rotating proxy usage.
Required range:
x <= 9007199254740991Example:
123
2-letter country code. Applies to rotating proxy usage.
Pattern:
^[a-zA-Z]{2}$Example:
"US"
Rotating proxy type. Applies to rotating proxy usage.
Available options:
residential, mobile, datacenter Example:
"residential"
Was this page helpful?