Public API
Endpoints
Bandwidth Usage

Bandwidth Usage

The Bandwidth Usage endpoint returns the same proxy bandwidth and request statistics as the Evomi dashboard (GET /products/proxy-history), including Core Residential extra / default / total breakdowns.

Endpoint Permalink to Endpoint

GET https://api.evomi.com/public/usage

Query Parameters Permalink to Query Parameters

Parameter Type Required Default Description
period 24h, 3d, or 7d No 3d Time range preset. 24h uses hourly buckets; 3d and 7d use daily buckets (same as the dashboard).
product string Yes — Proxy product code: rp, rpc, dcp, mp, or sdc.

Product Codes Permalink to Product Codes

Code Product
rp Premium Residential
rpc Core Residential
sdc Datacenter Proxies
mp Mobile Proxies
sdc Static Datacenter

Authentication Permalink to Authentication

Use your personal or team API key. See Authentication.

  • A personal API key reports usage for your personal proxy account only.
  • A team API key reports usage for that team’s shared proxy identity.

Example Request Permalink to Example Request

Match the dashboard default (Last 3 days, Core Residential):

curl -H "x-apikey: YOUR_API_KEY" \
  "https://api.evomi.com/public/usage?period=3d&product=rpc"

Last 7 days (daily):

curl -H "x-apikey: YOUR_API_KEY" \
  "https://api.evomi.com/public/usage?period=7d&product=rpc"

Last 24 hours (hourly):

curl -H "x-apikey: YOUR_API_KEY" \
  "https://api.evomi.com/public/usage?period=24h&product=rpc"

Response Format Permalink to Response Format

{
  "success": true,
  "data": {
    "bandwidth": {
      "products": [
        {
          "name": "Residential",
          "code": "rpc",
          "totalBandwidth": 43971237.38,
          "stats": {
            "2026-05-26 00:00": { "default": 19072705.92, "extra": 0.26, "total": 19072706.18 }
          }
        }
      ]
    },
    "requests": {}
  },
  "meta": {
    "period": "3d",
    "product": "rpc",
    "duration": "3d",
    "granularity": "day",
    "ownership_scope": "personal",
    "auth_type": "personal",
    "proxy_username": "example_core_user",
    "bandwidth_unit": "MB",
    "total_bandwidth_mb": 43971237.38,
    "total_bandwidth_gb": 43971.23738,
    "total_bandwidth_tb": 43.97123738
  }
}

Fields Permalink to Fields

  • data.bandwidth.products — Only the requested product. Values are in megabytes (MB), same as the dashboard chart total.
  • data.bandwidth.products[].stats — Per bucket (hour or day). For Core Residential (rpc), each bucket may include default, extra, and total (MB).
  • data.bandwidth.products[].totalBandwidth — Period total in MB (matches the dashboard bandwidth chart total).
  • meta.total_bandwidth_mb — Same as totalBandwidth for the requested product (MB).
  • meta.total_bandwidth_gb — total_bandwidth_mb ÷ 1,000
  • meta.total_bandwidth_tb — total_bandwidth_mb ÷ 1,000,000 (e.g. 43971237 MB ≈ 43.97 TB)
  • requests — Recent request statistics (last 12 hours, hourly), same as the dashboard.

Common Errors Permalink to Common Errors

  • 400 Bad Request — Invalid period or product, or upstream stats error.
  • 401 Unauthorized — Missing or invalid API key.
  • 403 Forbidden — Email verification required (personal keys only).
  • 500 Internal Server Error — Server-side failure.

For authentication details, see Authentication.

Get Proxy DataTargeting Options