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

# Get Person Paths (Bulk)

`POST /v2/people/paths/bulk`

## Request

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

Find introduction paths to multiple people in a single request. Use this for batch processing, such as scoring leads in a sales sequence or prioritizing outreach targets. Provide up to 100 LinkedIn IDs and get connection paths for each. Returns the same path information as get_person_paths but optimized for bulk operations.

## Request body

- PeopleBulkPathsRequest: Request for bulk person paths (max 100 LinkedIn IDs)
  - `linkedin_ids` string[], required: Array of LinkedIn identifiers to get paths for

## Response `200`

Bulk person paths found successfully

- object
  - `data` BulkPersonPathsResult[], required: Array of person paths results for bulk request
    - `target` PersonTarget, required: Target person information
      - `avatar` string
      - `first_name` string, required
      - `last_name` string, required
      - `full_name` string, required
      - `id` string, required
      - `identity_id` string, required
      - `linkedin_identifier` string
      - `linkedin_url` string
      - `title` string, nullable
      - `village_person_url` 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
    - `summary` PathSummary, required: Connection strength summary with optional description
      - `score` number
      - `score_label` string
      - `description` string
    - `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`: Invalid request - missing LinkedIn IDs or exceeds maximum limit
- `401`: Unauthorized - missing or invalid authentication

---

[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)