Get Prospect Company
curl --request GET \
--url https://api.example.com/api/v1/entities/prospects/company/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.example.com/api/v1/entities/prospects/company/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.example.com/api/v1/entities/prospects/company/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/v1/entities/prospects/company/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/entities/prospects/company/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/api/v1/entities/prospects/company/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/entities/prospects/company/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"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": {
"code": "NOT_FOUND",
"message": "Company with id 550e8400-e29b-41d4-a716-446655440000 not found"
}
}
Prospects
Get Prospect Company
Retrieves a company associated with a prospect by its unique identifier
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>'import requests
url = "https://api.example.com/api/v1/entities/prospects/company/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.example.com/api/v1/entities/prospects/company/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/v1/entities/prospects/company/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/entities/prospects/company/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/api/v1/entities/prospects/company/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/entities/prospects/company/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"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": {
"code": "NOT_FOUND",
"message": "Company with id 550e8400-e29b-41d4-a716-446655440000 not found"
}
}
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
string
required
The unique identifier (UUID) of the company to retrieve.
Response
Returns a company object with all available fields.string
required
Unique identifier (UUID) for the company.
string
required
The company name.
string | null
Full description of the company, typically sourced from LinkedIn or company
website.
string | null
AI-generated or curated summary of the company.
string | null
Employee count range (e.g., “51-200”, “1001-5000”).
string | null
Primary industry classification.
array
Array of headquarters phone numbers.
string | null
LinkedIn company profile URL.
string | null
Company website URL.
string | null
Company domain (extracted from website URL).
string | null
Headquarters city.
string | null
Headquarters postal code.
string | null
Headquarters country.
string | null
URL to the company logo image.
string | null
Official legal name of the company.
number | null
Year the company was founded.
string | null
Revenue range or estimate.
object | null
Detailed location information.
Show Location object properties
Show Location object properties
object | null
Headquarters location details.
array
Array of additional office locations with the same structure as headquarter.
string | null
Internal provider identifier for this company.
number | null
Bullhorn CRM identifier for this company.
string | null
Generic CRM identifier for this company.
string | null
ISO 8601 timestamp of when the company record was created.
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": {
"code": "NOT_FOUND",
"message": "Company with id 550e8400-e29b-41d4-a716-446655440000 not found"
}
}
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.