curl --request GET \
--url https://api.village.do/v1/people/paths/{url} \
--header 'user-identifier: <user-identifier>' \
--header 'x-access-token: <api-key>'
{
"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",
"summary": {
"score": 8.5,
"score_label": "Excellent",
"description": "🟢 Erlich can intro via Peter Gregory (Lead investor)"
},
"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"
}
}
]
}
Returns connection paths and warmth score to a LinkedIn profile
curl --request GET \
--url https://api.village.do/v1/people/paths/{url} \
--header 'user-identifier: <user-identifier>' \
--header 'x-access-token: <api-key>'
{
"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",
"summary": {
"score": 8.5,
"score_label": "Excellent",
"description": "🟢 Erlich can intro via Peter Gregory (Lead investor)"
},
"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"
}
}
]
}
JWT token obtained from /users/authorization endpoint
Specify the user making the request. This identifier should match the one you used when integrating the user with Village. Not needed when using user token authentication.
LinkedIn URL of the target person
Successfully retrieved paths with connection paths and warmth scores
Complete response for paths to a person