opencontrolslicensegrantv1.schema.json
A PRIVATE, per-grantee license grant — the credential a licensee holds when a source separately licenses rights (e.g. a TDM, derivative, or distribution license) that the public usage-license verdict reports as restricted. This is the mirror image of the public OpenControls Usage License: the verdict says what the world may do; a grant says what one named grantee may ADDITIONALLY do. It is layered on the public verdict for that grantee only and can only OPEN rights for the holder — it never restricts further and never changes another party's verdict. A grant is authoritative only when explicitly provided and verified; it is never inferred. Held locally by the grantee; optionally registered with OpenControls as a verifiable record that confirms possession without exposing terms. Sibling vocabulary to opencontrolsusagelicensev1; reuses its rights keys and condition codes. Not legal advice.
type · thingOpen Controls vocabularystatus · draftv1
{
"Opencontrolslicensegrantv1": {
"@type": "String",
"schemaVersion": "String",
"@context": "https://opencontrols.ai",
"@id": "URL",
"grantId": "String",
"subject": {
"@type": "Subject",
"domain": "String",
"analyzedUrl": "String",
"work": "String",
"directory": "String",
"scope": "String",
"category": "String",
"contentSummary": "String"
},
"grantor": {
"@type": "Grantor",
"name": "String"
},
"grantee": {
"@type": "Grantee",
"account": "String"
},
"rights": {
"@type": "Rights",
"scrape": {
"@type": "Scrape",
"state": "String",
"confidence": "String",
"conditions": [
{
"conditions(item)": "String"
}
],
"needsReview": "String",
"note": "String",
"basis": [
{
"basis(item)": "String"
}
]
},
"tdm": {
"@type": "Tdm"
},
"aiTrain": {
"@type": "AiTrain"
},
"aiUse": {
"@type": "AiUse"
},
"derive": {
"@type": "Derive"
},
"redistribute": {
"@type": "Redistribute"
},
"transform": {
"@type": "Transform"
},
"tag": {
"@type": "Tag"
}
},
"term": {
"@type": "Term",
"elementId": "String",
"effectiveFrom": "Datetime",
"expiresAt": "Datetime"
},
"grantEvidence": {
"@type": "GrantEvidence",
"instrument": "String",
"reference": "String",
"signedBy": "String",
"signatureMethod": "String"
},
"verification": {
"@type": "Verification",
"status": "String",
"verifyUrl": "String",
"registry": "String"
},
"references": [
{
"references(item)": {
"@type": "References(item)",
"id": "String",
"title": "String",
"url": "URL"
}
}
],
"disclaimer": "String"
}
}{
"Opencontrolslicensegrantv1": {
"@type": {
"type": "String"
},
"schemaVersion": {
"type": "String"
},
"description": "A PRIVATE, per-grantee license grant — the credential a licensee holds when a source separately licenses rights (e.g. a TDM, derivative, or distribution license) that the public usage-license verdict reports as restricted. This is the mirror image of the public OpenControls Usage License: the verdict says what the world may do; a grant says what one named grantee may ADDITIONALLY do. It is layered on the public verdict for that grantee only and can only OPEN rights for the holder — it never restricts further and never changes another party's verdict. A grant is authoritative only when explicitly provided and verified; it is never inferred. Held locally by the grantee; optionally registered with OpenControls as a verifiable record that confirms possession without exposing terms. Sibling vocabulary to opencontrolsusagelicensev1; reuses its rights keys and condition codes. Not legal advice.",
"@context": "https://opencontrols.ai",
"@id": {
"description": "Traversable URL of the hierarchy item record.",
"type": "URL"
},
"grantId": {
"type": "String"
},
"subject": {
"@type": "Subject",
"domain": {
"type": "String"
},
"analyzedUrl": {
"type": "String"
},
"work": {
"description": "Optional specific work/dataset/path the grant is scoped to.",
"nullable": true,
"type": "String"
},
"directory": {
"type": "String"
},
"scope": {
"type": "String"
},
"category": {
"type": "String"
},
"contentSummary": {
"type": "String"
}
},
"grantor": {
"@type": "Grantor",
"description": "The rightsholder issuing the grant.",
"name": {
"description": "The name of the item or record.",
"type": "String"
}
},
"grantee": {
"@type": "Grantee",
"description": "The single party that holds this grant. The overlay applies only to this grantee.",
"account": {
"description": "Opaque account identifier the engine layers the grant onto.",
"nullable": true,
"type": "String"
}
},
"rights": {
"@type": "Rights",
"scrape": {
"@type": "Scrape",
"state": {
"type": "String"
},
"confidence": {
"type": "String"
},
"conditions": [
{
"conditions(item)": {
"description": "A condition attached to the permitted rights. One of: attribution, sharealike, noncommercial.",
"type": "String"
}
}
],
"needsReview": {
"type": "String"
},
"note": {
"description": "Free-text annotation; genre + jurisdiction of the source.",
"type": "String"
},
"basis": [
{
"basis(item)": {
"type": "String"
}
}
]
},
"tdm": {
"@type": "Tdm"
},
"aiTrain": {
"@type": "AiTrain"
},
"aiUse": {
"@type": "AiUse"
},
"derive": {
"@type": "Derive"
},
"redistribute": {
"@type": "Redistribute"
},
"transform": {
"@type": "Transform"
},
"tag": {
"@type": "Tag"
}
},
"term": {
"@type": "Term",
"description": "A given term representing a single word or multi-word expression as an Object.",
"elementId": {
"description": "Stable identifier for the hierarchy item in the dataset.",
"type": "String"
},
"effectiveFrom": {
"type": "Datetime"
},
"expiresAt": {
"description": "null = no stated expiry.",
"nullable": true,
"type": "Datetime"
}
},
"grantEvidence": {
"@type": "GrantEvidence",
"description": "The instrument behind the grant, so a verifier can audit it without seeing the contract. Named grantEvidence (not evidence) because the Open Controls vocabulary already uses `evidence` as a leaf array on signals — a name can only be one layer per vocabulary.",
"instrument": {
"description": "e.g. 'TDM License Agreement', 'MSA', 'data license'.",
"type": "String"
},
"reference": {
"description": "Contract/agreement identifier or URL (may be access-controlled).",
"nullable": true,
"type": "String"
},
"signedBy": {
"nullable": true,
"type": "String"
},
"signatureMethod": {
"description": "Allowed values: wet, docusign, click, other.",
"nullable": true,
"type": "String"
}
},
"verification": {
"@type": "Verification",
"description": "How the grant is held and whether OpenControls can attest to it.",
"status": {
"description": "Release status: Released, In Review, or On Hold.",
"type": "String"
},
"verifyUrl": {
"description": "Canonical URL to verify and retrieve the full registered OpenControls license.",
"type": "String"
},
"registry": {
"type": "String"
}
},
"references": [
{
"description": "Optional provenance — the agreement or policy basis, reusing the usage-license Reference shape.",
"references(item)": {
"@type": "References(item)",
"id": {
"description": "Provenance link to the source corpus document_id.",
"type": "String"
},
"title": {
"description": "Document title as published, whitespace-normalized and BibTeX-escaped.",
"type": "String"
},
"url": {
"description": "Canonical URL at the publisher's site, never a mirror.",
"type": "URL"
}
}
}
],
"disclaimer": {
"type": "String"
}
}
}