> ## Documentation Index > Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt > Use this file to discover all available pages before exploring further. # Get free tier credits > Use GET /trials/free_tier in the Bright Data Account Management API to get included, used and left free tier credits. Allows 600 requests per minute per IP. The `GET /trials/free_tier` endpoint returns the free tier credits on your Bright Data account: whether the free tier is enabled and how many credits are included, used and left. The values match the **Free credits** card on the [Billing overview](https://brightdata.com/cp/billing/overview) page in the Control Panel. > [!TIP] > > Paste your API key into the authorization field. To get an API key, [create an account](https://brightdata.com/?hs_signup=1\&utm_source=docs\&utm_campaign=playground) and learn [how to generate an API key](https://docs.brightdata.com/api-reference/authentication.md#how-do-i-generate-a-new-api-key%3F). ## Which API key permission does this endpoint need? `GET /trials/free_tier` requires the `billing.read` permission. API keys with the **Admin** or **Finance** [permission level](https://docs.brightdata.com/api-reference/authentication.md#what-permissions-level-does-an-api-key-have) have it. Keys with the Ops, Limit or User permission level cannot call this endpoint. ## How do I check my free tier credits? Call `GET /trials/free_tier` with an Admin or Finance API key. The endpoint takes no parameters: ```bash theme={null} curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://api.brightdata.com/trials/free_tier" ``` The response is a JSON object with four fields: ```json theme={null} { "is_enabled": true, "included_credits": 5000, "used_credits": 3, "left_credits": 4997 } ``` To print only the credits left, filter the response with [jq](https://jqlang.org/): ```bash theme={null} curl -s -H "Authorization: Bearer YOUR_API_KEY" \ "https://api.brightdata.com/trials/free_tier" \ | jq '.left_credits' ``` ## How is the response structured? The response always contains the same four fields with the same types. The three `*_credits` fields are whole numbers, rounded from the exact credit usage: | Field | Type | Description | | - | - | - | | `is_enabled` | boolean | `true` if the free tier is enabled on your account, including when all credits are used | | `included_credits` | integer | Free credits included in the current period | | `used_credits` | integer | Free credits used in the current period | | `left_credits` | integer | Free credits left in the current period | When `is_enabled` is `false`, `included_credits`, `used_credits` and `left_credits` are all `0`. The response does not include a renewal date. Free credits always renew on the first of each month. ## How do I tell if my free tier credits are used up? Check both `is_enabled` and `left_credits`. A response with `is_enabled: true` and `left_credits: 0` means the free tier is active but this month's credits are used up. Free credits renew on the first of each month, as described in [What happens when free credits run out?](https://docs.brightdata.com/general/account/billing-and-pricing/free-tier.md#what-happens-when-free-credits-run-out). A response with `is_enabled: false` means the free tier is not enabled on your account, and all three `*_credits` fields are `0`. ## What is the rate limit for GET /trials/free\_tier? `GET /trials/free_tier` allows 600 requests per minute and 36,000 requests per hour per IP address. When you exceed the limit, Bright Data does not block or reject the request. The server holds each request for a random delay of 10 to 55 seconds, then processes it normally and returns a regular response. The response carries no rate-limit headers or other indicator that the request was delayed. If response times jump to 10 seconds or more, reduce your request rate. ## Does GET /trials/free\_tier return specific errors? No. `GET /trials/free_tier` has no endpoint-specific error codes. ## Related pages * [Free tier](https://docs.brightdata.com/general/account/billing-and-pricing/free-tier.md). Which products the 5,000 monthly free credits cover and how each product consumes them. * [Total balance](https://docs.brightdata.com/api-reference/account-management-api/Get_total_balance_through_API.md). Account balance, credit, prepayment and pending usage costs. * [Cost breakdown export](https://docs.brightdata.com/api-reference/account-management-api/Export_cost_breakdown.md). Per-day account cost by product, zone, dataset or scraper. ## OpenAPI ````yaml api-reference/openapi GET /trials/free_tier openapi: 3.0.1 info: title: Bright Data API description: >- Integrate Bright Data APIs to your pipeline and secure high-end scraping precision version: 1.0.0 servers: - url: https://api.brightdata.com security: - bearerAuth: [] paths: /trials/free_tier: get: description: >- Get the free tier credits on your account: whether the free tier is enabled and the included, used and left credits. Matches the Free credits card on the Billing overview page in the Control Panel. Takes no parameters. Requires the `billing.read` permission (API keys with the Admin or Finance permission level). Rate limit: 600 requests per minute and 36,000 requests per hour per IP address; requests over the limit are held for a random 10 to 55 seconds, then processed normally, with no rate-limit headers. operationId: getFreeTierCredits responses: '200': description: OK content: application/json: schema: type: object required: - is_enabled - included_credits - used_credits - left_credits properties: is_enabled: type: boolean description: >- `true` if the free tier is enabled on your account, including when all credits are used. When `false`, every `*_credits` field is `0`. example: true included_credits: type: integer description: >- Free credits included in the current period, as a whole number. example: 5000 used_credits: type: integer description: >- Free credits used in the current period, rounded to a whole number. example: 3 left_credits: type: integer description: >- Free credits left in the current period, rounded to a whole number. example: 4997 components: securitySchemes: bearerAuth: type: http scheme: bearer description: >- 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:** ``` Authorization: Bearer b5648e1096c6442f60a6c4bbbe73f8d2234d3d8324554bd6a7ec8f3f251f07df ``` Learn how to get your Bright Data API key: https://docs.brightdata.com/api-reference/authentication bearerFormat: API Key ````