# Credits

## Overview

The API Key issued for you has a set amount of **search** and **collect** credits. Credits are deducted for **one successful (200) request** while using search or collect endpoints.

A successful request deducts a certain number of credits per request.

**Two** search or collection credits are deducted for **one successful (200) request** while using endpoints from:

* Multi-source Company API
* Multi-source Employee API

**One** search or collection credit is deducted for **one successful (200) request** while using endpoints from:

* Clean Company API
* Base Company API
* Clean Employee API
* Base Employee API
* Employee Posts API
* Base Jobs API
* Multi-source Jobs API

{% hint style="info" %}
Real-time Employee API uses different credits. Find more information in [Real-time Employee API](/employee-api/real-time-employee-api.md#credits) topic
{% endhint %}

#### Credits in Bulk Collect requests

For Bulk Collect requests, the number of credits deducted from your account depends on the data records you download. For instance, collecting 100 profiles will consume 100 credits.

Discuss your credit needs with your account manager or explore available plans in the [self-service platform](https://dashboard.coresignal.com/sign-in).

## FAQ

<details>

<summary>Where can I see my credit balance?</summary>

Every **search and collect** response contains an `x-credits-remaining` header that shows the number of credits left in your account.

<figure><img src="https://archbee-image-uploads.s3.amazonaws.com/iNaodsHbfav9t72Jx5JdM/Xh3fndrpyjUGXyoMs7qm2_image.png" alt=""><figcaption></figcaption></figure>

**Example of remaining credits header:**

```json
x-credits-remaining: 9973
```

</details>

<details>

<summary>What happens if I don't have enough credits?</summary>

If you don't have enough credits, the request in the `/v2/data_requests/{data_request_id}/files` endpoint will return the error `402` and the following response:

{% code title="Insufficient credits" %}

```json
{
    "detail": "Insufficient credits"
}
```

{% endcode %}

</details>

<details>

<summary>What happens if I submit duplicate requests?</summary>

We validate your search and Elasticsearch POST requests in Bulk Collect to prevent the submission of duplicate requests.

If you happen to submit duplicate POST requests using search or Elasticsearch filters, you will see the following error message:

{% code title="409" %}

```json
{
    "detail": "Identical data request is already in progress."
}
```

{% endcode %}

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.coresignal.com/api-introduction/credits.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.