BRbrightdata

GET /zone/cost

Changed on

Returns billed cost, bandwidth, and usage stats for a Zone over a date range. Values match the Control Panel's Usage Overview and your invoice.

Note: the to parameter is exclusive. The day specified is not included. See the page below for invoice reconciliation guidance.

Request

  • Base URL
    https://api.brightdata.com
  • URL
    https://api.brightdata.com/zone/cost
  • Auth
    HTTP bearer

Query parameters

zonestring required

Zone name (e.g., se_midware).

fromstring date

Inclusive start date in YYYY-MM-DD format.

tostring date

Exclusive end date in YYYY-MM-DD format. The day specified is NOT included in the result.

To match a calendar month shown in the Control Panel or on your invoice, set to to the first day of the following month (e.g., from=2026-04-01&to=2026-05-01 returns all of April 2026).

Response

OK

object required

Example response

{
  "ID": {
    "back_m2": {
      "bw": 0,
      "cost": 0
    },
    "back_m1": {
      "bw": 36557298,
      "cost": 0
    },
    "back_m0": {
      "bw": 1219004,
      "cost": 0
    },
    "back_d2": {
      "bw": 82190,
      "cost": 0
    },
    "back_d1": {
      "bw": 0,
      "cost": 0
    },
    "back_d0": {
      "bw": 0,
      "cost": 0
    }
  }
}

Changes