# GET Requests

{% columns %}
{% column width="16.666666666666664%" %}
Data type:

URLs:
{% endcolumn %}

{% column %}
Base Company; Clean Employee; Base Employee; Base Jobs

<https://api.coresignal.com/cdapi/v2/data\\_requests/{data\\_request\\_id}/files\\>
<https://api.coresignal.com/cdapi/v2/data\\_requests/{data\\_request\\_id}/files/{file\\_name}>
{% endcolumn %}
{% endcolumns %}

***

## Overview

Send a GET request to each of the specified GET endpoints to retrieve data in bulk:

1. Make a query in the `/v2/data_requests/{data_request_id}/files` endpoint to see the status of your data request. Collect the file name to use further.
2. Collect the data request ID and the file name. Make a query in the `/v2/data_requests/{data_request_id}/files/{file_name}` endpoint and download the data in a JSON.gz file.

{% hint style="info" %}
You can download the prepared dataset as many times as you like within 30 days of the query submission.
{% endhint %}

***

## Instructions

### GET the file name

Send a GET request to the endpoint `/v2/data_requests/{data_request_id}/files` to see the status of your data request.&#x20;

#### Endpoint usage

1. Take the data `request ID` (obtained from any of the POST endpoints). Paste it in the following cURL request instead of `{request_id}` and your API Key instead of `{API Key}`:

{% code title="Request body template" %}

```json
curl -X 'GET' \
'https://api.coresignal.com/cdapi/v2/data_requests/{data_request_id}/files' \
-H 'accept: application/json' \
-H 'apikey: {API Key}'
```

{% endcode %}

2. Import the cURL request to any API-compatible application.
3. Send the request.

* If you do not see a file name, the data request is not ready. Send the request again until you can see the file name.

4. Retrieve the file name.

{% code title="File name example" %}

```json
{
  "data_request_files": [
    "json/part-00000-2c3d41c2-99c2-43ff-a39c-7ad7h63h7cd9-h000.json.gz"
  ]
}
```

{% endcode %}

* Each JSON.gz file contains a maximum of 10,000 JSON records. Requests that exceed the limit will be rejected.

#### Insufficient credits

The following message indicates that your query is too expensive.

{% hint style="info" %}
Try adding `"limit": {integer}` parameter to your query.
{% endhint %}

{% code title="Insufficient credits" %}

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

{% endcode %}

***

### GET the file

Request downloadable files by making a GET request to the `/v2/data_requests/{data_request_id}/files/{file_name}` endpoint.

#### Endpoint usage

1. Paste the data `request ID` and `file name` in the following template. Use your API Key instead of `{API Key}`:

{% code title="Request body template" %}

```json
curl -X 'GET' \
'https://api.coresignal.com/cdapi/v2/data_requests/{data_request_id}/files/{file_name}' \
  -H 'accept: application/json' \
  -H 'apikey: {API Key}'
```

{% endcode %}

{% hint style="info" %}
The data request ID is obtained via the POST requests.\
The file name is obtained using the data request ID in the */v2/data\_requests/{data\_request\_id}/files* endpoin&#x74;*.*
{% endhint %}

2. Import the cURL to any API-compatible application.
3. Send the request
4. Download the data

Check for similar methods to retrieve the file using other API-compatible applications.


---

# 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/requests/bulk-collect/get-requests.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.