Skip to main content
GET
/
public
/
v1
/
companies
/
{companyId}
Get a single scored company by id
curl --request GET \
  --url http://app.stairoids.com/api/public/v1/companies/{companyId} \
  --header 'X-Api-Key: <api-key>'
{
  "companyId": 4521,
  "name": "Acme Corp",
  "domain": "acme.com",
  "industry": "Software",
  "country": "Netherlands",
  "city": "Amsterdam",
  "employeeCount": 250,
  "companySize": "201-500",
  "linkedInUrl": "https://www.linkedin.com/company/acme",
  "totalScore": 87,
  "icpMatched": true,
  "icpId": 7,
  "icpName": "Mid-market SaaS",
  "rankedLeadScoreId": 55231,
  "logoUrl": "<string>",
  "funnelStageId": 12,
  "funnelStage": "Hot",
  "labels": [
    {
      "id": 5,
      "name": "Strategic",
      "color": "#73d89c",
      "userGenerated": true
    }
  ],
  "latestActivityTimestamp": 1719500000000
}

Authorizations

​
X-Api-Key
string
header
required

Your organization's public API key. Manage it at GET /api/user/public-api-key.

Path Parameters

​
companyId
integer<int64>
required

Response

OK

A company in your pipeline, with its current intent / lead score.

​
companyId
integer<int64>

Company id. Use with GET /public/v1/companies/{companyId}.

Example:

4521

​
name
string

Company name.

Example:

"Acme Corp"

​
domain
string

Primary domain.

Example:

"acme.com"

​
industry
string

Industry.

Example:

"Software"

​
country
string

Country.

Example:

"Netherlands"

​
city
string

City.

Example:

"Amsterdam"

​
employeeCount
integer<int32>

Employee count, if known.

Example:

250

​
companySize
string | null

LinkedIn-reported employee size bucket, if known.

Example:

"201-500"

​
linkedInUrl
string

LinkedIn company URL.

Example:

"https://www.linkedin.com/company/acme"

​
totalScore
integer<int32>

Total intent / lead score (higher = hotter).

Example:

87

​
icpMatched
boolean

Whether the company currently matches one of your ICPs.

Example:

true

​
icpId
integer<int64> | null

Matched ICP id, if any.

Example:

7

​
icpName
string | null

Matched ICP name, if any.

Example:

"Mid-market SaaS"

​
rankedLeadScoreId
integer<int64>

Ranked-lead-score row id (the lead-score record for this company).

Example:

55231

​
logoUrl
string | null

Company logo URL.

​
funnelStageId
integer<int64> | null

Current funnel stage id.

Example:

12

​
funnelStage
string | null

Current funnel stage name.

Example:

"Hot"

​
labels
object[]

Labels applied to this company.

​
latestActivityTimestamp
integer<int64> | null

Last activity timestamp, epoch millis.

Example:

1719500000000