BETA This is a new service.

Methods

Resource Representation

{
   "company_number" : "string",
   "country_of_registration" : "string",
   "disqualifications" : [
      {
         "address" : {
            "address_line_1" : "string",
            "address_line_2" : "string",
            "country" : "string",
            "locality" : "string",
            "postal_code" : "string",
            "premises" : "string",
            "region" : "string"
         },
         "case_identifier" : "string",
         "company_names" : [
            "string"
         ],
         "court_name" : "string",
         "disqualification_type" : "string",
         "disqualified_from" : "date",
         "disqualified_until" : "date",
         "heard_on" : "date",
         "last_variation" : {
            "case_identifier" : "string",
            "court_name" : "string",
            "varied_on" : "date"
         },
         "reason" : {
            "act" : "string",
            "article" : "string",
            "description_identifier" : "string",
            "section" : "string"
         },
         "undertaken_on" : "date"
      }
   ],
   "etag" : "string",
   "kind" : "string",
   "links" : {
      "self" : "string"
   },
   "name" : "string",
   "permissions_to_act" : [
      {
         "company_names" : [
            "string"
         ],
         "court_name" : "string",
         "expires_on" : "date",
         "granted_on" : "date"
      }
   ]
}
Parameter NameTypeDescriptionAdditional
company_number string The registration number of the disqualified officer. Optional.
country_of_registration string The country in which the disqualified officer was registered. Optional.
disqualifications[] list The officer's disqualifications.
disqualifications[].address object The address of the disqualified officer as provided by the disqualifying authority.
disqualifications[].address.address_line_1 string The first line of the address. Optional.
disqualifications[].address.address_line_2 string The second line of the address. Optional.
disqualifications[].address.country string The country. For example, UK. Optional.
disqualifications[].address.locality string The locality. For example London. Optional.
disqualifications[].address.postal_code string The postal code. For example CF14 3UZ. Optional.
disqualifications[].address.premises string The property name or number. Optional.
disqualifications[].address.region string The region. For example Surrey. Optional.
disqualifications[].case_identifier string The case identifier of the disqualification. Optional.
disqualifications[].company_names[] list The companies in which the misconduct took place. Optional.
disqualifications[].court_name string The name of the court that handled the disqualification case. Optional. Only applicable if disqualification_type is court-order.
disqualifications[].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.
disqualifications[].disqualified_from date The date that the disqualification starts.
disqualifications[].disqualified_until date The date that the disqualification ends.
disqualifications[].heard_on date The date the disqualification hearing was on. Optional. Only applicable if disqualification_type is court-order.
disqualifications[].last_variation object The latest variation made to the disqualification. Optional.
disqualifications[].last_variation.case_identifier string The case identifier of the variation. Optional.
disqualifications[].last_variation.court_name string The name of the court that handled the variation case. Optional.
disqualifications[].last_variation.varied_on date The date the variation was made against the disqualification. Optional.
disqualifications[].reason object The reason for the disqualification.
disqualifications[].reason.act string An enumeration type that provides the law under which the disqualification was made. For enumeration descriptions see act section in the enumeration mappings.
disqualifications[].reason.article string The article of the act under which the disqualification was made. Optional. Only applicable if reason.act is company-directors-disqualification-northern-ireland-order-2002.
disqualifications[].reason.description_identifier string An enumeration type that provides the description for the reason of disqualification. For enumeration descriptions see description_identifier section in the enumeration mappings.
disqualifications[].reason.section string The section of the act under which the disqualification was made. Optional. Only applicable if reason.act is company-directors-disqualification-act-1986.
disqualifications[].undertaken_on date The date the disqualification undertaking was agreed on. Optional. Only applicable if disqualification_type is undertaking.
etag string The ETag of the resource.
kind string Possible values are:
  • corporate-disqualification
links object Links to other resources associated with this officer disqualification resource.
links.self string Link to this disqualification resource.
name string The name of the disqualified officer.
permissions_to_act[] list Permissions that the disqualified officer has to act outside of their disqualification. Optional.
permissions_to_act[].company_names[] list The companies for which the disqualified officer has permission to act. Optional.
permissions_to_act[].court_name string The name of the court that granted the permission to act. Optional.
permissions_to_act[].expires_on date The date that the permission ends.
permissions_to_act[].granted_on date The date that the permission starts.