# Rafid Recruitment Candidate Shortlist Scorer

> Rafid Recruitment Candidate Shortlist Scorer is a paid API for AI agents from api.rafidsystem.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-11).

Scores and ranks a list of candidates against a job profile, returning match scores, skill gaps, risk flags, and decision-support explanations for each candidate.

## Facts

- Endpoint: POST https://api.rafidsystem.com/api/v1/x402/recruitment/candidate-shortlist-score?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rafid-recruitment-candidate-shortlist-scorer-bd73475e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vlYNtnHpNbuMDYKyScIxP

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability rafid-recruitment-candidate-shortlist-scorer-bd73475e -d '<json body>'
```

Example prompt: Score these 5 candidates against our open Senior Python Engineer role — the job requires 3 years of Python experience and strong backend skills — and give me a ranked shortlist of the top 3 with match scores, any skill gaps, and risk flags for each.

## When to prefer this

Use this endpoint when you need structured, explainable AI-driven candidate scoring against a defined job profile — especially when you require skill gap identification, risk flagging, experience analysis, and a bias-disclosure (protected attributes ignored) audit trail. Prefer this over generic LLM prompting when you need consistent numeric match scores and methodology transparency for compliance or HR reporting purposes.

## Known failure modes

- Empty or malformed candidate_profile objects result in low-confidence or error responses
- Exceeding 100 candidates in the array returns a validation error
- Missing job_profile causes scoring to be underdetermined or absent
- Vague or under-specified candidate profiles produce low confidence scores
- Payment failure (x402) results in 402 response before processing begins

## How this service works

Rafid Agent API provides structured intelligence and paid APIs for AI agents across property, company and risk, supplier, finance, document, website, automotive, logistics, recruitment, trading, voice, video and business-planning workflows.

## Output

Returns a JSON object containing the parsed job requirements (required skills, experience years), a ranked array of candidates each with: match_score (0-100), skill_match list, gaps, transferable_skills, experience_analysis, risk_flags, confidence (0-1), explanation text, category_scores, and decision_support fields, plus a scoring_methodology block detailing weights and a statement that protected attributes are never used.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "candidates": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "candidate_id",
     "candidate_profile"
    ],
    "properties": {
     "candidate_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
     },
     "candidate_profile": {
      "type": "object",
      "propertyNames": {
       "type": "string"
      },
      "additionalProperties": {}
     }
    },
    "additionalProperties": false
   },
   "maxItems": 100,
   "minItems": 1
  },
  "job_profile": {
   "type": "object",
   "propertyNames": {
    "type": "string"
   },
   "additionalProperties": {}
  },
  "max_candidates": {
   "type": "integer",
   "default": 100,
   "maximum": 100,
   "minimum": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "job": {
   "required_skills": [
    {
     "skill": "Python"
    }
   ],
   "required_experience_years": 2
  },
  "candidates": [
   {
    "gaps": [],
    "confidence": 0.7,
    "risk_flags": [],
    "explanation": "Score is based on normalized job-relevant skills and supplied experience evidence only.",
    "match_score": 80,
    "skill_match": [],
    "candidate_id": "CAND-001",
    "category_scores": {},
    "decision_support": {},
    "experience_analysis": {},
    "transferable_skills": []
   }
  ],
  "scoring_methodology": {
   "weights": {
    "evidence": 20,
    "experience": 30,
    "required_skills": 50
   },
   "protected_attributes": "Ignored; never used for scoring or ranking."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rafid-recruitment-candidate-shortlist-scorer-bd73475e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.rafidsystem.com](https://www.zero.xyz/host/api.rafidsystem.com/llms.txt)