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

# Company API Overview

> Company API — look up companies, get employee counts, and retrieve full company profiles.

The Company API provides access to company data from SignalHire's database. It allows looking up companies by identifier, checking how many profiles are associated with a company, retrieving full company details, and fetching employee profiles via callback.

<Warning>
  The Company API is not enabled by default. To request access, contact [support@signalhire.com](mailto:support@signalhire.com).
</Warning>

## Available Endpoints

| Endpoint                      | Description                                                                |
| ----------------------------- | -------------------------------------------------------------------------- |
| `/api/v1/company/findById`    | Look up a company by ID or slug. No credits consumed.                      |
| `/api/v1/company/getCount`    | Get the number of profiles associated with a company. No credits consumed. |
| `/api/v1/company/info`        | Get full company details. Consumes company data credits.                   |
| `/api/v1/company/getProfiles` | Fetch employee profiles via callback. Consumes daily profile-view quota.   |

## Credits & Quotas

* **Company data credits** — consumed by `/company/info`. Each successful call consumes one credit. Contact [support@signalhire.com](mailto:support@signalhire.com) to purchase. The `X-Credits-Left` header in the response reflects the remaining balance.
* **Daily profile-view quota** — `/company/getProfiles` draws from the same daily quota used when viewing candidate profiles on the SignalHire website. It varies by plan, up to **2000 profiles/day**, and is not a purchasable credit type — the response does not include a credits header. When the quota is exhausted, the endpoint returns HTTP `429`. Contact [support@signalhire.com](mailto:support@signalhire.com) if a higher limit is needed.

`/company/findById` and `/company/getCount` consume neither credits nor quota.
