Permalink
Fetching contributors…
Cannot retrieve contributors at this time
111 lines (110 sloc) 3.47 KB
{
"$schema": "http://json-schema.org/draft-04/schema#",
"description": "A Licence is a permission for an entity to do something that would otherwise not be permitted. Note that such permissions are recorded in multiple different ways and to different granularity. In addition categories cross over, for example a pawnborker may be regulated as a retail establishment by a city, but also as a financial institution by a national or regional financial regulator. Sometimes the licence is a simple statement – the government of Rwanda has given a banking licence to a certain bank -- other times it is fine-grained and highly complex (e.g. an extractives licence or the UK FCA licencing scheme). This schema tries to make it easy to submit the former, while not losing granularity of the latter. The object has the name of Rich Licence to distinguish it from Simple Licence, which it is expected to ultimately replace.",
"properties": {
"licence_holder": {
"$ref": "includes/entity.json"
},
"licence_issuer": {
"oneOf": [
{
"type": [
"string",
"null"
],
"minLength": 2
},
{
"$ref": "includes/organisation.json"
}
]
},
"licenced_location": {
"$ref": "includes/address.json"
},
"licence_number": {
"type": "string"
},
"start_date": {
"description": "The issue date of the licence",
"type": "string",
"format": "date"
},
"end_date": {
"description": "The expiry date of the licence",
"type": "string",
"format": "date"
},
"source_url": {
"description": "Place where this fact can be verified",
"type": "string",
"minLength": 1
},
"confidence": {
"description": "Confidence in accuracy of data",
"type": "string",
"enum": [
"HIGH",
"MEDIUM",
"LOW"
]
},
"renewal_date": {
"type": "string",
"format": "date"
},
"sample_date": {
"description": "Date on which we know this to be true (usually date this information was retrieved from the source)",
"type": "string",
"format": "date"
},
"retrieved_at": {
"description": "The time or date at which the source URL was requested",
"type": "string",
"format": "date"
},
"licence_url": {
"type": "string",
"description": "A public URL for the licence"
},
"jurisdiction_of_licence": {
"type": "string",
"description": "The area in which this licence is valid"
},
"status": {
"type": "string",
"description": "The status of the licence. If the licence is made up of a number of permissions, each of which has a status, store the status in the permissions field instead/as well"
},
"category": {
"description": "Category of licence",
"type": "array",
"items": {
"type": "string",
"enum": [
"Financial",
"Business",
"Extractive"
]
}
},
"permissions": {
"type": "array",
"items": {
"$ref": "includes/permission.json"
}
},
"other_attributes": {
"description": "Use for other licence attributes for which we don't yet have curated schema attributes",
"type": "object"
}
},
"additionalProperties": false,
"required": [
"source_url",
"sample_date",
"licence_holder",
"permissions",
"licence_issuer",
"jurisdiction_of_licence"
]
}