Get company

Retrieves the data for one company, identified by the company_id returned in a signal payload.

If the company has not been enriched yet, the response still returns the object, with the enrichment fields set to null.

Route

GET/api/v2/companies/{id}

Path parameters

Parameter	Type	Description
id	integer	The `company_id` from a signal payload. Must be greater than or equal to 1.

Example request

curl "https://api.getsillage.com/api/v2/companies/456" \
  -H "Authorization: Bearer sk_live_..."

Success response

Status: 200 OK

{
  "name": "Acme",
  "domain": "acme.com",
  "url": "https://acme.com",
  "linkedin_url": "https://www.linkedin.com/company/acme",
  "linkedin_handle": "acme",
  "logo_url": "https://example.com/logo.png",
  "location": "Paris, France",
  "locations": [
    {
      "is_hq": true,
      "city": "Paris",
      "region": "Ile-de-France",
      "state": null,
      "country": "France",
      "country_code": "FR",
      "postal_code": "75002",
      "line1": "10 Rue de la Paix",
      "line2": null,
      "formatted_address": "10 Rue de la Paix, 75002 Paris, France",
      "latitude": 48.8698,
      "longitude": 2.3312
    },
    {
      "is_hq": false,
      "city": "Lyon",
      "region": "Auvergne-Rhone-Alpes",
      "state": null,
      "country": "France",
      "country_code": "FR",
      "postal_code": "69002",
      "line1": "5 Rue de la Republique",
      "line2": null,
      "formatted_address": "5 Rue de la Republique, 69002 Lyon, France",
      "latitude": 45.7597,
      "longitude": 4.8422
    }
  ],
  "number_of_employees": 250,
  "employee_range": "201-500",
  "founded_year": 2010,
  "industries": "Software",
  "activity_summary": "Acme builds enterprise sales software."
}

Response headers

Header	Description
X-Request-Id	Request UUID for debugging and support.
X-Response-Time	Server response time.

Response fields

Field	Type	Description
name	string or null	Company name.
domain	string or null	Primary domain.
url	string or null	Company website URL.
linkedin_url	string or null	LinkedIn company page URL.
linkedin_handle	string or null	LinkedIn handle.
logo_url	string or null	Logo image URL.
location	string or null	Company location.
locations	array of objects	The company's known locations, headquarters first. `is_hq` marks the headquarters.
locations[].is_hq	boolean	Whether this location is the headquarters.
locations[].city	string or null	City.
locations[].region	string or null	Region.
locations[].state	string or null	State.
locations[].country	string or null	Country.
locations[].country_code	string or null	ISO country code, for example `FR`.
locations[].postal_code	string or null	Postal code.
locations[].line1	string or null	Street address, line 1.
locations[].line2	string or null	Street address, line 2.
locations[].formatted_address	string or null	Full formatted address.
locations[].latitude	number or null	Latitude.
locations[].longitude	number or null	Longitude.
number_of_employees	integer or null	Employee headcount.
employee_range	string or null	Employee headcount range, for example `201-500`.
founded_year	integer or null	Year the company was founded.
industries	string or null	Industries the company operates in.
activity_summary	string or null	Short summary of what the company does.

All fields are null when the company has not been enriched yet.

Errors

Status	Meaning
401	The API key is missing or invalid.
404	The company was not found or does not belong to this workspace.
500	An unexpected server error occurred.

Error responses use RFC 9457 problem documents with Content-Type: application/problem+json:

{
  "type": "https://docs.getsillage.com/errors/not-found",
  "title": "Not Found",
  "status": 404,
  "detail": "Company not found.",
  "instance": "/api/v2/companies/456"
}