{"uid":"cap_vlYNtnHpNbuMDYKyScIxP","slug":"rafid-recruitment-candidate-shortlist-scorer-bd73475e","name":"Rafid Recruitment Candidate Shortlist Scorer","description":"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.","url":"https://api.rafidsystem.com/api/v1/x402/recruitment/candidate-shortlist-score?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":{"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."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mZIIpcOAhk77rGt6vrGa9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Automated applicant screening pipeline","prompt":"I have 40 applicants for our Data Analyst role requiring SQL and Tableau skills with at least 2 years of experience — can you score all of them against the job profile and return the top 10 with match scores and skill gap analysis?"},{"title":"Comparing finalists before interview stage","prompt":"We've narrowed it down to 6 candidates for the Marketing Manager position — can you score each of them against our job profile and show me their match scores, any risk flags, and which transferable skills they bring?"},{"title":"Bias-free shortlisting for compliance","prompt":"We need to shortlist 5 candidates from this pool of 20 for our Software QA role in a way that ignores protected attributes — can you run them all through the candidate scoring system and return a ranked list with confidence scores and explanations for each score?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:36:58.775Z","isFirstParty":false,"canonicalSlug":"rafid-recruitment-candidate-shortlist-scorer-bd73475e"}