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

# Get Credit Balance

> Check your remaining credit balance

## Request

No query parameters required. Authenticate with your API key.

### Headers

| Name        | Required | Description  |
| ----------- | -------- | ------------ |
| `x-api-key` | Yes      | Your API key |

## Response

<ResponseField name="credits_remaining" type="number">
  The number of credits remaining on your API key.
</ResponseField>

## Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -H "x-api-key: sk-your-api-key" \
    https://api.scraper.creatorlookup.com/v1/credit-balance
  ```

  ```javascript JavaScript theme={null}
  const res = await fetch(
    "https://api.scraper.creatorlookup.com/v1/credit-balance",
    { headers: { "x-api-key": "sk-your-api-key" } }
  );
  const { credits_remaining } = await res.json();
  console.log(`Credits remaining: ${credits_remaining}`);
  ```

  ```python Python theme={null}
  import requests

  res = requests.get(
      "https://api.scraper.creatorlookup.com/v1/credit-balance",
      headers={"x-api-key": "sk-your-api-key"},
  )
  print(f"Credits remaining: {res.json()['credits_remaining']}")
  ```
</CodeGroup>

### 200 — Success

```json theme={null}
{
  "credits_remaining": 9500
}
```

### 401 — Unauthorized

```json theme={null}
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing x-api-key header"
  }
}
```
