Skip to main content
GET
cURL
The GET /pricing_plans endpoint returns your account’s current pricing plan and the other plans available to your account, with the per-product prices of each plan. All prices are in USD.
Paste your API key into the authorization field. To get an API key, create an account and learn how to generate an API key.

Which API key permission does this endpoint need?

GET /pricing_plans requires the billing.read permission. API keys with the Admin or Finance permission level have it. Keys with the Ops, Limit or User permission level cannot call this endpoint.

How do I get my current pricing plan?

Call GET /pricing_plans with an Admin or Finance API key. The endpoint takes no parameters:
The response contains a plans array. Your current plan is the entry where is_current is true. To print only that plan, filter the response with jq:

How is the response structured?

Each entry in the plans array describes one plan: The keys of product_prices are the same internal product keys that the cost breakdown export uses in its filters, such as dc (Datacenter proxies) and res_static (ISP proxies). Each value holds a product name and a price_groups array. Each price group has a name, a prices object and, for some products, an unlim_ip_tier_prices object.

How do I read the prices object?

Each key in prices is a billing unit and each value is the price in USD for one unit. For example, "prices": {"gb": 8} means $8 per GB. The other possible keys are compute_hour, record, total, files_archive, files_cache, req_content, block and page_load. Which keys appear depends on the product.

Which products return unlim_ip_tier_prices?

Only Datacenter proxies (dc) and ISP proxies (res_static) return unlim_ip_tier_prices. The object maps each IP tier size to its price in USD.

Does the endpoint have rate limits or specific errors?

No. GET /pricing_plans has no endpoint-specific rate limit and no endpoint-specific error codes.

Authorizations

Authorization
string
header
required

Use your Bright Data API Key as a Bearer token in the Authorization header.

How to authenticate:

  1. Obtain your API Key from the Bright Data account settings at https://brightdata.com/cp/setting/users
  2. Include the API Key in the Authorization header of your requests
  3. Format: Authorization: Bearer YOUR_API_KEY

Example:

Learn how to get your Bright Data API key: https://docs.brightdata.com/api-reference/authentication

Response

200 - application/json

OK

plans
object[]

Your current plan and the plans available to your account.