en
BookingsMatching crew candidates for a job

Matching crew candidates for a job

Technicians who can actually take this job, matched and ranked by the smart-assignment engine — skills per crew slot, weekly availability, existing schedule, time off and travel are all checked; each candidate carries a score breakdown (distance, travel, matched skills) plus the exact on-site session plan they would work. NOT a raw roster list (use GET /technicians for that). Returns the ranked feasible LEAD pool by default; pass include_buddies=true to also return per-slot buddy pools, include_vehicle=true to include the available-vehicle list. force_lead_id checks one specific technician: returns only that lead (with their crew combo) if feasible, else 409 JOB_REQUEST_NO_TECHNICIAN_AVAILABLE.

Arguments

idstringpathrequired
Job request ID or short_code
include_buddiesbooleanqueryoptional
Also return buddy candidate pools
include_vehiclebooleanqueryoptional
Also return the available-vehicle list
force_lead_idstringqueryoptional
Check a specific technician as lead — returns only that lead if feasible, else 409
GET/v1/job-requests/{id}/crew-candidates
curl -X GET "https://api.crisphive.com/v1/job-requests/9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01/crew-candidates" \
  -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT"

Responses