Companies
Get Company Paths
Returns connection paths to a company using either its LinkedIn URL or domain URL
GET
Authorizations
Headers
Specify the user making the request. This identifier should match the one you used when integrating the user with Village.
Path Parameters
LinkedIn URL or domain URL of the target company (URL encoded)
Response
200 - application/json
Successfully retrieved company paths
Complete response for paths to a person
Example:
[
{
"target": {
"profile": {
"village_id": "vill_999abc",
"first_name": "Gavin",
"last_name": "Belson",
"linkedin_url": "https://linkedin.com/in/gavin-belson",
"headline": "CEO at Hooli"
}
},
"count": 1,
"summary": {
"score": 8,
"score_label": "Excellent",
"description": "🟢 Erlich Bachman → Peter Gregory → Gavin Belson (CEO)"
},
"paths": [
{
"type": "intro",
"starters": [
{
"profile": {
"village_id": "vill_789xyz",
"first_name": "Erlich",
"last_name": "Bachman",
"linkedin_url": "https://linkedin.com/in/erlich-bachman",
"headline": "Founder at Aviato"
},
"score": 8.5,
"score_label": "Excellent",
"score_description": "🟢 Erlich can make a strong introduction"
}
],
"introducer": {
"profile": {
"village_id": "vill_456def",
"first_name": "Peter",
"last_name": "Gregory",
"linkedin_url": "https://linkedin.com/in/peter-gregory",
"headline": "Founder at Raviga Capital"
},
"score": 8.5,
"score_label": "Excellent",
"score_description": "🟢 Erlich can make a strong introduction"
},
"summary": {
"score": 8.5,
"score_label": "Excellent",
"description": "🟢 Erlich can intro via Peter Gregory (Lead investor)"
}
}
]
},
{
"target": {
"profile": {
"village_id": "vill_888xyz",
"first_name": "Nelson",
"last_name": "Bighetti",
"linkedin_url": "https://linkedin.com/in/big-head",
"headline": "CTO at Hooli"
}
},
"count": 1,
"summary": {
"score": 9,
"score_label": "Excellent",
"description": "🟢 Richard Hendricks (direct)"
},
"paths": [
{
"type": "direct",
"introducer": {
"profile": {
"village_id": "vill_123abc456",
"first_name": "Richard",
"last_name": "Hendricks",
"linkedin_url": "https://linkedin.com/in/richard-hendricks",
"headline": "CEO at Pied Piper"
},
"score": 9,
"score_label": "Excellent",
"score_description": "🟢 You can reach out directly (college roommate)"
},
"starters": [
{
"profile": {
"village_id": "vill_123abc456",
"first_name": "Richard",
"last_name": "Hendricks",
"linkedin_url": "https://linkedin.com/in/richard-hendricks",
"headline": "CEO at Pied Piper"
},
"score": 9,
"score_label": "Excellent",
"score_description": "🟢 You can reach out directly (college roommate)"
}
],
"summary": {
"score": 9,
"score_label": "Excellent",
"description": "🟢 You can reach out directly (college roommate)"
}
}
]
}
]
Total number of people found
Example:
2