> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.theary.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Education history

> Education history record for verification.

# Education history

Education record to verify in `history.education`.

## Fields

| Field                     | Required | Type     | Description                                                                                            |
| ------------------------- | -------- | -------- | ------------------------------------------------------------------------------------------------------ |
| `institutionName`         | Yes      | `string` | Name of the educational institution. Example: `"University of California"`.                            |
| `qualification`           | Yes      | `string` | Educational qualification or credential earned. Example: `"Bachelor of Science in Computer Science"`.  |
| `fieldOfStudy`            | Yes      | `string` | Field of study or major subject area. Example: `"Computer Science"`.                                   |
| `institutionLocation`     | No       | `string` | Location of the educational institution. Example: `"Berkeley, CA"`.                                    |
| `startDate`               | No       | `string` | Start date of attendance in `YYYY-MM-DD` format.                                                       |
| `endDate`                 | No       | `string` | End date of attendance in `YYYY-MM-DD` format. Use for applicants who attended but did not graduate.   |
| `graduationDate`          | No       | `string` | Date of graduation or completion in `YYYY-MM-DD` format. Optional when the applicant did not graduate. |
| `institutionContactEmail` | No       | `string` | Institution contact email for verification. Must be valid when provided.                               |
| `institutionContactPhone` | No       | `string` | Institution contact phone number for verification.                                                     |

## Example

```json theme={null}
{
  "institutionName": "University of California",
  "qualification": "Bachelor of Science in Computer Science",
  "fieldOfStudy": "Computer Science",
  "institutionLocation": "Berkeley, CA",
  "startDate": "2014-08-25",
  "endDate": "2018-05-15",
  "graduationDate": "2018-05-15",
  "institutionContactEmail": "registrar@berkeley.edu",
  "institutionContactPhone": "+1-510-642-6000"
}
```

## Accreditation checking

For post-secondary institutions, education webhooks may include an accreditation summary (status, accreditor, and validity window). Primary and secondary (K-12) schools are typically excluded.

See [Webhook Events — Accreditation](/webhooks/events#accreditationresult-object).

## Qualification examples

Common qualification types include:

* **Bachelor of Science in Computer Science**
* **Master of Business Administration**
* **Associate of Arts**
* **High School Diploma**
* **GED**
* **Certificate in Web Development**

## Validation rules

* **Date Format**: `startDate`, `endDate`, and `graduationDate` must be in YYYY-MM-DD format when provided
* **Graduation**: `graduationDate` is optional; omit it (and use `endDate`) for applicants who attended but did not graduate
* **Email Format**: `institutionContactEmail` must be a valid email address if provided

## Related schemas

* [History](/api-reference/schemas/history) — Parent history schema
* [Verification request](/api-reference/schemas/verification-request) — Main verification request schema