# Recruitment Operations API

> Structure job requirements, extract resume facts, and explain candidate matches. Scores are not hiring decisions.

- Product: https://www.brainiac.software/api/recruitment-operations
- Docs: https://www.brainiac.software/api/recruitment-operations/docs
- OpenAPI: https://www.brainiac.software/api/recruitment-operations/openapi.json
- Contact: support@brainiac.software (https://www.brainiac.software/contact)

## Operations

- POST /api/v1/recruitment-operations/job-description-structure — $0.03 USDC — Structure a job description: Read Title, Requirement, and Responsibility lines into explicit requirements. Unlabeled prose is not turned into a requirement, and a requirement counts toward a score only when it is marked required. Docs: https://www.brainiac.software/api/recruitment-operations/docs#recruitment-operations-job-description-structure
- POST /api/v1/recruitment-operations/resume-data-extract — $0.04 USDC — Extract resume data: Read Skill, Role, and Qualification lines. Personal-attribute lines and references are ignored and are not stored. Docs: https://www.brainiac.software/api/recruitment-operations/docs#recruitment-operations-resume-data-extract
- POST /api/v1/recruitment-operations/resume-job-match — $0.05 USDC — Match a resume to a job: Compare supplied skills, qualifications, and role dates with explicit required items. A caller alias is marked inferred. A responsibility is not marked met. Docs: https://www.brainiac.software/api/recruitment-operations/docs#recruitment-operations-resume-job-match
- POST /api/v1/recruitment-operations/candidate-skill-compare — $0.04 USDC — Compare candidate skills: Compare supplied skill names across candidates and against an explicit skill list. Missing skills are not invented. Docs: https://www.brainiac.software/api/recruitment-operations/docs#recruitment-operations-candidate-skill-compare
- POST /api/v1/recruitment-operations/candidate-experience-validate — $0.03 USDC — Validate candidate experience: Check supplied employment dates for invalid dates, overlaps, and gaps. Dates are not rewritten, and a gap is not a ranking penalty. Docs: https://www.brainiac.software/api/recruitment-operations/docs#recruitment-operations-candidate-experience-validate
- POST /api/v1/recruitment-operations/interview-question-generate — $0.04 USDC — Draft interview questions: Draft questions from missing required items, inferred alias matches, and job responsibilities. The questions do not score the candidate. Docs: https://www.brainiac.software/api/recruitment-operations/docs#recruitment-operations-interview-question-generate
- POST /api/v1/recruitment-operations/candidate-shortlist-rank — $0.05 USDC — Rank a candidate shortlist: Score candidates only from explicit required matches. An exact match is worth 2 and a caller alias is worth 1. Ties keep the caller's order. Docs: https://www.brainiac.software/api/recruitment-operations/docs#recruitment-operations-candidate-shortlist-rank
- POST /api/v1/recruitment-operations/pipeline-report — $0.12 USDC — Report a recruitment pipeline: Combine the job requirements, resume facts, match explanations, experience checks, interview prompts, and shortlist scores. The report is not a hiring decision. Docs: https://www.brainiac.software/api/recruitment-operations/docs#recruitment-operations-pipeline-report