Get a company

Returns the enrichment data of one company of your workspace: name, website, LinkedIn identifiers, locations, size, industries and a short activity summary.

A company that has not been enriched yet answers 200 OK, with the enrichment fields set to null. This endpoint never starts an enrichment.

Access modes

Use a workspace API key. The workspace is inferred from the key.

Authorization: Bearer sk_live_...

Path parameters

Parameter	Type	Description
company_id	integer	ID of the company in the workspace, as returned by the other endpoints, for example the `company.id` of a lead. Use the value the API returned to you; do not guess it or reuse one from another workspace.

Example request

curl "https://api.getsillage.com/api/v3/companies/789" \
  -H "Authorization: Bearer $SILLAGE_API_KEY"

Success response

Status: 200 OK

{
  "data": {
    "id": 789,
    "name": "Acme",
    "domain": "acme.com",
    "website_url": "https://acme.com",
    "linkedin_url": "https://www.linkedin.com/company/acme",
    "linkedin_handle": "acme",
    "logo_url": "https://example.com/acme.png",
    "location": {
      "city": "Paris",
      "region": "Île-de-France",
      "country": "France",
      "country_code": "FR"
    },
    "locations": [
      {
        "is_hq": true,
        "city": "Paris",
        "region": "Île-de-France",
        "state": null,
        "country": "France",
        "country_code": "FR",
        "postal_code": "75002",
        "line1": "1 Rue de la Paix",
        "line2": null,
        "formatted_address": "1 Rue de la Paix, 75002 Paris, France",
        "latitude": 48.8688,
        "longitude": 2.3317
      }
    ],
    "number_of_employees": 320,
    "employee_range": "201-500",
    "founded_year": 2012,
    "industries": ["Software Development", "SaaS"],
    "activity_summary": "Acme builds enterprise sales software.",
    "tagline": "Sales software that sells itself."
  }
}

Response fields

Field	Type	Description
data.id	integer	ID of the company in the workspace. The same value as in the URL.
data.name	string or null	Company name.
data.domain	string or null	Primary domain.
data.website_url	string or null	The company's website.
data.linkedin_url	string or null	LinkedIn company page URL.
data.linkedin_handle	string or null	LinkedIn company handle.
data.logo_url	string or null	Logo URL.
data.location	object or null	The company's headquarters: `{ city, region, country, country_code }`, any part `null` when unknown. `null` when the headquarters is not known.
data.locations	array	Every known location, headquarters first. Empty when none is known.
data.locations[].is_hq	boolean	`true` for the headquarters.
data.locations[].city	string or null	City.
data.locations[].region	string or null	Region.
data.locations[].state	string or null	State.
data.locations[].country	string or null	Country.
data.locations[].country_code	string or null	ISO country code.
data.locations[].postal_code	string or null	Postal code.
data.locations[].line1	string or null	First line of the street address.
data.locations[].line2	string or null	Second line of the street address, if any.
data.locations[].formatted_address	string or null	The full address as one string.
data.locations[].latitude	number or null	Latitude.
data.locations[].longitude	number or null	Longitude.
data.number_of_employees	integer or null	Number of employees.
data.employee_range	string or null	Employee headcount range, one of the persona `headcounts` values: `1-10`, `11-50`, `51-200`, `201-500`, `501-1,000`, `1,001-5,000`, `5,001-10,000` or `10,001+`. `null` when unknown.
data.founded_year	integer or null	Year the company was founded.
data.industries	array of string	The industries the company operates in. Empty when none is known.
data.activity_summary	string or null	Short summary of what the company does.
data.tagline	string or null	The company's LinkedIn tagline, a one-line headline. `null` when the company has no LinkedIn data or no tagline.

Errors

Status	Meaning
401	The API key is missing or invalid.
404	The company does not exist.
422	The `company_id` is not a valid ID, or a query parameter is sent: this route takes none, and `errors` names the parameter.
429	Rate limit exceeded.
500	An unexpected server error occurred.

Error responses use RFC 9457 problem documents with Content-Type: application/problem+json. type is always about:blank; code tells one problem from another, detail says what went wrong this time, and errors names the field at fault.