---
title: "Get Company Paths"
method: POST
path: "/v2/companies/paths"
tags: ["Companies"]
---

# Get Company Paths

`POST /v2/companies/paths`

## Request

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

Find introduction paths to people at a specific company. Use this when targeting a company for sales, recruiting, or partnerships. Provide a company domain or LinkedIn URL and get: employees you can reach through your network, potential introducers for each person, and connection strength scores. Returns up to 50 employees ranked by how well-connected you are.

## Request body

- union: Company identifier with optional cursor pagination
  - object: Company by domain
    - `domain` string, required: Company domain (normalized, without www prefix)
    - `cursor` string: Opaque cursor for pagination (from previous response)
    - `limit` integer: Number of results per page (default 25, max 50)
    - `connection_degrees` integer[]: Filter by connection degree (1=direct, 2=second-degree, 3=third-degree)
  - object: Company by LinkedIn URL
    - `linkedin_url` string, required: LinkedIn company page URL
    - `cursor` string: Opaque cursor for pagination (from previous response)
    - `limit` integer: Number of results per page (default 25, max 50)
    - `connection_degrees` integer[]: Filter by connection degree (1=direct, 2=second-degree, 3=third-degree)
  - object: Company by generic URL (auto-detected)
    - `url` string, required
    - `cursor` string: Opaque cursor for pagination (from previous response)
    - `limit` integer: Number of results per page (default 25, max 50)
    - `connection_degrees` integer[]: Filter by connection degree (1=direct, 2=second-degree, 3=third-degree)

## Response `200`

Company paths found successfully

- object
  - `data` CompanyPathsResponse, required: Company paths response with connection information
    - `company` CompanyInfo, required: Basic company information
      - `name` string, required
      - `domain` string, required
      - `linkedin_url` string
      - `village_url` string
    - `summary` object, required: Connection strength summary with optional description
      - `score` number, nullable
      - `score_label` string, nullable
      - `description` string
    - `target_people` TargetPerson[], required
      - `target` Target, 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` Path[], required
        - `degree` union, required: Connection degree (1=direct, 2=you → introducer → target, 3=team member → introducer → target)
          - 1
          - 2
          - 3
        - `summary` object, required: Connection strength summary with optional description
          - `score` number, nullable
          - `score_label` string, nullable
          - `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` object, required: Connection strength summary with optional description
        - `score` number, nullable
        - `score_label` string, nullable
        - `description` string
      - `count` number, required
      - `paths_hidden` number: Number of additional introduction paths withheld by the plan limit. Only present when paths were withheld.
      - `degree` union, required: Connection degree of the strongest path (1=direct, 2=you → introducer → target, 3=team member → introducer → target)
        - 1
        - 2
        - 3
  - `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
  - `pagination` PaginationInfo, required: Cursor-based pagination metadata
    - `cursor` string, nullable, required: Opaque cursor for fetching the next page (null if no more results)
    - `has_next_page` boolean, required: Whether more results are available
    - `count` integer, required: Total number of results or count of items in current page

## Other responses

- `400`: Bad request - invalid parameters
- `401`: Unauthorized - missing or invalid authentication
- `404`: Company not 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)