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

# Get Prospect Company

> Retrieves a company associated with a prospect by its unique identifier

Retrieves detailed information about a specific company from the global company database. This endpoint is used within the prospecting context to fetch company data associated with prospects and leads.

Companies are shared across all organizations and contain enriched data aggregated from multiple lead providers.

## Authentication

This endpoint does not require authentication. Company data is publicly accessible within the Lance platform.

## Request

<ParamField path="id" type="string" required>
  The unique identifier (UUID) of the company to retrieve.
</ParamField>

## Response

Returns a company object with all available fields.

<ResponseField name="id" type="string" required>
  Unique identifier (UUID) for the company.
</ResponseField>

<ResponseField name="name" type="string" required>
  The company name.
</ResponseField>

<ResponseField name="description" type="string | null">
  Full description of the company, typically sourced from LinkedIn or company
  website.
</ResponseField>

<ResponseField name="summary" type="string | null">
  AI-generated or curated summary of the company.
</ResponseField>

<ResponseField name="headcount" type="string | null">
  Employee count range (e.g., "51-200", "1001-5000").
</ResponseField>

<ResponseField name="industry" type="string | null">
  Primary industry classification.
</ResponseField>

<ResponseField name="phones" type="array">
  Array of headquarters phone numbers.
</ResponseField>

<ResponseField name="linkedinUrl" type="string | null">
  LinkedIn company profile URL.
</ResponseField>

<ResponseField name="websiteUrl" type="string | null">
  Company website URL.
</ResponseField>

<ResponseField name="domain" type="string | null">
  Company domain (extracted from website URL).
</ResponseField>

<ResponseField name="city" type="string | null">
  Headquarters city.
</ResponseField>

<ResponseField name="postalCode" type="string | null">
  Headquarters postal code.
</ResponseField>

<ResponseField name="country" type="string | null">
  Headquarters country.
</ResponseField>

<ResponseField name="logoUrl" type="string | null">
  URL to the company logo image.
</ResponseField>

<ResponseField name="legalName" type="string | null">
  Official legal name of the company.
</ResponseField>

<ResponseField name="foundedYear" type="number | null">
  Year the company was founded.
</ResponseField>

<ResponseField name="revenue" type="string | null">
  Revenue range or estimate.
</ResponseField>

<ResponseField name="location" type="object | null">
  Detailed location information.

  <Expandable title="Location object properties">
    <ResponseField name="headquarter" type="object | null">
      Headquarters location details.

      <Expandable title="Headquarter properties">
        <ResponseField name="continent" type="string | null">
          Continent name.
        </ResponseField>

        <ResponseField name="country" type="string | null">
          Country name.
        </ResponseField>

        <ResponseField name="state" type="string | null">
          State or region.
        </ResponseField>

        <ResponseField name="city" type="string | null">
          City name.
        </ResponseField>

        <ResponseField name="street" type="string | null">
          Street address.
        </ResponseField>

        <ResponseField name="postalCode" type="string | null">
          Postal code.
        </ResponseField>

        <ResponseField name="rawAddress" type="string | null">
          Raw address string.
        </ResponseField>

        <ResponseField name="coordinates" type="object | null">
          Geographic coordinates with `lat` and `lng` properties.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="locations" type="array">
      Array of additional office locations with the same structure as headquarter.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="baseProviderId" type="string | null">
  Internal provider identifier for this company.
</ResponseField>

<ResponseField name="bullhornId" type="number | null">
  Bullhorn CRM identifier for this company.
</ResponseField>

<ResponseField name="crmId" type="string | null">
  Generic CRM identifier for this company.
</ResponseField>

<ResponseField name="createdAt" type="string | null">
  ISO 8601 timestamp of when the company record was created.
</ResponseField>

<ResponseField name="updatedAt" type="string | null">
  ISO 8601 timestamp of when the company record was last updated.
</ResponseField>

## Response Examples

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Acme Corporation",
    "description": "Acme Corporation is a global leader in innovative solutions...",
    "summary": "Enterprise software company specializing in sales automation",
    "headcount": "1001-5000",
    "industry": "Computer Software",
    "phones": ["+1-555-123-4567"],
    "linkedinUrl": "https://www.linkedin.com/company/acme-corp",
    "websiteUrl": "https://acme.com",
    "domain": "acme.com",
    "city": "San Francisco",
    "postalCode": "94105",
    "country": "United States",
    "logoUrl": "https://cdn.example.com/logos/acme.png",
    "legalName": "Acme Corporation Inc.",
    "foundedYear": 2010,
    "revenue": "$50M-$100M",
    "location": {
      "headquarter": {
        "continent": "North America",
        "country": "United States",
        "state": "California",
        "city": "San Francisco",
        "street": "123 Market Street",
        "postalCode": "94105",
        "rawAddress": "123 Market Street, San Francisco, CA 94105",
        "coordinates": {
          "lat": 37.7749,
          "lng": -122.4194
        }
      },
      "locations": []
    },
    "baseProviderId": "baseProvider_xyz789",
    "bullhornId": 12345,
    "crmId": null,
    "createdAt": "2024-01-15T10:30:00.000Z",
    "updatedAt": "2024-01-20T14:22:00.000Z"
  }
  ```

  ```json 404 theme={null}
  {
    "error": {
      "code": "NOT_FOUND",
      "message": "Company with id 550e8400-e29b-41d4-a716-446655440000 not found"
    }
  }
  ```
</ResponseExample>

## Error Codes

| Status Code | Error Code       | Description                              |
| ----------- | ---------------- | ---------------------------------------- |
| 404         | `NOT_FOUND`      | No company exists with the specified ID. |
| 500         | `INTERNAL_ERROR` | An unexpected server error occurred.     |

## Notes

This endpoint retrieves a company by its ID from the global company database, provided under the `/prospects/` path for the prospecting feature context.