Skip to main content
POST
/
public
/
v1
/
companies
/
by-ids
Get scored companies by id
curl --request POST \
  --url http://app.stairoids.com/api/public/v1/companies/by-ids \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '[
  123
]'
[
  {
    "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.

Body

application/json

Response

OK

​
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