People

List People

Get your network contacts ranked by connection strength. Returns a paginated list with enrichment data for each person. Supports cursor-based pagination and optional connection degree filtering.

post/v2/people

Request

  • Base URL: https://api.village.ai
  • URL: https://api.village.ai/v2/people
  • Auth: HTTP bearer

Request body

cursorstring

Opaque cursor for pagination (from previous response)

limitinteger

Number of results per page (default 25, max 100)

connection_degreesinteger[]

Filter by connection degree (1=direct, 2=second-degree, 3=third-degree)

company_domainstring

Filter by current company domain (exact match)

Example request

{
  "limit": 25,
  "connection_degrees": [
    1,
    2
  ],
  "company_domain": "google.com"
}

Response

People list retrieved successfully

Example response

{
  "pagination": {
    "cursor": "eyJpZCI6IjEyMzQ1In0",
    "has_next_page": true,
    "count": 20
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.