Skip to main content
GET
/
people
/
paths
/
{url}
Get Person Paths
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"
          }
        ]
      }
    }
  ]
}

Authorizations

x-access-token
string
header
required

JWT token obtained from /users/authorization endpoint

Headers

user-identifier
string
required

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.

Path Parameters

url
string
required

LinkedIn URL of the target person

Response

Successfully retrieved paths with connection paths and warmth scores

Complete response for paths to a person

target
object

The person you're trying to reach

count
integer

Total number of paths found

Example:

1

summary
object

Overall summary of all paths to this person

paths
object[]

All available connection paths to the target

I