> ## 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.

# Employment history

> Employment history record for verification.

# Employment history

Employment record to verify in `history.employment`.

## Fields

| Field              | Required | Type     | Description                                                           |                                                                                           |
| ------------------ | -------- | -------- | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| `employerName`     | Yes      | `string` | Name of the employer or company. Example: `"Tech Corp"`.              |                                                                                           |
| `position`         | Yes      | `string` | Job title or position held. Example: `"Software Engineer"`.           |                                                                                           |
| `employerLocation` | No       | `string` | Location where the applicant worked. Example: `"San Francisco, CA"`.  |                                                                                           |
| `employerEmail`    | No       | `string` | Employer contact email for verification. Must be valid when provided. |                                                                                           |
| `employerPhone`    | No       | `string` | Employer contact phone number for verification.                       |                                                                                           |
| `employerFax`      | No       | `string` | Employer contact fax number for verification.                         |                                                                                           |
| `startDate`        | No       | `string` | Start date of employment in `YYYY-MM-DD` format.                      |                                                                                           |
| `endDate`          | No       | \`string | null\`                                                                | End date of employment in `YYYY-MM-DD` format. Use `null` or omit for current employment. |

## Example

```json theme={null}
{
  "employerName": "Tech Corp",
  "position": "Software Engineer",
  "employerLocation": "San Francisco, CA",
  "employerEmail": "hr@techcorp.com",
  "employerPhone": "+1-555-123-4567",
  "startDate": "2020-01-15",
  "endDate": "2023-06-30"
}
```

## Validation rules

* **Date Format**: All dates must be in YYYY-MM-DD format
* **Email Format**: `employerEmail` must be a valid email address if provided
* **Current Employment**: Set `endDate` to null for current employment

## Related schemas

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