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

# Get Credits

> Get current credit balance and information

## Endpoint

```
GET https://api.documind.cloud/api/v1/usage/credits
```

## Authentication

Requires `usage:read` scope.

## Response

```json theme={null}
{
  "user_id": "user-id",
  "total_credits": 1000,
  "available_credits": 750,
  "lifetime_credits": 5000,
  "is_credit_limited": false,
  "alert_threshold": 100,
  "subscription_tier": "Professional",
  "last_daily_refresh": "2024-01-15T00:00:00Z",
  "last_credit_update": "2024-01-15T14:30:00Z"
}
```

## Examples

<CodeGroup>
  ```python Python theme={null}
  response = requests.get(
      "https://api.documind.cloud/api/v1/usage/credits",
      headers={"X-API-Key": API_KEY}
  )

  credits = response.json()
  print(f"Available: {credits['available_credits']}")
  print(f"Total: {credits['total_credits']}")
  ```

  ```javascript Node.js theme={null}
  const response = await axios.get(
    'https://api.documind.cloud/api/v1/usage/credits',
    { headers: { 'X-API-Key': API_KEY } }
  );

  console.log(`Available: ${response.data.available_credits}`);
  ```
</CodeGroup>