---
title: "Sort People"
method: POST
path: "/v2/people/sort"
tags: ["People"]
---

# Sort People

`POST /v2/people/sort`

## Request

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

Rank a list of people by how well-connected you are to them. Use this to prioritize outreach by focusing on people you have the strongest connections to. Provide LinkedIn URLs and get them sorted by connection strength score (highest first). Each result includes: score, score_label (e.g., "Excellent", "Good", "Not enough data"), and the original URL. 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

- PersonSortRequest: List of person URLs to sort by connection strength
  - `people` string[], required: Array of LinkedIn person profile URLs

## Response `200`

People sorted successfully

- object
  - `data` PersonSortResponse, required: Response containing sorted people and any URL validation errors
    - `sorted` SortedPerson[], required
      - `score` number, required
      - `score_label` string, required
      - `linkedin_url` string, required
      - `url` string, required
    - `errors` SortError[]
      - `url` string, required
      - `error` string, required
  - `metadata` object, required
    - `request_id` string, required

## Other responses

- `400`: Bad request - invalid parameters
- `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)