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

# Check your credit usage

> View remaining credits and usage in the API Dashboard or in API response headers.

You can check credit usage in the API Dashboard or in the headers of any API response.

## Prerequisites

* A PDL account. If you don't have one, [sign up for free](https://www.peopledatalabs.com/signup).

## In the API Dashboard

To go straight to your usage, open the [Usage tab](https://dashboard.peopledatalabs.com/usage). You can also navigate there yourself:

1. Sign in to the [API Dashboard](https://dashboard.peopledatalabs.com/).

2. In the navigation menu, click **Account** > **Usage**.

3. Select the API you want to check from the **Product** dropdown at the top of the page.

   ![Selecting an API from the Product dropdown at the top of the Usage page](https://mintcdn.com/peopledatalabs/2B0467ndUCrof5ON/images/docs/api-dashboard-usage-endpoint-dropdown.gif?s=66ff57d5263e5d261ee2d8861bec80a1)

The Usage page has two sections for the selected API:

* **Current term metrics**: Total credits used, total credits remaining, and percent usage for your current term.
* **Usage explorer**: API calls over time, split into found (`200`), not found (`404`), and error (`4XX`) responses, with your match rate and error rate. Use **Date range** to set the time frame and **View by** to group results by hour, day, week, month, or year. Date ranges longer than 90 days can only be grouped by month or year. Click **Download** to export the data.

![Usage page showing current term metrics and the usage explorer chart for the Person Enrichment API](https://mintcdn.com/peopledatalabs/2B0467ndUCrof5ON/images/docs/api-dashboard-usage-stats.png?fit=max\&auto=format\&n=2B0467ndUCrof5ON\&q=85\&s=e4dc4994f3ac60a6e47a2f17c19db46e)

## In response headers

Each API response includes credit headers. These are the most useful for tracking usage:

| Header | Description |
| - | - |
| `x-call-credits-spent` | Credits billed for this call |
| `x-totallimit-remaining` | Total credits available, including purchased and overage credits |
| `x-totallimit-purchased-remaining` | Purchased credits remaining |
| `x-lifetime-used` | Credits used over your account's lifetime |

For the full list, see [Usage limits](https://docs.peopledatalabs.com/docs/usage-limits.md#header-field-descriptions).


## Related topics

- [Usage Limits](https://docs.peopledatalabs.com/docs/usage-limits.md)
- [Fix 402 out-of-credit errors](https://docs.peopledatalabs.com/support/troubleshooting/out-of-credits.md)
- [Plans and credits](https://docs.peopledatalabs.com/support/billing/index.md)
- [How credits work](https://docs.peopledatalabs.com/support/billing/how-credits-work.md)
- [Support](https://docs.peopledatalabs.com/support/index.md)
