> ## 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 Fields Search

> Retrieve full company profile including locations, industry, headcount, and more.

Returns detailed information about a company. Each successful call consumes one **company data credit**.

***

**Endpoint:** `GET https://www.signalhire.com/api/v1/company/info`

## Request Parameters

<ParamField header="apikey" type="string" required>
  Secret API key. See [Authentication](/authentication).
</ParamField>

<ParamField query="id" type="string" required>
  Company ID (numeric) or company slug. Use [Find Company](/company-api/find-company) to resolve a company name to an ID.
</ParamField>

## Request Example

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET \
  -H 'apikey: your_secret_api_key' \
  'https://www.signalhire.com/api/v1/company/info?id=1033'
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
  "https://www.signalhire.com/api/v1/company/info",
  headers={"apikey": "your_secret_api_key"},
  params={"id": "1033"}
  )
  ```

  ```javascript Node.js theme={null}
  const axios = require('axios');

  const response = await axios.get(
  'https://www.signalhire.com/api/v1/company/info',
  {
      headers: { apikey: 'your_secret_api_key' },
      params: { id: '1033' }
  }
  );
  ```

  ```java Java theme={null}
  import java.net.http.*;
  import java.net.URI;

  HttpClient client = HttpClient.newHttpClient();

  HttpRequest request = HttpRequest.newBuilder()
  .uri(URI.create("https://www.signalhire.com/api/v1/company/info?id=1033"))
  .header("apikey", "your_secret_api_key")
  .GET()
  .build();

  HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
  ```

  ```ruby Ruby theme={null}
  require 'net/http'

  uri = URI('https://www.signalhire.com/api/v1/company/info?id=1033')
  http = Net::HTTP.new(uri.host, uri.port)
  http.use_ssl = true

  request = Net::HTTP::Get.new(uri)
  request['apikey'] = 'your_secret_api_key'

  response = http.request(request)
  ```
</CodeGroup>

## Response Example (HTTP 200)

```http theme={null}
HTTP/2 200
Content-Type: application/json
X-Credits-Left: 49
```

```json theme={null}
{
    "name": "Accenture",
    "linkedInId": "1033",
    "industry": "Information Technology and Services",
    "description": "Accenture is a global professional services company...",
    "founded": 1989,
    "logo": "https://media.licdn.com/dms/image/C560BAQHx.../company-logo_200_200/...",
    "url": "https://www.linkedin.com/company/accenture",
    "website": "http://www.accenture.com",
    "phone": null,
    "type": "Public Company",
    "staffCount": 546636,
    "staffCountRange": 10001,
    "staffingCompany": false,
    "specialities": [
        "Management Consulting",
        "Systems Integration and Technology",
        "Business Process Outsourcing",
        "Application and Infrastructure Outsourcing"
    ],
    "confirmedLocations": [
        {
            "country": "IE",
            "city": "Dublin 2",
            "line1": "Grand Canal Harbour",
            "headquarter": true,
            "streetAddressOptOut": false
        },
        {
            "country": "US",
            "geographicArea": "California",
            "city": "San Francisco",
            "postalCode": "94105",
            "line1": "415 Mission Street",
            "line2": "Floor 31-34",
            "headquarter": false,
            "streetAddressOptOut": false
        }
    ]
}
```

## Response Fields

<ParamField body="name" type="string">
  Company display name.
</ParamField>

<ParamField body="linkedInId" type="string">
  Company ID.
</ParamField>

<ParamField body="industry" type="string | null">
  Primary industry category.
</ParamField>

<ParamField body="description" type="string | null">
  Company description.
</ParamField>

<ParamField body="founded" type="integer | null">
  Year the company was founded.
</ParamField>

<ParamField body="logo" type="string | null">
  URL of the company logo.
</ParamField>

<ParamField body="url" type="string | null">
  LinkedIn company page URL.
</ParamField>

<ParamField body="website" type="string | null">
  Company website URL.
</ParamField>

<ParamField body="phone" type="string | null">
  Company phone number.
</ParamField>

<ParamField body="type" type="string | null">
  Company type (e.g. `"Public Company"`, `"Private Company"`).
</ParamField>

<ParamField body="staffCount" type="integer | null">
  Approximate number of employees.
</ParamField>

<ParamField body="staffCountRange" type="integer | null">
  Employee range bucket identifier.
</ParamField>

<ParamField body="staffingCompany" type="boolean">
  Whether the company is a staffing agency.
</ParamField>

<ParamField body="specialities" type="array of strings">
  List of company specialities. May be empty.
</ParamField>

<ParamField body="confirmedLocations" type="array">
  List of confirmed office locations. Each item may contain `country`, `city`, `geographicArea`, `postalCode`, `line1`, `line2`, `description`, `headquarter`, `streetAddressOptOut`. All fields are `string | boolean | null`.
</ParamField>

## Response Codes

| Code  | Description                                              |
| ----- | -------------------------------------------------------- |
| `200` | Company data returned. One company data credit consumed. |
| `402` | No company data credits remaining.                       |
| `403` | Company API access not enabled for this account.         |
| `404` | Company not found.                                       |
| `422` | `id` parameter missing.                                  |
