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",
"score_meta": [
{
"title": "Work",
"description": "Both worked at Pied Piper (12 employees) Jan '14 - Present"
},
{
"title": "LinkedIn",
"description": "Both are connected on LinkedIn"
}
]
}
],
"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_meta": [
{
"title": "Work",
"description": "Both worked at Raviga Capital (50 employees) Jan '13 - Dec '15"
},
{
"title": "LinkedIn",
"description": "Both are connected on LinkedIn"
}
]
}
}
]
}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",
"score_meta": [
{
"title": "Work",
"description": "Both worked at Pied Piper (12 employees) Jan '14 - Present"
},
{
"title": "LinkedIn",
"description": "Both are connected on LinkedIn"
}
]
}
],
"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_meta": [
{
"title": "Work",
"description": "Both worked at Raviga Capital (50 employees) Jan '13 - Dec '15"
},
{
"title": "LinkedIn",
"description": "Both are connected on LinkedIn"
}
]
}
}
]
}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
The person you're trying to reach
Show child attributes
Show child attributes
Village ID of the person
"vill_123abc456"
First name of the person
"Richard"
Last name of the person
"Hendricks"
LinkedIn URL of the person
"https://linkedin.com/in/richard-hendricks"
Headline of the person
"CEO at Pied Piper"
Email address of the person, not returned by default
Total number of paths found
1
Overall summary of all paths to this person
Show child attributes
Relationship strength score
8.5
Human-readable label for the relationship strength
Excellent, Very Good, Good, Okay, Maybe "Excellent"
Human-readable summary of the best paths available
"🟢 Erlich Bachman → Peter Gregory → Gavin Belson (CEO)"
All available connection paths to the target
Show child attributes
intro, direct Show child attributes
Show child attributes
Village ID of the person
"vill_123abc456"
First name of the person
"Richard"
Last name of the person
"Hendricks"
LinkedIn URL of the person
"https://linkedin.com/in/richard-hendricks"
Headline of the person
"CEO at Pied Piper"
Email address of the person, not returned by default
Relationship strength score
8.5
Human-readable label for the relationship strength
Excellent, Very Good, Good, Okay, Maybe "Excellent"
Show child attributes
Show child attributes
Village ID of the person
"vill_123abc456"
First name of the person
"Richard"
Last name of the person
"Hendricks"
LinkedIn URL of the person
"https://linkedin.com/in/richard-hendricks"
Headline of the person
"CEO at Pied Piper"
Email address of the person, not returned by default
Relationship strength score
8.5
Human-readable label for the relationship strength
Excellent, Very Good, Good, Okay, Maybe "Excellent"
Human-readable description of the connection
"🟢 Erlich can make a strong introduction"
Show child attributes
Relationship strength score
8.5
Human-readable label for the relationship strength
Excellent, Very Good, Good, Okay, Maybe "Excellent"
Human-readable description of the path
Was this page helpful?