> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bloklake.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Account

> GET /v1/account: your key's plan, limit, status and balance or usage.

```http theme={null}
GET https://api.bloklake.com/v1/chains/{chain}/v1/account
Authorization: Bearer <key>
```

Free: not billed and not counted toward your rate limit. Use it to check a key before a large
job, or to monitor a pay-as-you-go balance.

## Example

```bash theme={null}
curl https://api.bloklake.com/v1/chains/eth/v1/account -H "Authorization: Bearer $BLOKLAKE_API_KEY"
```

```json theme={null}
{
  "key_id": "k_…",
  "project_id": "p_…",
  "plan": "standard",
  "status": "active",
  "rps": 10,
  "balance_micro": null,
  "bytes_used": 412345678901,
  "quota_bytes": 1200000000000,
  "usage_period": "1760486400",
  "blocked_for_secs": null
}
```

## Response

**plan** `string`

`payg`, `standard` or `custom`.

**status** `string`

`active`, `suspended` or `revoked`.

**rps** `integer`

Requests per second allowed, across all chains.

**balance\_micro** `integer | null`

Pay-as-you-go: the balance left, in millionths of a dollar (`36290000` = \$36.29). `null` on a
subscription.

**bytes\_used** `integer | null`

Subscription: data the whole project was billed this period. `null` on pay-as-you-go.

**quota\_bytes** `integer | null`

Subscription: the most the project may use this period (included data plus what the overage
limit buys). Requests get `402 overage_limit_reached` beyond it.

**usage\_period** `string | null`

Subscription: start of the current period, Unix seconds.

**blocked\_for\_secs** `integer | null`

Seconds left while the key is blocked (`key_blocked`); otherwise `null`.

**key\_id** `string`

The key's id.

**project\_id** `string`

The key's project.

## Example: stop before running out

```python theme={null}
acct = session.get(f"{BASE}/v1/account").json()
if acct["plan"] == "payg" and acct["balance_micro"] < 5_000_000:
    alert("Bloklake balance below $5")
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.