Developer API Suite

corporateDisqualification resource

Methods

  • get - Get a corporate officers disqualifications

Resource

{
    "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"
        }
    ],
    "person_number": "string"
}

Properties

Name Type Description Additional
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[] array

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[] array of string

The companies in which the misconduct took place.

 Optional
disqualifications[].court_name string

The name of the court that handled the disqualification case.

 Optional
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
disqualifications[].last_variation[] array

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. Only applicable if reason.act is company-directors-disqualification-northern-ireland-order-2002.

 Optional
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. Only applicable if reason.act is company-directors-disqualification-act-1986 or sanctions-anti-money-laundering-act-2018 or sanctions-counter-terrorism-regulations-2019.

 Optional
disqualifications[].undertaken_on date

The date the disqualification undertaking was agreed on.

 Optional
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[] array

Permissions that the disqualified officer has to act outside of their disqualification.

 Optional
permissions_to_act[].company_names[] array of string

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.
person_number string

The disqualified officer's person number.

 Optional
Built by Companies House