GET
/
people
/
paths
/
{url}
curl --request GET \
  --url https://api.village.do/v1/people/paths/{url} \
  --header 'secret-key: <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"
      }
    }
  ]
}

Authorizations

​
secret-key
string
header
required

Headers

​
user-identifier
string

Specify the user making the request. This identifier should match the one you used when integrating the user with Village.

Path Parameters

​
url
string
required

LinkedIn URL of the target person

Response

200
application/json
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