Companies House · Schema

disqualification

CompaniesUK GovernmentBusiness RegistrationCompany SearchOfficersFiling HistoryInsolvencyChargesPersons of Significant ControlOpen Data

Properties

Name	Type	Description
case_identifier	string	The case identifier of the disqualification.
address	object	The address of the disqualified officer as provided by the disqualifying authority.
company_names	array	The companies in which the misconduct took place.
court_name	string	The name of the court that handled the disqualification case.
disqualification_type	string	An enumeration type that provides the disqualifying authority that handled the disqualification case. For enumeration descriptions see `disqualification_type` section in the [enumeration mappings] (ht
disqualified_from	string	The date that the disqualification starts.
disqualified_until	string	The date that the disqualification ends.
heard_on	string	The date the disqualification hearing was on.
undertaken_on	string	The date the disqualification undertaking was agreed on.
last_variation	array	The latest variation made to the disqualification.
reason	object	The reason for the disqualification.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "disqualification",
  "properties": {
    "case_identifier": {
      "description": "The case identifier of the disqualification.",
      "type": "string"
    },
    "address": {
      "description": "The address of the disqualified officer as provided by the disqualifying authority.",
      "type": "object",
      "items": {
        "$ref": "http://127.0.0.1:10000/api.ch.gov.uk-specifications/swagger-2.0/spec/disqualifications.json#/definitions/address"
      }
    },
    "company_names": {
      "description": "The companies in which the misconduct took place.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "court_name": {
      "description": "The name of the court that handled the disqualification case.",
      "type": "string"
    },
    "disqualification_type": {
      "description": "An enumeration type that provides the disqualifying authority that handled the disqualification case.\n For enumeration descriptions see `disqualification_type` section in the [enumeration mappings] (https://github.com/companieshouse/api-enumerations/blob/master/disqualified_officer_descriptions.yml)",
      "type": "string"
    },
    "disqualified_from": {
      "description": "The date that the disqualification starts.",
      "type": "string",
      "format": "date"
    },
    "disqualified_until": {
      "description": "The date that the disqualification ends.",
      "type": "string",
      "format": "date"
    },
    "heard_on": {
      "description": "The date the disqualification hearing was on.",
      "type": "string",
      "format": "date"
    },
    "undertaken_on": {
      "description": "The date the disqualification undertaking was agreed on.",
      "type": "string",
      "format": "date"
    },
    "last_variation": {
      "description": "The latest variation made to the disqualification.",
      "type": "array",
      "items": {
        "$ref": "http://127.0.0.1:10000/api.ch.gov.uk-specifications/swagger-2.0/spec/disqualifications.json#/definitions/last_variation"
      }
    },
    "reason": {
      "description": "The reason for the disqualification.",
      "type": "object",
      "items": {
        "$ref": "http://127.0.0.1:10000/api.ch.gov.uk-specifications/swagger-2.0/spec/disqualifications.json#/definitions/reason"
      }
    }
  },
  "required": [
    "address",
    "disqualification_type",
    "disqualified_from",
    "disqualified_until",
    "reason"
  ]
}