GET
/
companies
/
paths
/
{url}
Get Company Paths
curl --request GET \
  --url https://api.village.do/v1/companies/paths/{url} \
  --header 'user-identifier: <user-identifier>' \
  --header 'x-access-token: <api-key>'
{
  "company": {
    "name": "Hooli",
    "linkedin_url": "https://linkedin.com/company/hooli"
  },
  "summary": {
    "score": 8.5,
    "score_label": "Excellent"
  },
  "target_people": [
    {
      "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",
              "score_meta": [
                {
                  "title": "Work",
                  "description": "Both worked at Pied Piper (12 employees) Jan '14 - Dec '16"
                },
                {
                  "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 Hooli (5000 employees) Jan '08 - Jan '12. Peter as Board Member while Gavin as CEO"
              },
              {
                "title": "Verified interactions",
                "description": "Met 15 times for board meetings"
              }
            ]
          },
          "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)",
              "score_meta": [
                {
                  "title": "Personal",
                  "description": "Former roommates at the Hacker Hostel"
                },
                {
                  "title": "Work",
                  "description": "Both worked at Pied Piper (12 employees) Jan '14 - Jun '14"
                }
              ]
            }
          ],
          "summary": {
            "score": 9,
            "score_label": "Excellent",
            "description": "🟢 You can reach out directly (college roommate)"
          }
        }
      ]
    }
  ],
  "count": 9
}

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 or domain URL of the target company (URL encoded)

Response

200 - application/json

Successfully retrieved company paths

The response is of type object.