Root-level fields
| Field | Type | Description |
|---|
condicio * |
any |
Immutable identifier for the Condicio schema version. |
specVersion * |
string |
Version of the Condicio specification this document conforms to. 0.1.0 |
id |
string |
Unique identifier for this contract document (UUID, URI, or application-specific ID). |
contract * |
object |
Top-level metadata about the contract document. |
parties * |
array |
Parties to the contract with roles and identifiers. Items: $defs/party |
dates |
array |
Key dates extracted from or associated with the contract. Items: $defs/contractDate |
clauses |
array |
Extracted clauses, sections, or provisions. Items: $defs/clause |
obligations |
array |
Obligations, covenants, duties, or action items imposed on any party. Items: $defs/obligation |
financials |
object |
Monetary terms and financial provisions. |
risks |
array |
Risk flags and assessments identified in the contract. Items: $defs/risk |
definitions |
array |
Defined terms and their definitions extracted from the contract. |
metadata |
object |
Extraction and processing metadata. |
contract
| Field | Type | Description |
|---|
title * | string | Full title or name of the contract. |
type | string | Classification of the contract type e.g. NDA, MSA, SOW, License Agreement, Service Agreement, Employment Agreement, Partnership Agreement, Lease, Purchase Agreement, Insurance Policy |
description | string | Short summary or purpose of the contract. |
language | string | Primary language of the contract (BCP 47 code) e.g. en, de, fr, ja |
jurisdiction | string | Governing jurisdiction e.g. New York, England and Wales, Delaware |
governingLaw | string | Explicit governing law clause text or reference. |
status | string | draft, proposed, executed, active, amended, terminated, expired, superseded |
contractId | string | External contract identifier used by the source system. |
executionDate | date | Date the contract was signed by all parties. |
effectiveDate | date | Date the contract becomes effective. |
expiryDate | date | Date the contract expires. |
renewalTerms | string | Description of renewal terms or conditions. |
amendmentSummary | string | Summary of amendments if this document supersedes a prior version. |
financials
| Field | Type | Description |
|---|
currency | string | Default currency for all financial terms (ISO 4217) e.g. USD, EUR, GBP |
totalContractValue | number | Total contract value in the default currency. |
paymentTerms | string | Standard payment terms (e.g. Net 30, Net 60). |
latePaymentPenalty | string | Late payment penalty or interest rate. |
terms | array | Individual financial terms extracted from the contract. Items: $defs/financialTerm |
paymentSchedule | array | Structured payment schedule. Items: $defs/payment |
definitions
| Field | Type | Description |
|---|
term * | string | The defined term or capitalised phrase. |
definition * | string | The definition text. |
clauseRef | string | Reference to the clause where this term is defined. |
metadata
| Field | Type | Description |
|---|
extractedAt | string | ISO 8601 timestamp of extraction. |
extractedBy | string | Name or identifier of the extraction tool or agent. |
extractionEngine | object | Tool, engine, or model used. Properties: name, version |
confidence | number | Overall extraction confidence score (0.0 to 1.0). |
sourceDocument | object | Reference to the source document. Properties: filename, mediaType, size, pages, hash, uri |
tags | array | Arbitrary tags or labels applied to this contract. |
custom | object | Extensible container for tool-specific or organisation-specific metadata. |
Defined types ($defs)
date
A date string in ISO 8601 format (YYYY-MM-DD) or full datetime.
contactInfo
Contact information for a person or organisation.
| Field | Type | Description |
|---|
name | string | Full name of the contact. |
email | string | Email address. |
phone | string | Phone number. |
address | address | Postal address ($defs/address). |
address
A postal address.
| Field | Type | Description |
|---|
street | string | Street address. |
city | string | City. |
stateOrProvince | string | State or province. |
postalCode | string | Postal or ZIP code. |
country | string | Country. |
party
A named party to the contract.
| Field | Type | Description |
|---|
id | string | Unique identifier for this party within the document. |
name * | string | Full legal name of the party. |
alias | string | Short name or abbreviation used throughout the contract. |
role * | string | Role in the contract e.g. buyer, seller, licensor, licensee, employer, employee, landlord, tenant, service provider, client |
type | string | Legal entity type e.g. corporation, llc, individual, partnership, government, non-profit |
jurisdiction | string | Jurisdiction of formation or residence. |
contact | contactInfo | Contact information ($defs/contactInfo). |
representative | contactInfo | Signatory or representative ($defs/contactInfo). |
contractDate
A named date associated with the contract.
| Field | Type | Description |
|---|
label * | string | Semantic label e.g. execution, effective, expiry, renewal, notice deadline, delivery, payment due, termination |
date * | date | The date value ($defs/date). |
description | string | Context or description of this date. |
clauseRef | string | Reference to the relevant clause. |
clause
An extracted clause, section, or provision.
| Field | Type | Description |
|---|
id * | string | Clause identifier (section number or generated ID). |
title | string | Clause heading or title. |
text * | string | Full text of the clause. |
summary | string | Short AI-generated or human-written summary. |
type | string | Classification e.g. confidentiality, indemnification, limitation of liability, termination, payment, warranty, intellectual property, data protection, non-compete, force majeure, dispute resolution, governing law, assignment, insurance, audit |
scope | string | Scope of the clause (e.g. which parties it binds). |
obligationRefs | array | References to obligations derived from this clause. |
riskRefs | array | References to risks identified in this clause. |
confidence | number | Extraction confidence (0.0 to 1.0). |
obligation
An obligation, duty, covenant, or action item imposed on a party.
| Field | Type | Description |
|---|
id | string | Unique identifier for this obligation. |
description * | string | Description of the obligation. |
obligor * | string | Party or role responsible for fulfilling the obligation. |
beneficiary | string | Party or role entitled to the obligation. |
type | string | Category e.g. payment, delivery, reporting, compliance, confidentiality, insurance, maintenance, notice, performance, non-competition |
deadline | string | Date or trigger for the obligation. |
deadlineType | string | fixed date, days from event, recurring, conditional, ongoing |
status | string | pending, fulfilled, overdue, waived, breached |
clauseRef | string | Reference to the source clause. |
confidence | number | Extraction confidence (0.0 to 1.0). |
financialTerm
A financial term or monetary provision.
| Field | Type | Description |
|---|
label * | string | Label e.g. contract value, annual fee, monthly payment, deposit, interest rate, late fee, minimum commitment, cap, threshold |
amount * | number | Monetary amount. |
currency | string | ISO 4217 currency code (overrides top-level currency). |
period | string | one-time, monthly, annually, quarterly, per unit |
description | string | Context or description. |
clauseRef | string | Reference to the relevant clause. |
payment
A scheduled payment.
| Field | Type | Description |
|---|
dueDate * | date | Due date ($defs/date). |
amount * | number | Payment amount. |
description | string | Description of the payment. |
condition | string | Condition or trigger for this payment. |
status | string | pending, paid, overdue, cancelled |
paidDate | date | Date paid ($defs/date). |
risk
A risk flag or assessment identified in the contract.
| Field | Type | Description |
|---|
id | string | Unique identifier for this risk. |
description * | string | Description of the risk. |
severity * | string | low, medium, high, critical |
category | string | financial, legal, compliance, operational, reputational, data security, intellectual property |
impact | string | Description of potential impact. |
mitigation | string | Existing mitigation or recommended action. |
affectedParty | string | Party most affected by this risk. |
clauseRef | string | Reference to the relevant clause. |
confidence | number | Extraction confidence (0.0 to 1.0). |