Skip to main content
GET
/
api
/
v1
/
entities
/
prospects
/
company
/
{id}
Get Prospect Company
curl --request GET \
  --url https://api.example.com/api/v1/entities/prospects/company/{id} \
  --header 'Authorization: Bearer <token>'
{
  "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"
}
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

​
id
string
required
The unique identifier (UUID) of the company to retrieve.

​
Response

Returns a company object with all available fields.
​
id
string
required
Unique identifier (UUID) for the company.
​
name
string
required
The company name.
​
description
string | null
Full description of the company, typically sourced from LinkedIn or company website.
​
summary
string | null
AI-generated or curated summary of the company.
​
headcount
string | null
Employee count range (e.g., “51-200”, “1001-5000”).
​
industry
string | null
Primary industry classification.
​
phones
array
Array of headquarters phone numbers.
​
linkedinUrl
string | null
LinkedIn company profile URL.
​
websiteUrl
string | null
Company website URL.
​
domain
string | null
Company domain (extracted from website URL).
​
city
string | null
Headquarters city.
​
postalCode
string | null
Headquarters postal code.
​
country
string | null
Headquarters country.
​
logoUrl
string | null
URL to the company logo image.
​
legalName
string | null
Official legal name of the company.
​
foundedYear
number | null
Year the company was founded.
​
revenue
string | null
Revenue range or estimate.
​
location
object | null
Detailed location information.
​
baseProviderId
string | null
Internal provider identifier for this company.
​
bullhornId
number | null
Bullhorn CRM identifier for this company.
​
crmId
string | null
Generic CRM identifier for this company.
​
createdAt
string | null
ISO 8601 timestamp of when the company record was created.
​
updatedAt
string | null
ISO 8601 timestamp of when the company record was last updated.

​
Response Examples

{
  "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"
}

​
Error Codes

Status CodeError CodeDescription
404NOT_FOUNDNo company exists with the specified ID.
500INTERNAL_ERRORAn 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.