Prospects

AI-generated prospect leads based on your ICP profiles. Prospects are created automatically by the system — you can read and update them.

Note: Prospects are read-only via API (except for updates). AI generation happens through the dashboard. Requires prospects:read scope.

GET/prospects

List AI-generated prospects with pagination.

Param	Type	Description
limit	int	Max results (default: 50, max: 500)
offset	int	Pagination offset (default: 0)

curl "https://kashew.ai/api/v1/prospects?limit=50&offset=0" \
  -H "Authorization: Bearer kshw_xxxxxxxx_xxxxx..."

200

{
  "prospects": [{
    "id": "uuid",
    "person_name": "Jane Smith",
    "company_name": "TechCorp",
    "email": "jane@techcorp.com",
    "job_title": "VP of Sales",
    "industry": "SaaS / Software",
    "country": "United States",
    "company_website": "https://techcorp.com",
    "linkedin_profile_url": "https://linkedin.com/in/janesmith",
    "created_at": "2026-05-20T10:00:00Z"
  }],
  "count": 120
}

GET/prospects/generated-leads/:id

Get a single AI-generated prospect by ID.

curl "https://kashew.ai/api/v1/prospects/generated-leads/uuid-..." \
  -H "Authorization: Bearer kshw_xxxxxxxx_xxxxx..."

PATCH/prospects/generated-leads/:id

Update fields on an AI-generated prospect. Only include fields you want to change.

Request Body (all fields optional)

{
  "person_name": "Jane Smith",
  "company_name": "TechCorp Updated",
  "email": "jane.smith@techcorp.com",
  "phone": "+1 555-0123",
  "job_title": "SVP of Sales",
  "industry": "FinTech",
  "country": "United States",
  "company_website": "https://techcorp.com",
  "linkedin_profile_url": "https://linkedin.com/in/janesmith"
}

200

{ "id": "uuid", "status": "updated" }