# BRAINIAC Candidate Experience Validator

> BRAINIAC Candidate Experience Validator is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.03/call, status unknown (last checked 2026-11-17).

Validates candidate work history by detecting date gaps, overlaps, and conflicts in roles, then returns a structured audit of issues per candidate.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/recruitment-operations/candidate-experience-validate?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-candidate-experience-validator-535c4c45
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DYtA1nlA3IhNuOjek6K62

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 brainiac-candidate-experience-validator-535c4c45 -d '<json body>'
```

Example prompt: Check Ada's work history for any date gaps, overlaps, or conflicts — she listed Engineer at Northwind from 2020-01 to 2022-01, Consultant at Northwind from 2021-06 to 2022-06, Analyst at Engines from 2022-01 to 2022-01, and Advisor at Contoso from 2024-01 to 2024-06.

## When to prefer this

Use this endpoint when you need automated, structured detection of employment timeline issues (gaps, overlaps, date conflicts) across one or many candidates before human review. It is not a resume parser — callers must supply structured role data. Prefer this over manual review when processing batches of candidates, when you need machine-readable issue codes for downstream triage, or when you need a defensible audit trail that explicitly disclaims any hiring decision. It does not infer or invent information and does not evaluate skills or qualifications.

## Known failure modes

- Malformed or missing required role fields (title or employer) cause individual role issues to be flagged rather than batch rejection
- End dates before start dates are reported as 'end_before_start' conflicts and the dates are not rewritten
- Ambiguous or missing dates result in monthsKnown=false and those roles contribute 0 months to totals
- More than 20 candidates or 20 roles per candidate will be rejected by schema validation
- Insufficient USDC balance or failed x402 payment returns a 402 response before processing begins

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

Returns a JSON object per batch containing: a list of validated roles with computed duration in months, open/closed status, and an ok/conflict status per role; a list of detected gaps between consecutive roles with gap size in months; a list of overlaps between roles; a list of issues with error codes and human-readable detail; a top-level status ('checked'); a checkedAt timestamp; and a limitations disclaimer clarifying no hiring decision is made.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "candidates": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
     },
     "name": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
     },
     "text": {
      "type": "string",
      "maxLength": 20000,
      "minLength": 1
     },
     "roles": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "title",
        "employer"
       ],
       "properties": {
        "end": {
         "type": "string",
         "maxLength": 20,
         "minLength": 1
        },
        "text": {
         "type": "string",
         "maxLength": 2000,
         "minLength": 1
        },
        "start": {
         "type": "string",
         "maxLength": 20,
         "minLength": 1
        },
        "title": {
         "type": "string",
         "maxLength": 200,
         "minLength": 1
        },
        "employer": {
         "type": "string",
         "maxLength": 200,
         "minLength": 1
        }
       },
       "additionalProperties": false
      },
      "maxItems": 20
     },
     "skills": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "name"
       ],
       "properties": {
        "name": {
         "type": "string",
         "maxLength": 200,
         "minLength": 1
        },
        "years": {
         "type": "number",
         "maximum": 80,
         "minimum": 0
        }
       },
       "additionalProperties": false
      },
      "maxItems": 40
     },
     "qualifications": {
      "type": "array",
      "items": {
       "type": "object",
       "required": [
        "name"
       ],
       "properties": {
        "name": {
         "type": "string",
         "maxLength": 200,
         "minLength": 1
        },
        "year": {
         "type": "integer",
         "maximum": 2100,
         "minimum": 1900
        }
       },
       "additionalProperties": false
      },
      "maxItems": 20
     }
    },
    "additionalProperties": false
   },
   "maxItems": 20,
   "minItems": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "gaps": [
   {
    "after": "Consultant",
    "before": "Advisor",
    "detail": "The supplied dates leave a gap. The gap is not used in ranking.",
    "months": 19,
    "candidateRef": "ada"
   }
  ],
  "roles": [
   {
    "end": "2022-01",
    "open": false,
    "text": "",
    "start": "2020-01",
    "title": "Engineer",
    "months": 24,
    "status": "ok",
    "employer": "Northwind",
    "monthsKnown": true,
    "candidateRef": "ada"
   },
   {
    "end": "2022-06",
    "open": false,
    "text": "",
    "start": "2021-06",
    "title": "Consultant",
    "months": 12,
    "status": "ok",
    "employer": "Northwind",
    "monthsKnown": true,
    "candidateRef": "ada"
   },
   {
    "end": "2022-01",
    "open": false,
    "text": "",
    "start": "2023-01",
    "title": "Analyst",
    "months": 0,
    "status": "conflict",
    "employer": "Engines",
    "monthsKnown": false,
    "candidateRef": "ada"
   },
   {
    "end": "2024-06",
    "open": false,
    "text": "",
    "start": "2024-01",
    "title": "Advisor",
    "months": 5,
    "status": "ok",
    "employer": "Contoso",
    "monthsKnown": true,
    "candidateRef": "ada"
   }
  ],
  "issues": [
   {
    "code": "end_before_start",
    "kind": "conflict",
    "field": "Analyst",
    "detail": "The end date is before the start date. The dates were not rewritten.",
    "candidateRef": "ada"
   },
   {
    "code": "conflict",
    "kind": "conflict",
    "field": "Analyst",
    "detail": "This role needs a person to review the supplied title, employer, or dates.",
    "candidateRef": "ada"
   }
  ],
  "status": "checked",
  "overlaps": [
   {
    "first": "Engineer",
    "detail": "These supplied date ranges overlap. The overlap is not a ranking penalty.",
    "second": "Consultant",
    "candidateRef": "ada"
   }
  ],
  "checkedAt": "2026-11-03T10:00:00.000Z",
  "limitations": [
   "No hiring decision is made. A person decides.",
   "Skills, employment history, qualifications, and references are not invented.",
   "Protected personal attributes are ignored and are not used for matching or ranking.",
   "A match is marked inferred only when a caller-supplied alias links two names.",
   "Date gaps are reported from supplied dates and are not ranking penalties."
  ],
  "hiringDecision": false,
  "qualificationsInvented": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-candidate-experience-validator-535c4c45/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
