# Credits and Usage

API requests consume credits from your account's yearly allocation.

## Credit Consumption by Endpoint

| Endpoint | Consumes Credits | Description |
|  --- | --- | --- |
| **Company Enrich** (`/companies/enrich`) | Yes | Credits depend on field groups requested and data returned |
| **Company Search** (`/companies/search`) | No | Discover companies by filter; requires positive balance |
| **Company Match** (`/companies/match`) | No | Resolve companies by name, domain, or country |
| **Catalog** (`/catalog/*`) | No | Browse vendors, products, categories, and taxonomy data |
| **Credits** (`/credits`) | No | Check your current credit balance |


Endpoints that don't consume credits still require a positive balance on your account. Contact your account manager for details on credit pricing.

## Checking Your Balance

### Via Credits API

Monitor your balance programmatically — useful for pre-checking before large batch jobs, automated alerts when your balance is low, or pulling credit data into your own reporting tools.


```bash
curl https://api.hginsights.com/data-api/v2/credits \
  -H "Authorization: Bearer $HG_API_KEY"
```


```json
{
  "credits": {
    "total": 100000,
    "used": 34250,
    "remaining": 65750
  }
}
```

### Via Credit Dashboard

If you have access to the [HG Admin Portal](https://admin.hginsights.com), go to **Settings** > **Credits Usage** to see your balance, usage history, and request more credits. Not all accounts have dashboard access — contact your account manager to get it enabled.

## Need More Credits?

From the Credit Dashboard, click **Request more credits**, or reach out directly to your account manager.