Skip to main content
GET
/
companies
/
{id}
Get company
curl --request GET \
  --url https://productlane.com/api/v1/companies/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "name": "<string>",
  "domains": [
    "<string>"
  ],
  "externalIds": [
    "<string>"
  ],
  "autoAdd": true,
  "size": 123,
  "revenue": 123,
  "tierId": "<string>",
  "statusId": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "workspaceId": "<string>",
  "contacts": [
    {
      "id": "<string>",
      "name": "<string>",
      "email": "<string>"
    }
  ],
  "upvotes": 123
}

​
Get Company

Retrieve a specific company by its ID. You can optionally group upvotes to get aggregated vote counts.

​
Path Parameters

​
id
string
required
Unique identifier of the company

​
Query Parameters

​
groupUpvotes
boolean
Whether to group upvotes and return aggregated counts

​
Response

​
id
string
Unique identifier for the company
​
name
string
Company name
​
domains
string[]
List of domains associated with the company
​
externalIds
string[]
External IDs for the company
​
autoAdd
boolean
Whether to automatically add contacts with matching domains
​
size
number
Company size (number of employees)
​
revenue
number
Annual revenue
​
tierId
string
Linear customer tier ID
​
statusId
string
Linear customer status ID
​
createdAt
string
Timestamp when the company was created
​
updatedAt
string
Timestamp when the company was last updated
​
workspaceId
string
ID of the workspace this company belongs to
​
contacts
object[]
Array of contacts associated with this company
​
contacts[].id
string
Contact ID
​
contacts[].name
string
Contact name
​
contacts[].email
string
Contact email address
​
upvotes
integer
Total number of upvotes for this company (only when groupUpvotes=true)

​
Example Request

GET /api/v1/companies/comp_123456789?groupUpvotes=true

​
Example Response

{
  "id": "comp_123456789",
  "name": "Acme Corp",
  "domains": ["acme.com", "acme.io"],
  "externalIds": ["ACME-001"],
  "autoAdd": true,
  "size": 50,
  "revenue": 1000000,
  "tierId": "tier_123",
  "statusId": "status_456",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z",
  "workspaceId": "ws_123456789",
  "contacts": [
    {
      "id": "contact_123",
      "name": "John Doe",
      "email": "john@acme.com"
    }
  ],
  "upvotes": 15
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Query Parameters

​
groupUpvotes
boolean

Response

Successful response

​
id
string
required
​
name
string
required
​
domains
string[]
required
​
externalIds
string[]
required
​
autoAdd
boolean
required
​
size
integer
required
​
revenue
integer
required
​
tierId
string
required
​
statusId
string
required
​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
workspaceId
string
required
​
contacts
object[]
required
​
upvotes
integer
required