Education verification

An education claim confirms a degree or attendance at the school that issued it. Three sources run in order, and the accreditation check runs on every claim.

curl -X POST https://api.primarycheck.com/v1/verifications \
  -H "Authorization: Bearer pc_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "person": {
      "firstName": "Amy",
      "lastName": "Kowalski",
      "dob": "1976-02-14"
    },
    "claims": [
      {
        "type": "education",
        "school": "Ohio State University",
        "schoolState": "OH",
        "degree": "BSN",
        "major": "Nursing",
        "graduatedYear": 2019
      }
    ],
    "purpose": "employment",
    "consent": {
      "consentId": "cons_8f1…"
    }
  }'

Education sources and order

Order	Source	Role	Typical turnaround
1	National Student Clearinghouse DegreeVerify	primary	seconds to minutes; pass-through fee billed at cost
2	Registrar outreach (our engine, kind=education)	primary	1–7 business days
always	Accreditation (US Dept. of Education DAPIP + CHEA)	corroborating	instant

Education field checks

Field	Passes when
school	Normalized school name or a known alias matches the issuing institution
degree	Degree level and type match (BSN ≠ ADN)
major	Soft match; a mismatch is noted, never auto-fails
graduatedYear / attended	Year matches; attendance window overlaps when dates are given
accreditation	School is accredited by a recognized agency; otherwise `discrepancy` with `record.flags = ["unaccredited"]`

Education verdicts and reasons

verified · discrepancy (a field differs, or the school is unaccredited) · not_found (the school says no record) · unable_to_verify with no_response, employer_policy (registrar declines), source_not_built or insufficient_identifiers · pending while outreach runs.

Registrar outreach follows the same cadence and contact rules as employment outreach. See also education verification and evidence.