Skip to main content

​
EducationHistoryDto Schema

The EducationHistoryDto contains information about an applicant’s education history for verification purposes.

​
Supported Fields

FieldRequiredTypeRules and behavior
institutionNameYesstringName of the educational institution. Example: "University of California".
qualificationYesstringEducational qualification or credential earned. Example: "Bachelor of Science in Computer Science".
fieldOfStudyYesstringField of study or major subject area. Example: "Computer Science".
graduationDateYesstringDate of graduation or completion in YYYY-MM-DD format.
institutionContactEmailNostringInstitution contact email for verification. Must be valid when provided.
institutionContactPhoneNostringInstitution contact phone number for verification.

​
Complete Example

{
  "institutionName": "University of California",
  "qualification": "Bachelor of Science in Computer Science",
  "fieldOfStudy": "Computer Science",
  "graduationDate": "2018-05-15",
  "institutionContactEmail": "registrar@berkeley.edu",
  "institutionContactPhone": "+1-510-642-6000"
}

​
Accreditation Checking

For post-secondary institutions (colleges and universities), the system automatically checks accreditation status:
  • Automatic: No additional configuration required
  • Reference Date: Uses graduation date (preferred), then end date, then start date to check accreditation status at the time the credential was earned
  • Data Sources: Combines DAPIP-derived accreditation data (archived CSVs live in GCS bucket verifications-api-dataset-2026, not under apps/verification-api/data/ in git) with the live College Scorecard API for comprehensive coverage
  • Exempt Institutions: Primary/secondary schools (K-12) and international institutions are automatically excluded
  • Webhook Delivery: Accreditation metadata is included in verification.completed and verification.action_required webhooks
See Webhook Events for the complete accreditation metadata schema.

​
Qualification Examples

Common qualification types include:
  • Bachelor of Science in Computer Science (accreditation checked)
  • Master of Business Administration (accreditation checked)
  • Associate of Arts (accreditation checked)
  • High School Diploma (accreditation exempt)
  • GED (accreditation exempt)
  • Certificate in Web Development (accreditation checked if post-secondary)

​
Validation Rules

  • Date Format: graduationDate must be in YYYY-MM-DD format
  • Email Format: institutionContactEmail must be a valid email address if provided