GET
/
people
/
autopilot
/
{listId}
/
results
Autopilot - Results
curl --request GET \
  --url https://api.village.do/v1/people/autopilot/{listId}/results \
  --header 'x-access-token: <api-key>'
{
  "status": "success",
  "listId": "12345",
  "results": [
    {
      "name": "John Smith",
      "current_role": "CTO at TechStartup Inc",
      "village_id": "vill_abc123",
      "linkedin_url": "https://linkedin.com/in/johnsmith",
      "overall_match_score": 8.5,
      "top_strengths": [
        "10+ years scaling SaaS products",
        "Strong technical leadership",
        "Previous successful exit"
      ],
      "criteria_scores": [
        {
          "criterion": "Has experience scaling SaaS products",
          "score": 9,
          "confidence_level": "high",
          "evidence": [
            "Led product scaling at previous company from 100 to 10k customers",
            "Implemented microservices architecture"
          ],
          "justification": {
            "assessment": "Strong evidence of SaaS scaling experience",
            "supporting_details": "Multiple successful scaling initiatives documented",
            "gaps_and_limitations": "Limited information about B2C experience"
          },
          "unique_value_proposition": "Proven track record in enterprise SaaS scaling"
        }
      ],
      "relationship": {
        "warmth_score": 7.5,
        "paths": {
          "count": 2,
          "ids": [
            "path1",
            "path2"
          ],
          "avatars": [
            "https://example.com/avatar1.jpg",
            "https://example.com/avatar2.jpg"
          ]
        }
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 45,
    "hasNextPage": true
  }
}

Authorizations

x-access-token
string
header
required

JWT token obtained from /users/authorization endpoint

Headers

user-identifier
string

Optional user identifier for API key authentication. If provided, relationship data will be included in results.

Path Parameters

listId
string
required

The list ID returned from the autopilot start endpoint

Query Parameters

page
integer
default:1

Page number for pagination

limit
integer
default:20

Number of results per page

Required range: x <= 100
screening_fields
enum<string>[]

Select which screening outcomes to include. Default is 'all'.

Response

200
application/json

Successfully retrieved autopilot results

The response is of type object.