Legal pillar · v0.8.1
contract Contract
Contract record adapted from OCDS party/contract pattern.
$id · https://corpospec.com/schemas/v0.8.1/contract.schema.json
Fields
| Field | Type | Required | Description |
|---|---|---|---|
| counterparty | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| effective_date | IsoDate | yes | ISO 8601 date (YYYY-MM-DD). |
| id | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| status | ContractStatus | yes | Contract status. |
| title | string | yes | |
| type | ContractType | yes | Contract type. |
| amendments | Amendment[] | — | |
| auto_renewal | boolean? | — | |
| compensation | Compensation? | — | |
| contract_subtype | ContractSubtype? | — | |
| dispute_resolution | DisputeResolution? | — | Mechanism agreed for resolving disputes between the parties. |
| documents | DocumentRef[] | — | |
| expiration_date | IsoDate? | — | |
| governing_law | IsoCountry? | — | |
| key_terms | string[] | — | |
| leave_days_per_year | integer? | — | |
| notice_period_days | integer? | — | |
| probation_months | integer? | — | |
| related_decisions | PathRef[] | — | |
| renewal_term_months | integer? | — | |
| social_insurance_status | SocialInsuranceStatus? | — | |
| value | ContractValue? | — | |
| working_hours_per_week | number? | — |
Definitions
Shared types referenced within this schema.
Amendment
Contract amendment.
Records a single post-execution change to the contract. Amendments are append-only —
do not mutate existing entries; record a new amendment that supersedes.
type: object
BaseSalary
Base salary component of compensation.
type: object
Benefit
A single employment benefit.
type: object
BenefitType
Benefit type classification.
enum: "transport", "equipment", "internet", "non-cash", "health", "recovery", "meals", "training", "pension", "other"
Compensation
Structured compensation breakdown for employment contracts.
type: object
ContractStatus
Contract status.
enum: "draft", "active", "expired", "terminated", "disputed"
ContractSubtype
Employment contract subtype.
enum: "managing-director", "employee", "minijob", "freelance"
ContractType
Contract type.
enum: "customer-agreement", "vendor", "employment", "nda", "partnership", "service", "license", "lease", "loan", "franchise", "construction", "consulting", "government", "insurance", "supply", "distribution"
ContractValue
Contract monetary value.
type: object
DisputeResolution
Mechanism agreed in the contract for resolving disputes between the parties.
DocumentRef
Contract document reference.
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_.-]+)+$
PaymentFrequency
Payment frequency.
enum: "one-time", "monthly", "quarterly", "annual", "weekly", "bi-weekly", "hourly", "per-milestone", "net30", "net60", "net90"
SocialInsuranceStatus
Social insurance obligation status.
enum: "mandatory", "exempt", "voluntary"
TaxTreatment
Tax treatment of a benefit.
enum: "tax-free", "flat-rate", "taxable"
VariableCompensation
Variable compensation component.
type: object
Reference in your YAML
# yaml-language-server: $schema=https://corpospec.com/schemas/v0.8.1/contract.schema.json