Screen Job Submission

curl --request POST \
  --url https://api.harmonyforstaffing.com/api/screening \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "jobSubmissionId": 789,
    "criteria": [
      {
        "description": "Must have 2 years of ICU nursing experience",
        "importance": "required",
        "type": "experience"
      },
      {
        "description": "Current ACLS certification required",
        "importance": "required",
        "type": "certification"
      }
    ],
    "replaceCriteria": false
  }'

{
  "id": 789,
  "candidateId": 456,
  "jobId": 123,
  "currentScore": 66.67,
  "potentialScore": 100,
  "disqualify": false,
  "submissionSummary": {
    "screeningSummary": "The candidate meets most critical requirements including ICU experience and certifications. While they have slightly less experience than required, their strong qualifications in pediatric care make them a promising candidate.",
    "followUpQuestions": [
      "Are you willing and able to work night shifts?",
      "Would you be comfortable working with pediatric patients given your adult ICU background?",
      "Is your PALS certification current or would you be willing to obtain it?"
    ],
    "missingInformation": [
      "Night shift availability",
      "Pediatric care experience details",
      "PALS certification status"
    ],
    "strengths": [
      "Current ACLS and BLS certifications",
      "Recent ICU experience",
      "Proficient with EPIC EMR"
    ],
    "gaps": [
      "Experience level slightly below requirement (2 years vs 3 years)",
      "No confirmed night shift experience",
      "No explicit pediatric care experience"
    ]
  },
  "applicationReadiness": {
    "readinessScore": 75,
    "status": "NeedsInformation",
    "requiredDocuments": {
      "missing": [
        "PALS certification",
        "Professional references"
      ],
      "expiringSoon": [
        "RN License (expires in 60 days)"
      ]
    },
    "qualificationGaps": {
      "critical": [
        "Night shift availability confirmation",
        "PALS certification"
      ],
      "recommended": [
        "Additional year of ICU experience",
        "Pediatric care experience"
      ]
    },
    "workHistoryGaps": {
      "gaps": [
        {
          "startDate": "2022-06-01",
          "endDate": "2022-08-15",
          "duration": "2.5 months"
        },
        {
          "startDate": "2023-01-01",
          "endDate": "2023-03-01",
          "duration": "2 months"
        }
      ],
      "totalGapDuration": "4.5 months",
    },
    "nextSteps": [
      "Submit PALS certification",
      "Provide professional references",
      "Confirm night shift availability",
      "Renew RN license"
    ]
  },
  "criteria": [
    {
      "id": 1,
      "source": "job_criteria",
      "question": "How many years of ICU nursing experience do you have?",
      "criteria": "Minimum of 3 years ICU nursing experience required",
      "type": "YearsOfExperience",
      "status": "PartiallyMet",
      "reasoning": "The candidate has 2 years of ICU experience, which is slightly below the required 3 years. However, their experience is recent and includes relevant critical care skills.",
      "textEvidence": "2 years of experience in Medical ICU at Saint Francis Hospital"
    },
    {
      "id": 2,
      "source": "job_criteria",
      "question": "Do you have current ACLS and BLS certifications?",
      "criteria": "Current ACLS and BLS certifications required",
      "type": "Required",
      "status": "FullyMet",
      "reasoning": "The candidate holds current ACLS and BLS certifications that are valid through 2025.",
      "textEvidence": "ACLS Certification (exp. 06/2025), BLS Certification (exp. 08/2025)"
    },
    {
      "id": 3,
      "source": "job_criteria",
      "question": "Do you have experience with EPIC EMR system?",
      "criteria": "Experience with EPIC EMR system preferred",
      "type": "Preferred",
      "status": "FullyMet",
      "reasoning": "The candidate has extensive experience using EPIC EMR in their current role.",
      "textEvidence": "Proficient in EPIC EMR system, including documentation, order entry, and care planning modules"
    },
    {
      "id": 4,
      "source": "job_criteria",
      "question": "Are you able to work night shifts?",
      "criteria": "Must be willing to work night shifts",
      "type": "Required",
      "status": "NotMet",
      "reasoning": "The resume does not indicate any night shift experience or willingness to work nights.",
      "textEvidence": null
    }
  ],
  "qualificationLevel": "Appropriate",
  "isRelevant": true
}

{
  "error": "validation_error",
  "message": "Invalid request parameters",
  "details": [
    "Must provide either jobSubmissionId or both candidateId and jobId",
    "Invalid importance value. Must be one of: required, preferred, optional"
  ]
}