---
title: "Get Person Paths"
method: POST
path: "/v2/people/paths"
tags: ["People"]
---

# Get Person Paths

`POST /v2/people/paths`

## Request

- Base URL: `https://api.village.ai`
- URL: `https://api.village.ai/v2/people/paths`
- Auth: HTTP bearer

Find introduction paths to reach a specific person through your professional network. Use this when you want to connect with someone and need to find who can introduce you. Provide a LinkedIn URL and get back: direct connections, mutual contacts who can make introductions, and connection strength scores. Higher scores indicate stronger, more reliable paths. Warmth score, open-ended (higher is warmer): Excellent 10+, Very Good 7.5+, Good 4+, Okay 1+, Maybe 0.1+, below that Not enough data.

## Request body

- union: Person identifier - provide one of: linkedin_url or url
  - object: Person by LinkedIn URL
    - `linkedin_url` string, required: LinkedIn person profile URL
  - object: Person by generic URL (auto-detected)
    - `url` string, required: Generic URL (auto-detected)

## Response `200`

Person paths found successfully

- object
  - `data` PersonPathsResponse, required: Person paths response with connection information
    - `person` PersonInfo, required: Basic person information
      - `first_name` string, required
      - `last_name` string, required
      - `full_name` string, required
      - `linkedin_url` string, required
      - `avatar` string
      - `village_url` string, required
    - `summary` PathSummary, required: Connection strength summary with optional description
      - `score` number
      - `score_label` string
      - `description` string
    - `paths` PersonPath[], required
      - `degree` union, required: Connection degree (1=direct, 2=you → introducer → target, 3=team member → introducer → target)
        - 1
        - 2
        - 3
      - `summary` PathSummary, required: Connection strength summary with optional description
        - `score` number
        - `score_label` string
        - `description` string
      - `starters` PathStarter[], required
        - `profile` Profile, required: Basic profile information for a person in a path
          - `first_name` string, required
          - `last_name` string, required
          - `linkedin_url` string, required
          - `headline` string, required
          - `avatar` string
        - `score` number, required
        - `score_label` string, required
        - `score_description` string, required
        - `score_meta` ScoreMeta[], required
          - `title` string, required
          - `description` string, required
        - `is_current_user` boolean, required: Whether this starter is the authenticated user making the request
      - `introducer` PathIntroducer, required: Person who can make the introduction to the target
        - `profile` Profile, required: Basic profile information for a person in a path
          - `first_name` string, required
          - `last_name` string, required
          - `linkedin_url` string, required
          - `headline` string, required
          - `avatar` string
        - `score` number, required
        - `score_label` string, required
        - `score_meta` ScoreMeta[], required
          - `title` string, required
          - `description` string, required
      - `score_meta` ScoreMeta[], required
        - `title` string, required
        - `description` string, required
    - `count` number, required
    - `paths_hidden` number: Number of additional introduction paths withheld by the plan limit. Only present when paths were withheld.
  - `metadata` object, required
    - `request_id` string, required
    - `counts` object
      - `total` CountValue, required: A count value with optional accuracy qualifiers. Always access the count via .value.
        - `value` number, nullable, required
        - `is_capped` boolean
        - `cap` number
        - `is_estimated` boolean

## Other responses

- `400`: Bad request - invalid parameters
- `401`: Unauthorized - missing or invalid authentication
- `404`: Person not found or no connection paths found

---

[API](https://skmtc.dev/village/apis/village-v2-api.md) - [All operations](https://skmtc.dev/village/apis/village-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/village/apis/village-v2-api/revisions/aebe21a1a544?raw)