# Collect: Base Company API

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

URLs:
{% endcolumn %}

{% column %}
Base Company

<https://api.coresignal.com/cdapi/v2/company\\_base/collect/{company\\_id}\\>
<https://api.coresignal.com/cdapi/v2/company\\_base/collect/{profile\\_url/shorthand\\_name}>
{% endcolumn %}
{% endcolumns %}

***

## Overview

Find instructions for collection endpoint usage and data collection.

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>General information about collect requests</td><td><a href="../../../api-introduction/requests/collect">collect</a></td></tr></tbody></table>

Use the collection endpoints to collect Base Company data using IDs, profile URLs or shorthand names.

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><a href="#collection-using-ids">Data collection using IDs</a></td><td>Learn how to obtain Base Company data using IDs</td></tr><tr><td><a href="#collection-using-shorthand-names">Data collection using profile URLs or shorthand names</a></td><td>Learn how to obtain Base Company data using profile URLs or shorthand names</td></tr></tbody></table>

| Key            | Collect endpoint                                           | Function                                                                               |
| -------------- | ---------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| Company ID     | */v2/company\_base/collect/{company\_id}*                  | Collect Base Company data using company IDs (retrieved using company search endpoints) |
| Shorthand name | */v2/company\_base/collect/{profile\_url/shorthand\_name}* | Collect Base Company data using profile URLs or shorthand names taken from the URLs    |

## Collection using IDs

Examples in this article are prepared using Postman.

However, you can use the most convenient tool: terminal, Postman, or any API-compatible application.

### cURL (Postman)

Use the provided request template below. Enter a valid `company_id` value and your `API Key`.

{% tabs %}
{% tab title="Full collect" %}
{% code title="cURL request" %}

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

{% endcode %}
{% endtab %}

{% tab title="Field selection" %}
{% code title="cURL request example with several fields" %}

```json
curl -X 'GET' \
'https://api.coresignal.com/cdapi/v2/company_base/collect/{company_id}?fields=id&fields=name&fields=created' \
  -H 'accept: application/json' \
  -H 'apikey: {API Key}'
```

{% endcode %}
{% endtab %}
{% endtabs %}

## Collection using profile URLs or shorthand names

Examples in this article are prepared using Postman.

However, you can use the tool that is most convenient for you: terminal, Postman, or any API-compatible application.

### cURL (Postman)

Use the provided request template below. Enter a valid `profile_url` or `shorthand_name` value and your `API Key`.

{% tabs %}
{% tab title="Full collect" %}
{% code title="cURL request example" %}

```json
curl -X 'GET' \
'https://api.coresignal.com/cdapi/v2/company_base/collect/{profile_url/shorthand_name}' \
  -H 'accept: application/json' \
  -H 'apikey: {API Key}'
```

{% endcode %}
{% endtab %}

{% tab title="Field selection" %}
{% code title="cURL request example with several fields" %}

```json
curl -X 'GET' \
'https://api.coresignal.com/cdapi/v2/company_base/collect/{profile_url/shorthand_name}?fields=id&fields=name&fields=created' \
  -H 'accept: application/json' \
  -H 'apikey: {API Key}'
```

{% endcode %}
{% endtab %}
{% endtabs %}