GET
/
companies
/
autopilot
/
{listId}
/
results
Get Companies Autopilot Results
curl --request GET \
  --url https://api.village.do/v1/companies/autopilot/{listId}/results \
  --header 'x-access-token: <api-key>'
{
  "status": "success",
  "listId": "67890",
  "results": [
    {
      "company_name": "AI Innovations Inc",
      "industry": "Artificial Intelligence",
      "headquarters": "San Francisco, CA",
      "founded": 2019,
      "village_id": "vill_comp123",
      "linkedin_url": "https://linkedin.com/company/ai-innovations",
      "website": "https://ai-innovations.com",
      "domain": "ai-innovations.com",
      "overall_match_score": 9,
      "top_strengths": [
        "Strong product-market fit in enterprise AI",
        "Experienced leadership team from FAANG",
        "Series B funding completed"
      ],
      "criteria_scores": [
        {
          "criterion": "Strong product-market fit",
          "score": 9.5,
          "confidence_level": "high",
          "evidence": [
            "300% YoY revenue growth",
            "Fortune 500 client base",
            "Industry awards and recognition"
          ],
          "justification": {
            "assessment": "Exceptional product-market fit demonstrated",
            "supporting_details": "Multiple indicators of strong market demand and customer satisfaction",
            "gaps_and_limitations": "Limited information about churn rates"
          }
        }
      ],
      "company_data": {
        "employee_count": 75,
        "funding_total": "$45M",
        "last_funding_date": "2024-03-15",
        "tags": [
          "AI",
          "Enterprise",
          "SaaS",
          "Machine Learning"
        ],
        "description": "Leading provider of enterprise AI solutions"
      },
      "relationship": {
        "warmth_score": 8,
        "paths": {
          "count": 3,
          "ids": [
            "path1",
            "path2",
            "path3"
          ],
          "avatars": [
            "https://example.com/avatar1.jpg",
            "https://example.com/avatar2.jpg"
          ]
        }
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 32,
    "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.