API v3 is live and in beta: expect possible malfunctions and breaking changes in the coming days. If you find a bug, please report it to your Sillage contact.

Get a company

Retrieve a company's data by its ID.

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.

Route

GET/api/v3/companies/{company_id}

Access modes

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

Authorization: Bearer sk_live_...

Path parameters

ParameterTypeDescription
company_idintegerID 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": {
    "identification": { "status": "identified", "suggested_company": null },
    "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

FieldTypeDescription
data.idintegerID of the company in the workspace. The same value as in the URL.
data.identificationobjectWhether we know the company on LinkedIn.
data.identification.statusstringidentifying (we are looking for its LinkedIn page), identified (it is linked to a LinkedIn page), to_confirm (we found a page that may be the right one but could not confirm it, see suggested_company) or not_identified (we found no page). New values may be added; ignore values you don't know.
data.identification.suggested_companyobject or nullThe page we found, only while status is to_confirm; null otherwise.
data.identification.suggested_company.linkedin_urlstringThe LinkedIn page we found. Send it to the route that sets a company's LinkedIn page to use it.
data.identification.suggested_company.namestring or nullName on the page.
data.identification.suggested_company.website_urlstring or nullThe website the page lists.
data.identification.suggested_company.industrystring or nullIndustry on the page.
data.identification.suggested_company.employee_rangestring or nullEmployee headcount range, for example 51-200.
data.namestring or nullCompany name.
data.domainstring or nullPrimary domain.
data.website_urlstring or nullThe company's website.
data.linkedin_urlstring or nullLinkedIn company page URL.
data.linkedin_handlestring or nullLinkedIn company handle.
data.logo_urlstring or nullLogo URL.
data.locationobject or nullThe company's headquarters: { city, region, country, country_code }, any part null when unknown. null when the headquarters is not known.
data.locationsarrayEvery known location, headquarters first. Empty when none is known.
data.locations[].is_hqbooleantrue for the headquarters.
data.locations[].citystring or nullCity.
data.locations[].regionstring or nullRegion.
data.locations[].statestring or nullState.
data.locations[].countrystring or nullCountry.
data.locations[].country_codestring or nullISO country code.
data.locations[].postal_codestring or nullPostal code.
data.locations[].line1string or nullFirst line of the street address.
data.locations[].line2string or nullSecond line of the street address, if any.
data.locations[].formatted_addressstring or nullThe full address as one string.
data.locations[].latitudenumber or nullLatitude.
data.locations[].longitudenumber or nullLongitude.
data.number_of_employeesinteger or nullNumber of employees.
data.employee_rangestring or nullEmployee 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_yearinteger or nullYear the company was founded.
data.industriesarray of stringThe industries the company operates in. Empty when none is known.
data.activity_summarystring or nullShort summary of what the company does.
data.taglinestring or nullThe company's LinkedIn tagline, a one-line headline. null when the company has no LinkedIn data or no tagline.

Errors

StatusMeaning
401The API key is missing or invalid.
402Your workspace has no active plan (paywall_required). Start your trial or choose a plan at https://www.getsillage.com/paywall, then retry.
404The company does not exist.
422The company_id is not a valid ID, or a query parameter is sent: this route takes none, and errors names the parameter.
429Rate limit exceeded.
500An 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.

On this page