Phase 1: Job setup (once per job)
Generate clarification questions (optional)
POST /v1/jobs/{jobId}/question-sets with your job context.Store questionSet.id and show questionSet.questions in your UI.Generate criteria
POST /v1/jobs/{jobId}/criteria/generate with your job context.If you collected answers, include questionSetId and answers.Refine criteria (optional)
Use the criteria management endpoints to add, edit, remove, or archive criteria. See criteria versioning for how changes affect scoring.
Phase 2: Application scoring (per application)
Generate a resume URL
Produce a public HTTPS URL. See supported formats for requirements.
Submit a scoring request
POST /v1/jobs/{jobId}/applications/{applicationId}/scoring-jobs with the resume object and jobDescription.Store scoringJob.id and scoringJob.criteriaVersionId for webhook correlation and polling.Handle webhooks
Verify the signature and process
score.completed and score.failed events. See webhooks.Polling fallback
If you miss a webhook:GET /v1/jobs/{jobId}/applications/{applicationId}/scoring-jobs/{scoringJobId}