People pillar · v0.16.0
job-requisition JobRequisition
Job requisition record.
$id · https://corpospec.com/schemas/v0.16.0/job-requisition.schema.json
Fields
| Field | Type | Required | Description |
|---|---|---|---|
| entity | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| headcount | integer | yes | |
| hiring_manager | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| id | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| opened_at | IsoDate | yes | ISO 8601 date (YYYY-MM-DD). |
| posted_jurisdictions | IsoCountry[] | yes | Jurisdictions the posting is published in (drives EU 2023/970 applicability). |
| posted_locations | PostedLocation[] | yes | Posting locations. |
| role | PathRef | yes | PathRef into `people/roles/<slug>`. |
| state | RequisitionState | yes | Requisition lifecycle state. |
| bdr_reference | PathRef? | — | PathRef into a relevant BDR / decision. |
| benefits_summary | PathRef[] | — | PathRefs into BDR 0069 BenefitPlan records. |
| closed_at | IsoDate? | — | |
| consent_record_template | PathRef? | — | PathRef into the consent-record template applied to candidates. |
| equity_disclosed_band | EquityBand? | — | |
| posting_url | string? | — | External job-board / careers-page URL. |
| recruiter | PathRef? | — | |
| salary_disclosed_band | SalaryBand? | — | Mandatory when `posted_jurisdictions` contains any EU member state. |
Definitions
Shared types referenced within this schema.
EquityBand
Equity-band (optional disclosure).
type: object
IsoCountry
ISO 3166-1 alpha-2 country code.
pattern: ^[A-Z]{2}$
IsoCurrency
ISO 4217 currency code.
pattern: ^[A-Z]{3}$
IsoDate
ISO 8601 date (YYYY-MM-DD).
type: string
PathRef
Path-based cross-reference relative to .corpospec/ root.
Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
pattern: ^[a-z0-9_-]+(/[a-z0-9_.-]+)+$
PostalAddress
Physical address aligned with schema.org PostalAddress.
type: object
PostedLocation
Posting location — either a fixed postal address or a remote
designation.
RequisitionState
Requisition lifecycle state.
enum: "draft", "open", "on_hold", "closed", "filled"
SalaryBand
Disclosed salary band — EU 2023/970 Art. 5 mandatory for EU
postings.
type: object
SalaryFrequency
Salary frequency basis.
enum: "annual", "monthly", "hourly"
Reference in your YAML
# yaml-language-server: $schema=https://corpospec.com/schemas/v0.16.0/job-requisition.schema.json