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

# Business context

> Hiring context for the job the applicant is applying for.

# Business context

Hiring context for the role the applicant is applying for (employer, title, worksite, salary).

## Fields

| Field                       | Required | Type      | Description                                                                                                         |
| --------------------------- | -------- | --------- | ------------------------------------------------------------------------------------------------------------------- |
| `entityName`                | Yes      | `string`  | Employer the candidate is applying to. Example: `"Acme Corp"`.                                                      |
| `appliedJobTitle`           | Yes      | `string`  | Job title the candidate is applying for. Example: `"Senior Software Engineer"`.                                     |
| `worksiteCity`              | Yes      | `string`  | City of the candidate's proposed worksite. Example: `"San Francisco"`.                                              |
| `worksiteState`             | Yes      | `string`  | Two-letter state code for the proposed worksite. Example: `"CA"`.                                                   |
| `proposedSalary`            | Yes      | `number`  | Candidate's proposed salary as a number. Example: `100000`.                                                         |
| `positionLevel`             | No       | `string`  | Candidate's proposed job level. Common values: `EXECUTIVE`, `STANDARD`, `SENSITIVE` (not enum-enforced by the API). |
| `securityClearanceRequired` | No       | `boolean` | Whether the role requires security clearance.                                                                       |
| `industrySector`            | No       | `string`  | Industry sector for regulatory context. Example: `"TECHNOLOGY"`.                                                    |

## Example

```json theme={null}
{
  "entityName": "Acme Corp",
  "appliedJobTitle": "Senior Software Engineer",
  "worksiteCity": "San Francisco",
  "worksiteState": "CA",
  "proposedSalary": 100000,
  "positionLevel": "STANDARD",
  "securityClearanceRequired": false,
  "industrySector": "TECHNOLOGY"
}
```

## Validation rules

* **State Format**: `worksiteState` must be exactly 2 characters
* **Salary**: `proposedSalary` must be a number (positivity is not API-enforced)
* **Position Level**: Accepted as a free-form string when provided; use the common values above for consistency

## Related schemas

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