Introduction
T2A is an Application Programming Interface (API) providing fast, reliable and secure online transactional access to our data sets and validation services.
T2A is comprised of a number of methods which offer our services. These methods may be accessed from your website or application via XML, SOAP or JSON.
This documentation is intended to be used by software developers intending to use one or more of the T2A methods. We provide a simple XML/JSON interface, promising easy integration; we also provide code samples in some popular languages including PHP, "classic" ASP and JavaScript.
General API Guide
API Endpoint & Authentication
T2A offers XML / JSON and SOAP API endpoints to suit your development framework.
XML / JSON
https://api.t2a.io/rest/
Our XML / JSON endpoint will output a response in XML by default or JSON if the output
parameter is
set to json (see example below).
SOAP
https://api.t2a.io/soap/
API Key Authentication
All T2A methods require authentication using the mandatory input parameter api_key
. An API Key must
be obtained by signing up.
If you've already registered, you can view your API key by logging
in.
Your API key should not be disclosed to third parties, and should not be included in web pages; however, other security measures are available to prevent unauthorised use of your account.
Example request URL
Free Test Mode
As an aid to developers during the early stages of integration, every method can operate in a limited test mode, which is free to use.
When in a test mode, the method returns dummy data in an identical form to a real execution. This facility is available to XML, JSON, and SOAP users.
To use test mode, simply set the API key (or a JavaScript key) to test
.
Please note that the test mode should only be used for initial connectivity and parsing tests; ensure that your real API key is used on "live" services.
Further details on the free test mode for each method can be found in the detailed documentation for each method.
XML and JSON REST API Overview
asy to use XML and JSON API. Requests may be made via POST or GET. The response is XML by default; adding the parameteroutput=json
returns a JSON response. The XML and JSON API is available at:-
The default XML response is shown below. Note the status and error code:-
<?xml version="1.0"?> <T2A_Result> <mode>normal</mode> <status>error</status> <error_code>missing_method</error_code> <t2a_version_number>1.0.0</t2a_version_number> </T2A_Result>
The default JSON response is shown below:-
{ "mode":"normal", "status":"error", "error_code":"missing_method", "t2a_version_number":"1.0.0" }
You can optionally specify a JSONP padding callback function in which the JSON is to be wrapped; the use of the
parameter and values callback=myPadding
is shown below:-
myPadding({ "mode":"normal", "status":"error", "error_code":"missing_method", "t2a_version_number":"1.0.0" });
URL Encoding a GET Request
The JSON and XML API is normally invoked as an HTTP GET request, with parameters included in the query string.
When making a GET request, remember to URL encode the value part of each
parameter=value
pair.
Here are some common code examples:-
Language | Example |
---|---|
"Classic" ASP | "&name=" & Server.urlencode(input_name) |
PHP | "&name=" . urlencode($input_name) |
JavaScript | "&name=" + encodeURI(input_name) |
SOAP API
Developers may prefer to use our SOAP XML API, which is a superset of the XML API.
The SOAP XML API is available:-
The above location allows access to the T2A web services description page; it also allows developers to view the WSDL service description, and to test each method, using an API key.
Using XML, JSON and SOAP Methods
Each service can be executed in a single HTTP or HTTPS request to our servers; there is no requirement to negotiate an access key.
When using XML or SOAP, most methods return data in an XML element which is named (method_name)_res
; for example,
area_code returns the result in an XML element named <area_code_res>
.
Every XML, JSON and SOAP result contains common status, error code and version number components.
Full details on the XML, JSON and SOAP API are available here.
Asynchronous Methods
Most of the services available in T2A are synchronous - they return as quickly as possible with the result.
For some methods, mainly those involving bulk operations, the operation is asynchronous.
Every asynchronous service revolves around the creation of a "job", and the background execution of T2A on that job.
A typical asynchronous service follows these stages:-
- Create a Job. T2A gives you an encrypted unique job ID. This contains only alphanumeric characters plus underscore and dash.
- Pass your data into that job.
- Start the job processing.
- Read the progress of the job, as a percentage.
- When that percentage has reached 100, the job is completed.
- Read or download the processed data from the completed job.
Currently the only asynchronous method is deceased_bulk.
Using Your Account Control Panel
The control panel is used to:-
- Buy credits
- Configure IP address restrictions
- View your transactions
- Download usage statistics
Security
As a T2A customer, you may configure and control the security of your account credits - preventing unauthorised use.
- Using the control panel, add the IP address(es) of your server(s) which are permitted to use your T2A account. If any IP addresses are in the permitted list, requests from other IP addresses will be denied.
- When invoking T2A from client-side JavaScript, generate a secure temporary key (we refer to this as a JavaScript key) that can be safely included in your HTML mark-up, using the javascript_key method. This key expires after a short period, and is restricted to only function on your specified domain, and can optionally be configured to only operate for the user's IP address.
- All methods can be optionally invoked via HTTPS.
Code Examples
Code examples for the area_code method in PHP and jQuery:
PHP
<?php // Get text from query string or set to empty $text = isset($_GET['text']) ? $_GET['text'] : ''; $url = 'https://api.t2a.io/rest/?' . 'method=area_code' . '&api_key=YOUR_API_KEY' . '&text=' . urlencode($text); // Fetch XML from T2A API $result = simplexml_load_file($url); if($result) { // Check for errors if($result->status == 'ok') { $area_code_list = $result->area_code_list; } else { // Report error echo 'Error: ' . $result->error_code; exit; } } ?> <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Code example</title> </head> <body> <!-- iterate over list of area codes --> <?php foreach($area_code_list->area_code as $area_code): ?> <!-- output area code --> <h3><?php echo $area_code->code; ?></h3> <ul> <!-- iterate over list of places in this area code --> <?php foreach($area_code->place_list->place as $place): ?> <!-- output place name --> <li><?php echo $place->name; ?></li> <?php endforeach; ?> </ul> <?php endforeach; ?> </body> </html>
jQuery
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Code example</title> <script type="text/javascript" src="http://code.jquery.com/jquery-latest.min.js"></script> <script type="text/javascript"> $(document).ready(function(){ // Attach code to form's onsubmit event $(".demo").submit(function() { // Fetch JSON from T2A API $.getJSON("https://api.t2a.io/rest/?callback=?", { "method" : "area_code", "api_key" : "YOUR_API_KEY", // better to use js_key obtained from javascript_key service for security reasons "output" : "json", "text" : $("#text").val() }, // Function to parse resulting JSON function(result) { // Check for errors if(result.status == "ok") { var html = "<p><strong>Your search returned the following dialling codes:</strong></p>"; $.each(result.area_code_list, function() { html += "<h3>" + this.code + "</h3><ul>"; $.each(this.place_list, function() { html += "<li>" + this.name + "</li>"; }); html += "</ul>"; }); $("#results").html(html); } else { // report error alert("Error: " + result.error_code); } } ); return false; }); }); </script> </head> <body> <form class="demo"> <label for="text">Dialling code, location, or postal area:</label> <input type="text" id="text" /> <input type="submit" /> </form> <div id="results"></div> </body> </html>
XML, JSON and SOAP API Details
General XML, JSON and SOAP Overview
We offer a very simple, structured XML API, which can also return a JSON response. We also offer a SOAP API, which is a superset of the XML API, using the same format of results, wrapped in a SOAP response.
The primary focus of the documentation in this section is aimed at users of the XML and JSON API; SOAP users generally would use the SOAP API as an external web service, using an IDE such as Visual Studio which creates classes to de-serialize the SOAP responses.
Accessing the XML and JSON API
The XML and JSON API is available:-
Accessing the SOAP API
The SOAP XML API is available:-
.NET developers using Visual Studio should use the above location when adding web services to their projects. A WSDL is available.
A JavaScript Key
The T2A methods may be invoked from client-side JavaScript. In order to secure this facility, we have created a system allowing you to create a secure temporary key. Advantages are:-
- There is no need to embed your API key in the HTML; use the temporary key.
- The temporary key will only work when invoked in a specified website domain.
- The temporary key will expire after a specified number of minutes, never more than 60.
- The temporary key can optionally be further secured to only operate on the final client's IP address.
- The key is encrypted using 256-bit AES encryption.
Use the method javascript_key to create the temporary key, to be embedded in your web page.
More information about using T2A from JavaScript can be found here.
Security
All server-side requests require your API key.
JSON requests, and XML requests which are launched from JavaScript, should use our javascript_key method to obtain a temporary, secure key which is safe to include in HTML markup, since it expires within an hour, and can be restricted to the final user's IP address.
Invoking Methods
The XML and JSON API accepts GET and POST requests; the methods can be tested using a web browser.
Using T2A from JavaScript
Developers experienced in using external web services from JavaScript may wish to skip this section.
Cross-Domain Ajax
For reasons of web browser security, it is not normally possible to load scripts from one domain into another. For example, the following are prohibited:
- Issuing an XMLHttpRequest() to another domain (a core component of Ajax).
- Accessing or modifying the DOM of a <frame> or <iframe> which has a src attribute with another domain.
- Accessing or modifying another window (or tab) which has a different location.
Therefore, it is not possible to use T2A directly from Ajax on your web pages, because your Ajax request will be to a domain other than your own.
We now demonstrate three solutions to this problem.
Solution 1 - Raw JavaScript
This section demonstrates how to securely use T2A from client-side JavaScript, without using a JavaScript Library such as jQuery.
We will use a technique known as on-demand JavaScript, to force the web browser to load an external Javascript source, which in this case, is a T2A JSON response.
These examples use PHP.
Obtain a Temporary JavaScript Key
In your server-side scripting, obtain a JavaScript key. This example uses PHP:-
<?php $js_key = ""; //the temp key $api_key = ""; //set your API key here $url = "https://api.t2a.io/rest?" . "method=javascript_key" . "&api_key=" . $api_key . "&lifetime_minutes=" . (2 * 60) // Life time in minutes (max 24 hours) . "&domain=t2a.co"; // Replace with your website's domain // Fetch XML from T2A API $result = simplexml_load_file($url); if ($result && $result->javascript_key) { $js_key = (string)$result->javascript_key; } ?>
The temporary key is stored in the server-side variable $js_key
in the example above.
Action a Client-Side Request to T2A
Using the temporary key, we may now send a request from the browser, to T2A.
This is done by inserting a <script> tag into the DOM, where the external JavaScript is actually a request to T2A (JSON). This does not violate browser security.
The resulting JavaScript object returned from T2A can easily be accessed.
The JavaScript is part of a server-side script, in this case PHP. This allows the temporary key to be written into the HTML:-
// generic function to insert a script tag to execute the url // which is an external JavaScript (JSON) function get_json(url) { var head = document.getElementsByTagName("head")[0]; var script = document.createElement("script"); script.type = "text/javascript"; script.src = url; head.appendChild(script); } // set a javascript variable, note that this is actually written by the // PHP to set the temp key var javascript_key = "<?php echo $js_key; ?>"; // Fetch JSON from T2A API // this is using the method ip_country // note that we use the callback function to make the resulting // JSON be sent to our parse_json function window.onload = function() { var url = "https://api.t2a.io/rest?" + "method=ip_country" + "&javascript_key=" + javscript_key + "&output=json" + "&callback=parse_json"; get_json(url); }
The function we use to parse the JSON is shown below. Here, we use simple JavaScript alert boxes to show the result or error:-
function parse_json(result) { if(result.status == "ok") { alert('Your IP address is ' + result.ip_address + ' and your country code is ' + result.country_code); } else { // report error alert(result.error_code); } }
Solution 2 - jQuery
Using jQuery simplifies the process of sending the client-side request to T2A.
The example below is in PHP. As with the raw JavaScript example above, we have
obtained a temporary key (see above), stored in the server-side variable $js_key
.
This is written into the HTML markup by PHP, so that it can become a client-side
variable called javascript_key
.
The jQuery functions are then used to send and process the JSON request to T2A:-
// set a javascript variable, note that this is actually written by the // PHP to set the temp key var javascript_key="<?php echo $js_key; ?>"; $(document).ready(function(){ // Fetch JSON from T2A API $.getJSON( "https://api.t2a.io/rest?callback=?", { 'method' : 'ip_country', 'javascript_key' : javascript_key, 'output' : 'json' }, // Function to parse resulting JSON function(result) { // Check for errors if(result.status == "ok") { alert('Your IP address is ' + result.ip_address + ' and your country code is ' + result.country_code); } else { // report error alert(result.error_code); } } }); });
Solution 3 - Use Ajax
You could use Ajax to access T2A by creating a server-side component on your own web server which receives the Ajax request, and then communicates with T2A.
For example, if you were using the ip_location method on a PHP website:-
- Create a .php file to process an Ajax request; we'll call it
iploc.php
- Your Ajax request will use
iploc.php
on your domain (and thus avoiding cross-domain security issues). - The php will send a request directly to T2A from the server, and will echo the response back, to the client-side Ajax component.
In effect, iploc.php
is a proxy, allowing you to use Ajax.
.NET Developers and the SOAP API
.NET developers using Visual Studio should create a web reference using https://api.t2a.io/soap
In the examples below, our web reference is named t2a. The class containing the methods is named t2a.T2A, and the result classes are also in the t2a namespace.
This is a C# illustration of the use of the ip_location method:-
// create a web reference using https://api.t2a.io/soap // // the reference here is named t2a, and the class is called T2A // // create an instance of t2a.T2A t2a.T2A myclass = new t2a.T2A(); // the result class is also in t2a // t2a.ip_location_res res = myclass.ip_location(api_key, null, ip_address); // check the status, if ok, display results, otherwise display the error if (res.status.CompareTo("ok") == 0)
This is a Visual Basic illustration of the use of ip_location:-
' execute the method ' replace with your own API key Dim api_key As String = "---" ' create a web reference using https://api.t2a.io/soap ' the reference here is named t2a, and the class is called T2A ' create an instance of t2a.T2A Dim myclass2 As New t2a.T2A() ' the result class is also in t2a Dim res As t2a.ip_location_res = myclass2.ip_location(api_key, "", ip_address) ' check the status, if ok, display results, otherwise display the error If (res.status = "ok") Then
Next: Result Page Caching
Documentation on how to use T2A from .NET by using the SOAP API.Result Page Caching
Some of our methods produce large result sets, comprising hundreds of records. To make this large result list usable to their end clients, developers will probably wish to present the records in shorter pages of results. In order to achieve this, it would be necessary to store the entire result set on your web server, either in a memory cache, or a short-lived database cache.
T2A offers a transparent page cache on methods that can produce large result sets. The XML, JSON and SOAP APIs will store the complete result in a cache on your behalf (only usable by you) for 60 minutes, to allow easy paging for your final clients. In order to use the cache, you must set both of the following parameters:-
records_per_page
- specifies the number of records to be displayed on a page.page_number
- specify the page number to be displayed. This is a zero-based integer.
Those methods that offer page caching include the following in their result:-
total_records
- the total number of records in the result set.page_number
- the current page number, a zero based integer.
Common XML, JSON, and SOAP Error Codes
The error codes below are applicable to all methods:-
Name | Description |
---|---|
method_not_subscribed | You are not subscribed to the specified method. |
missing_(param) | The named mandatory parameter is missing. For example:- missing_api_key indicates that the
parameter api_key is missing.
|
invalid_(param) | The named parameter is in an invalid format. For example:- invalid_api_key indicates that the
api_key value is invalid.
|
expired_javascript_key | The javascript_key value, used during client-side request, has expired. |
http_referrer_missing | When a javascript_key is in use, the http referrer request header was missing, so the domain cannot be authenticated. |
client_ip_address_not_allowed | When a javascript_key is in use, the IP address permitted to use the key does not match the final user's IP address. |
client_domain_not_allowed | When not using a JavaScript key, the IP address from which the request has originated does not match any of the permitted IP addresses set the control panel. |
unauthorised_ip_address | When not using a JavaScript key, the IP address from which the request has originated does not match any of the permitted IP addresses set the control panel. |
insufficient_credit | You do not have sufficient credit to use this method. |
too_many | The request returned more records than can be included in the response. More information should be supplied to allow the search to be narrowed. |
no_record | The request returned no records. We return an error code in preference to the more verbose option of returning an empty result set. |
invalid_address | The address given in the input parameters is invalid. |
failed | A general error has occurred. In normal operation you should never see this error; please use our backup facility. |
no_database | A general error has occurred. In normal operation you should never see this error; please use our backup facility. |
Common Response Structures
These structures are returned by more than one method.
Common Response Structure <address>
The address structure is returned by the address_search method.
Element | Description |
---|---|
line_1 | Address line 1. |
line_2 | Address line 2. |
line_3 | Address line 3. |
place | The place. If the address is in a named area
within a large town, this will be that area,
otherwise it will be the town. place is never
empty if town is set.
|
town | The town; only used if the address is in a named area within that town. |
postcode | The UK postal code, formatted to include the space. |
addr_single_line | The address, formatted as a single line. Commas are inserted between the major elements, and the postcode is included, if available. |
street | This is the "raw" element returned which is known as the thoroughfare. The cleaned elements line_1, line_2 and line_3 include this element. |
street2 |
This is the "raw" element returned which is known as the dependent thoroughfare. The cleaned elements line_1, line_2 and line_3 include this element. In a formatted address, this would appear before the thoroughfare, for example, street2 (the dependent thoroughfare) is the former:- Pudding Row |
premises | This is the "raw" building number. The cleaned elements line_1, line_2 and line_3 include this element. |
building | This is the "raw" building name. The cleaned elements line_1, line_2 and line_3 include this element. |
organisation | This is the "raw" organisation name. The cleaned elements line_1, line_2 and line_3 include this element. |
Common Response Structure <business>
Element | Description |
---|---|
name | Business name |
telephone_number | Telephone number |
line_1 | Address line 1 |
line_2 | Address line 2 |
line_3 | Address line 3 |
place | The place. If the address is in a named area
within a large town, this will be that area,
otherwise it will be the town. place is never
empty if town is set.
|
town | The town; only used if the address is in a named area within that town. |
postcode | The UK postal code, formatted to include the space. |
addr_single_line | The address, formatted as a single line. Commas are inserted between the major elements, and the postcode is included, if available. |
email_address | Contact email address for this business. |
web | Business website address. |
fax_number | Business fax number. |
classification | Business classification. |
company_number | Limited company number or non-limited company ID for use with the company_details method. |
Common Response Structure <company_short>
This structure is a brief summary of a company name and other details.
Note that the company_number
value is used in order to access the main company information methods.
Element | Description |
---|---|
name | The company name. |
company_number | The unique Companies House company number. |
data_set | The data set to which this record belongs. These are:-
|
company_index_status |
Effective: Proposed Name accepted for processing. Rejected: Proposed Name Rejected. Removed: Removed from register (Converted or Closed). CngOfName Change of name. Dissolved: Inliq: In Liquidation. StatusR For a Scottish company, this will indicate that the company is in receivership. For English/Welsh companies, the "receivership" flag may mean that one or more of the company's properties has gone into receivership. |
company_date | The date on which the action / event took place. |
Common Response Structure <director>
This structure is returned by the director_details and company_details methods. All elements may be empty unless stated.
Element | Description |
---|---|
title | The person's title, such as Mr, Mrs, Ms etc. |
forename | Only supplied where applicable - May be more than one occurrence. |
surname | The person's surname. |
honours | The person's honours. Note that this is only present when this instance is returned from the director_details method. |
nationality | The nationality. Note that this is only present when this instance is returned from the director_details method. |
corporate_indicator | Used to distinguish corporate appointments from natural person appointments. Will be set to "Y" or "1" if the officer is a corporate body. Otherwise set to space. Note that this is only present when the instance is returned from the director_details method or company_details method. |
country_state_of_residence | The 'Country/State of Residence' applies to officers who are indicated as Natural Person Directors. Data captured within this field will return for filings under the 2006 Act for these officer types only; Where there is no data captured the field will remain blank. |
name_single_line |
The name on a single line, comprising title, forename, middle initial and surname; for example:- Mr Alan Fiction |
director_id | An ID to be used in the director_details method, to obtain full information on the individual. Note that the ID consists only of alphanumeric characters plus the underscore _ and dash - characters. |
line_1 | Address line 1. Note that this is only present when the instance is returned from the director_details method or company_details method. |
line_2 | Address line 2. Note that this is only present when the instance is returned from the director_details method or company_details method. |
line_3 | Address line 3. Note that this is only present when the instance is returned from the director_details method or company_details method. |
place | The place. |
postcode | The postcode. |
addr_single_line | The address, formatted as a single line. Commas are inserted between the major elements, and the postcode is included, if available. |
dob | The date of birth in the format YYYY-MM-DD (e.g. 1963-05-16). |
num_appt | Total number of appointments of all kinds held by an individual. |
num_current_appt | Number of current appointments. |
num_dissoloved_appt | Number of dissolved appointments. |
num_resigned_appt | Number of resigned appointments. |
director_appt_list | List of director_appt records, this is only returned when the search was for current company officers. |
director_disq_list | List of director_disq records for a disqualified director. This is only returned when the search was for disqualified company officers. |
Common Response Structure <director_appt>
This structure is only used in conjunction with the above director structure, and only during the method director_details. This shows the appointments relating to this company officer.
Element | Description |
---|---|
company_name | The company name. |
company_number | The companies house number. |
company_status | The current status. The defined values include:-
|
status | The appointment status. The values include:-
|
type | The appointment type. See the Company Officer Types appendix. |
appointment_date | In the format YYYY-MM-DD |
resignation_date | In the format YYYY-MM-DD |
occupation | The occupation of the individual. |
date_prefix |
Only supplied where applicable, will be supplied if the appointee was appointed prior to the original data capture by Companies House and the appointment date was taken from the last Annual Return. An example is:- PRE- |
Common Response Structure <director_disq>
This structure is only used in conjunction with the above director structure, and only during the method director_details. This structure contains the information on the companies from which the individual is disqualified.
Element | Description |
---|---|
company_name | The company name. |
company_number | number The companies house number. |
reason |
Reason for disqualification. An example is:
See the appendix for an explanation. The above example means that the person was disqualified under the Company Directors Disqualification Act 1986 section 7. |
start_date | In the format YYYY-MM-DD |
end_date | In the format YYYY-MM-DD |
exemptions | Only supplied where applicable. This is a nested list (with no further children) of director_disq records. The record in the exemptions list do not have their reason and exemptions fields set. |
Common Response Structure <geo_data>
The address structure is returned by the geo_code and geo_code_telephone methods; not all elements are returned by both methods.
Element | Description |
---|---|
north | Northing value, if the data is in the UK. See Co-ordinate Systems. |
east | Easting value, if the data is in the UK. See Co-ordinate Systems. |
latitude | WGS 84 (GPS) latitude value. |
longitude | WGS 84 (GPS) longitude value. |
country_code | ISO 3166-1 two character country code. |
country_name | The country name. |
description | Description of the item. |
postcode | A full UK postcode; in the case of geo_code_telephone this is a sample postcode in the area indicated. |
city | The nearest city; this is only set by ip_location. |
UPRN | The Unique Property Reference Number (UPRN) for an address location. |
Common Response Structure <person>
The person structure is returned by the person_search method.
Element | Description |
---|---|
title | The person's title, such as Mr, Mrs, Ms etc. |
forename | The person's first name. |
middle_initial | The second initial. |
surname | The person's surname. |
name_single_line |
The name on a single line, comprising title, forename, middle initial and surname; for example:- Mr Alan Fiction |
line_1 | Address line 1. |
line_2 | Address line 2. |
line_3 | Address line 3. |
place | The place. If the address is in a named area
within a large town, this will be that area,
otherwise it will be the town. place is never empty if town is set.
|
town | The town; only used if the address is in a named area within that town. |
postcode | The UK postal code, formatted to include the space. |
addr_single_line | The address, formatted as a single line. Commas are inserted between the major elements, and the postcode is included, if available. |
years_list |
A list of years, in which the electoral roll record for this person has been found. Please note that the XML returns an array of <years_list> <string>2008</string> <string>2009</string> <string>2010</string> <string>2011</string> </years_list> The JSON returns an array of years thus:- "years_list":["2009","2010","2011"], |
telephone_number | The person's landline telephone number. |
mobile | The person's mobile telephone number. |
email_address | The person's email address. |
dob | The person's date of birth in YYYY-MM-DD format. |
director_id | A director ID, where available. To be used in conjunction with the director_details method. |
Common Response Structure <place>
The place structure is used in place lists returned by the person_search and business_search methods; not all elements are returned by each method.
Element | Description |
---|---|
name | The place name as a single line of text. For example:- Weymouth, Dorset |
Common Response Structure <premises>
An array of records is returned from an address-only person_search
-
the end user should select the premises at which to view the occupants. Use the name
value to replace
the premises
input parameter value.
You must use the entire name value, including the postal code, when replacing the premises value.
Element | Description |
---|---|
name | The name of a premises, for example:- 27 Imagination Gardens (YO10 5NP) |
Common Response Structure <street>
This structure is returned by the person_search
method.
An array of records is returned from an address-only search - the end user should select the street
on which to view the occupants. Use the name
value to replace the street
input
parameter value.
Element | Description |
---|---|
name | The street name, for example:- Imagination Gardens, Magic Street (YO10) |
Common Response Structure <date_details>
Element | Description |
---|---|
y | Year in YYYY format e.g. 2011 |
m | Month (1-12) |
d | Day (1-31) |
en | Date in 'D Mon YYYY' e.g. 1 Jun 2017 |
Common Response Structure <date_time>
Element | Description |
---|---|
year | Year in YYYY format e.g. 2011 |
month | Month (1-12) |
day | Day (1-31) |
hour | Hour (0-23) |
min | Minutes (0-59) |
sec | Seconds (0-59) |
Response Structure <company_shareholder>
This structure is returned by company_credit_report
and company_details methods.
This is a single shareholder within the <company_shareholder_list>
of a credit report.
Element | Description |
---|---|
name | Shareholder's name |
currency | Full description of the shares |
shares | Full description of the shares |
share_count | The shares amount |
share_type | The shares type |
nominal_value | The nominal value of the share |
percentage | The percentage held by this shareholder |
Response Structure <company_financial>
This structure is returned by company_credit_report and company_details methods. This is a single financial item (covering a described period) within the financial list. Note that there are sub-elements for profit and loss, balance sheet, capital reserve and ratio; the names of those elements are listed separately.
Element | Description |
---|---|
start_date | The start date YYYY-MM-DD |
end_date | The end date YYYY-MM-DD |
currency | Currency e.g. GBP |
period_months | The period covered, in months |
profit_loss | Company Profit and Loss information |
balance_sheet | Company Balance Sheet information |
capital_reserve | Company Capital Reserve information |
ratio | Company Ratio information |
net_cash_flow_from_operations | Financial Information |
net_cash_flow_before_financing | Financial Information |
net_cash_flow_from_financing | Financial Information |
contingent_liability | Financial InformationFinancial Information |
capital_employed | Financial Information |
employees | Number of employees |
auditors | The name of the auditors |
audit_qualification | Comments from the auditors |
bankers | Bankers |
bank_branch_code | The Sort code e.g. 60-60-05 |
Company Profit and Loss
These are the elements within the profit_loss
section.
Element |
---|
turnover |
consolidated_accounts |
cost_of_sales |
gross_profit |
export |
directors_emoluments |
operating_profits |
depreciation |
audit_fees |
interest_payments |
pre_tax |
taxation |
post_tax |
dividends_payable |
retained_profits |
salaries |
Company Balance Sheet
These are the elements within the balance_sheet
section.
Element |
---|
tangible_assets |
intangible_assets |
fixed_assets |
current_assets |
trade_debtors |
stock |
cash |
other_current_assets |
increase_in_cash |
misc_current_assets |
total_assets |
total_current_liabilities |
trade_creditors |
overdraft |
other_short_term_finance |
misc_current_liabilities |
other_long_term_finance |
long_term_liabilities |
overdraft_long_term_liabilities |
liabilities |
net_assets |
working_capital |
Company Capital Reserve
These are the elements within the capital_reserve
section.
Element |
---|
paid_up_equity |
profit_loss_reserve |
sundry_reserve |
revaluation_reserve |
net_worth |
reserves |
shareholder_funds |
Company Ratio
These are the elements within the ratio
section.
Element |
---|
pre_tax_margin |
net_working_capital |
gearing_ratio |
equity |
creditor_days |
debtor_days |
liquidity |
return_on_capital_employed |
current_ratio |
total_debt_ratio |
stock_turnover_ratio |
return_on_assets_employed |
return_on_net_assets_employed |
current_debt_ratio |
Appendices
ISO 3166-1 Country Codes
Code | Country Name | Flag |
---|---|---|
GB | United Kingdom | |
AD | Andorra | |
AE | United Arab Emirates | |
AF | Afghanistan | |
AG | Antigua and Barbuda | |
AI | Anguilla | |
AL | Albania | |
AM | Armenia | |
AO | Angola | |
AQ | Antarctica | |
AR | Argentina | |
AS | American Samoa | |
AT | Austria | |
AU | Australia | |
AW | Aruba | |
AX | Åland Islands | |
AZ | Azerbaijan | |
BA | Bosnia and Herzegovina | |
BB | Barbados | |
BD | Bangladesh | |
BE | Belgium | |
BF | Burkina Faso | |
BG | Bulgaria | |
BH | Bahrain | |
BI | Burundi | |
BJ | Benin | |
BL | Saint Barthélemy | |
BM | Bermuda | |
BN | Brunei | |
BO | Bolivia | |
BQ | Caribbean Netherlands | |
BR | Brazil | |
BS | Bahamas | |
BT | Bhutan | |
BV | Bouvet Island | |
BW | Botswana | |
BY | Belarus | |
BZ | Belize | |
CA | Canada | |
CC | Cocos (Keeling) Islands | |
CD | Democratic Republic of the Congo | |
CF | Central African Republic | |
CG | Congo (Republic of) | |
CH | Switzerland | |
CI | Côte d'Ivoire (Ivory Coast) | |
CK | Cook Islands | |
CL | Chile | |
CM | Cameroon | |
CN | China | |
CO | Colombia | |
CR | Costa Rica | |
CU | Cuba | |
CV | Cape Verde | |
CW | Curaçao | |
CX | Christmas Island | |
CY | Cyprus | |
CZ | Czech Republic | |
DE | Germany | |
DJ | Djibouti | |
DK | Denmark | |
DM | Dominica | |
DO | Dominican Republic | |
DZ | Algeria | |
EC | Ecuador | |
EE | Estonia | |
EG | Egypt | |
EH | Western Saharan | |
ER | Eritrea | |
ES | Spain | |
ET | Ethiopia | |
FI | Finland | |
FJ | Fiji | |
FK | Falkland Islands | |
FM | Micronesia | |
FO | Faroe Islands | |
FR | France | |
GA | Gabon | |
GD | Grenada | |
GE | Georgia | |
GF | French Guiana | |
GG | Guernsey | |
GH | Ghana | |
GI | Gibralter | |
GL | Greenland | |
GM | Gambia | |
GN | Guinea | |
GP | Guadeloupe | |
GQ | Equatorial Guinea | |
GR | Greece | |
GS | South Georgia and the South Sandwich Islands | |
GT | Guatemala | |
GU | Guam | |
GW | Guinea-Bissau | |
GY | Guyana | |
HK | Hong Kong | |
HM | Heard and McDonald Islands | |
HN | Honduras | |
HR | Croatia | |
HT | Haiti | |
HU | Hungary | |
ID | Indonesia | |
IE | Ireland | |
IL | Israel | |
IM | Isle of Man | |
IN | India | |
IO | British Indian Ocean Territory | |
IQ | Iraq | |
IR | Iran | |
IS | Iceland | |
IT | Italy | |
JE | Jersey | |
JM | Jamaica | |
JO | Jordan | |
JP | Japan | |
KE | Kenya | |
KG | Kyrgyzstan | |
KH | Cambodia | |
KI | Kiribati | |
KM | Comoros | |
KN | Saint Kitts and Nevis | |
KP | North Korea | |
KR | South Korea | |
KW | Kuwait | |
KY | Cayman Islands | |
KZ | Kazakhstan | |
LA | Laos | |
LB | Lebanon | |
LC | Saint Lucia | |
LI | Liechtenstein | |
LK | Sri Lanka | |
LR | Liberia | |
LS | Lesotho | |
LT | Lithuania | |
LU | Luxembourg | |
LV | Latvia | |
LY | Libya | |
MA | Morocco | |
MC | Monaco | |
MD | Moldova | |
ME | Montenegro | |
MF | Saint Martin (France) | |
MG | Madagascar | |
MH | Marshall Islands | |
MK | Macedonia | |
ML | Mali | |
MM | Burma (Republic of the Union of Myanmar) | |
MN | Mongolia | |
MO | Macau | |
MP | Northern Mariana Islands | |
MQ | Martinique | |
MR | Mauritania | |
MS | Montserrat | |
MT | Malta | |
MU | Mauritius | |
MV | Maldives | |
MW | Malawi | |
MX | Mexico | |
MY | Malaysia | |
MZ | Mozambique | |
NA | Namibia | |
NC | New Caledonia | |
NE | Niger | |
NF | Norfolk Island | |
NG | Nigeria | |
NI | Nicaragua | |
NL | Netherlands | |
NO | Norway | |
NP | Nepal | |
NR | Nauru | |
NU | Niue | |
NZ | New Zealand | |
OM | Oman | |
PA | Panama | |
PE | Peru | |
PF | French Polynesia | |
PG | Papua New Guinea | |
PH | Philippines | |
PK | Pakistan | |
PL | Poland | |
PM | St. Pierre and Miquelon | |
PN | Pitcairn | |
PR | Puerto Rico | |
PS | Palestine | |
PT | Portugal | |
PW | Palau | |
PY | Paraguay | |
QA | Qatar | |
RE | Réunion | |
RO | Romania | |
RS | Serbia | |
RU | Russian Federation | |
RW | Rwanda | |
SA | Saudi Arabia | |
SB | Solomon Islands | |
SC | Seychelles | |
SD | Sudan | |
SE | Sweden | |
SG | Singapore | |
SH | Saint Helena | |
SI | Slovenia | |
SJ | Svalbard and Jan Mayen Islands | |
SK | Slovakia | |
SL | Sierra Leone | |
SM | San Marino | |
SN | Senegal | |
SO | Somalia | |
SR | Suriname | |
SS | South Sudan | |
ST | São Tome and Príncipe | |
SV | El Salvador | |
SX | Saint Martin (Netherlands) | |
SY | Syria | |
SZ | Swaziland | |
TC | Turks and Caicos Islands | |
TD | Chad | |
TF | French Southern Territories | |
TG | Togo | |
TH | Thailand | |
TJ | Tajikistan | |
TK | Tokelau | |
TL | Timor-Leste | |
TM | Turkmenistan | |
TN | Tunisia | |
TO | Tonga | |
TR | Turkey | |
TT | Trinidad and Tobago | |
TV | Tuvalu | |
TW | Taiwan | |
TZ | Tanzania | |
UA | Ukraine | |
UG | Uganda | |
UM | United States Minor Outlying Islands | |
US | United States of America | |
UY | Uruguay | |
UZ | Uzbekistan | |
VA | Vatican | |
VC | Saint Vincent and Grenadines | |
VE | Venezuela | |
VG | British Virgin Islands | |
VI | United States Virgin Islands | |
VN | Vietnam | |
VU | Vanuatu | |
WF | Wallis and Futuna Islands | |
WS | Samoa | |
YE | Yemen | |
YT | Mayotte | |
ZA | South Africa | |
ZM | Zambia | |
ZW | Zimbabwe |
Co-ordinate Systems
GS 84 (GPS Co-ordinates)
We use the World Geodetic System standard co-ordinate system. Co-ordinates are expressed as signed decimal latitude and longitude values. This reference system is also use by the Global Positioning System (GPS).
OSGB36
The Ordnance Survey grid system projects Great Britain onto a 2D system comprising X and Y co-ordinates, in metres. The origin is at a point to the south west of Land's End. The X and Y co-ordinates are referred to as eastings (or east) and northings (or north) respectively.
Note that the OSGB36 grid system applies only to Great Britain and offshore islands - Northern Ireland and the Channel Islands are not included.
Irish Grid Reference System
The island of Ireland uses a similar system to OSGB36; co-ordinates are projected onto a 2D system which covers the island. This is independent from the GB system.
Examples
Great Britain
Here are the approximate positions of some GB places, in WGS 84 and OSGB36.
Name | Latitude | Longitude | X (Eastings) | Y (Northings) |
---|---|---|---|---|
London | 51.5 | -0.126236 | 530157 | 179576 |
Penzance | 50.118558 | -5.540874 | 30281 | 146977 |
Edinburgh | 55.944555 | -3.206062 | 324771 | 673047 |
Cardiff | 51.491848 | -3.194584 | 317161 | 177666 |
Leeds | 53.809035 | -1.546004 | 429993 | 424844 |
Aberdeen | 57.148134 | -2.121849 | 392726 | 806367 |
Norwich | 52.636641 | 1.288493 | 622611 | 309398 |
Northern Ireland
Here are the approximate positions of some places in Northern Ireland, in WGS 84 and the Irish Grid Reference System.
Name | Latitude | Longitude | X (Eastings) | Y (Northings) |
---|---|---|---|---|
Belfast | 54.5757 | -5.98257 | 142717 | 530157 |
Coleraine | 55.131994 | -6.668451 | 102550 | 591914 |
Ballymena | 54.863117 | -6.278343 | 125565 | 560426 |
Data Sources
BT OSIS
BT OSIS data is a daily updated directory of business and residential telephone numbers. BT OSIS data could be used for building a directory enquiries facility, telephone number appending large customer files, or screening existing customer data for updates or changes.
UK Edited Electoral Roll
The UK Edited Electoral Roll is a database of people who have registered to vote in the UK and not opted out of having their data included. You can search for people on the electoral roll by forename, surname and address. Electoral Roll data is useful for a variety of purposes such as building marketing lists or identity checking. It is a useful first step in confirming that an applicant for goods or services is providing accurate information.
Companies House
Companies House data is a collection of information on UK companies including: Company Names, Company Directors, Company Documents, Company Appointments and Company numbers. Companies House data is useful for verifying company details and for marketing purposes e.g. identifying potential decision makers within an organisation.
The Bereavement Register
The Bereavement Register is a database of people registered as deceased. It is used as a deceased suppression tool to avoid the distress caused to relatives when marketing material is sent to a deceased person.
Telephone Preference Service (TPS and CTPS)
The Telephone Preference Service (TPS) is a monthly updated central opt-out register of telephone numbers belonging to people who do not wish to receive unsolicited sales and marketing phone calls. It is a legal requirement that organisations screen any telemarketing data they hold against the TPS register.
Corporate TPS (or CTPS) is a similar service for business instead of residential telephone numbers - for organisations that telemarket B2B. It is a legal requirement that B2B sales data is also screened against this register.
Company Categories
Private Unlimited Company |
Private Limited Company |
Public Limited Company |
Old Public Company |
PRI/LBG/NSC/S.30 (Private, limited by guarantee, no share capital, section 30 of the Companies Act) |
Limited Partnership |
PRI/LTD BY GUAR/NSC (Private, limited by guarantee, no share capital) |
Converted/Closed |
Private Unlimited |
Other company type |
PRIV LTD SECT.30 (Private limited company, section 30 of the Companies Act |
ICVC (Securities) |
ICVC (Warrant) |
ICVC (Umbrella) |
European Public Limited-Liability Company (SE) |
Community Interest Company |
Community Interest Public Limited Company |
Limited Liability Partnerships (OC & SO companies) |
Company Form Types
1 Post October 2009 Form Types and Descriptions
1.1 CATEGORY ACC: ANNUAL ACCOUNTS
AA | Annual Accounts |
AAMD | Amended Accounts |
1.2 CATEGORY ANRT: ANNUAL RETURNS
AR01 | Annual Return |
LLAR01 | Annual Return of a Limited Liability Partnership |
AR01c | Annual Return (Welsh language form) |
LLAR01c | Annual Return of a Limited Liability Partnership (Welsh language form) |
1.3 CATEGORY APPT: APPOINTMENTS
AP01 | Appointment of director |
AP02 | Appointment of corporate director |
AP03 | Appointment of secretary |
AP04 | Appointment of corporate secretary |
CH01 | Change of particulars for director |
CH02 | Change of particulars for corporate director |
CH03 | Change of particulars for secretary |
CH04 | Change of particulars for corporate secretary |
TM01 | Termination of appointment of director |
TM02 | Termination of appointment of secretary |
AP01c | Appointment of director (Welsh language form) |
AP02c | Appointment of corporate director (Welsh language form) |
AP03c | Appointment of secretary (Welsh language form) |
AP04c | Appointment of corporate secretary (Welsh language form) |
CH01c | Change of particulars for director (Welsh language form) |
CH02c | Change of particulars for corporate director (Welsh language form) |
CH03c | Change of particulars for secretary (Welsh language form) |
CH04c | Change of particulars for corporate secretary (Welsh language form) |
TM01c | Termination of appointment of director (Welsh language form) |
TM02c | Termination of appointment of secretary (Welsh language form) |
LLAP01 | Appointment of member to a Limited Liability Partnership |
LLAP02 | Appointment of member to a Limited Liability Partnership |
LLCH01 | Change of particulars for member of a Limited Liability Partnership |
LLCH02 | Change of particulars of a corporate member of a Limited Liability Partnership |
LLTM01 | Termination of the member of a Limited Liability Partnership |
LLAP01c | Appointment of member to a Limited Liability Partnership (Welsh language form) |
LLAP02c | Appointment of member to a Limited Liability Partnership (Welsh language form) |
LLCH01c | Change of particulars for member of a Limited Liability Partnership (Welsh language form) |
LLCH02c | Change of particulars of a corporate member of a Limited Liability Partnership (Welsh language form) |
LLTM01c | Termination of the member of a Limited Liability Partnership (Welsh language form) |
SEAP01 | Appointment of a member of a supervisory organ of Societas Europaea (SE) |
SEAP02 | Appointment of a corporate body or firm as a member of a supervisory organ of Societas Europaea (SE) |
SECH01 | Change of particulars for a member of a supervisory organ of Societas Europaea (SE) |
SECH02 | Change of particulars for corporate member of a supervisory organ of Societas Europaea (SE) |
SETM01 | Termination of appointment of member of a supervisory organ of Societas Europaea (SE) |
CIAP01 | Notice to the Registrar of Companies by the Regulator of Community interest Companies of an Order to appoint a director |
CIAP02 | Notice to the Registrar of Companies by the Regulator of Community interest Companies of an Order to appoint a corporate director |
CICH01 | A change of particulars for director appointed by the Regulator of Community interest Companies |
CICH02 | A change of particulars for corporate director appointed by the Regulator of Community interest Companies |
CITM01 | Notice to the Registrar of Companies by the Regulator of Community interest Companies about an Order removing a director |
CITM02 | Notice to the Registrar of Companies by the Registrar of Community interest Companies of the termination of appointment of director |
1.4 CATEGORY CROA: CHANGE IN REGISTERED OFFICE
AD01 | Change of registered office address |
AD01c | Change of registered office address (Welsh language form) |
LLAD01 | Change of registered office address of a Limited Liability Partnership |
LLAD01c | Change of registered office address of a Limited Liability Partnership (Welsh language form) |
1.5 CATEGORY MORT: MORTGAGE DOCUMENTS
1.5.1 England/Wales
MG01 | Particulars of a mortgage or charge |
MG02 | Statement of satisfaction in full or in part of mortgage or charge |
MG04 | Application for registration of a memorandum of satisfaction that part [or the whole] of the property charged (a) has been released from the charge; (b) no longer forms part of the company's property |
MG06 | Particulars of a mortgage or charge subject to which property has been acquired |
MG07 | Particulars for the registration of a charge to secure a series of debentures |
MG08 | Particulars of an issue of secured debentures in a series |
MG09 | Certificate of registration of a charge comprising property situated in another UK jurisdiction |
LLMG01 | Particulars of a mortgage or charge in respect of a Limited Liability Partnership |
LLMG02 | Statement of satisfaction in full or in part of mortgage or charge in respect of a Limited Liability Partnership |
LLMG04 | Application for registration of a memorandum of satisfaction that part [or the whole] of the property charged (a) has been released from the charge; (b) no longer forms part of the company's property |
LLMG06 | Application for registration of a memorandum of satisfaction that part [or the whole] of the property charged (a) has been released from the charge; (b) no longer forms part of the company's property |
LLMG07 | Particulars for the registration of a charge to secure a series of debentures in respect of a Limited Liability Partnership |
LLMG08 | Particulars of an issue of secured debentures in a series in respect of a Limited Liability Partnership |
LLMG09 | Certificate of registration of a charge comprising property situated in another UK jurisdiction in respect of a Limited Liability Partnership |
1.5.2 Scotland
MG01s | Particulars of a charge created by a company registered in Scotland |
MG02s | Statement of satisfaction in full or in part of a charge |
MG03s | Statement of satisfaction in full or in part of mortgage or charge |
MG04s | Application for registration of a memorandum of satisfaction that part [or the whole] of the property charged (a) has been released from the charge; (b) no longer forms part of the company's property |
MG05s | Application for registration of a memorandum of satisfaction that part [or the whole] of the property charged (a) has been released from the charge; (b) no longer forms part of the company's property |
MG06s | Particulars of a charge subject to which property has been acquired by a company registered in Scotland |
MG07s | Particulars for the registration of a charge to secure a series of debentures |
MG08s | Particulars of an issue of secured debentures in a series |
MG10s | Particulars of an instrument of alteration to a floating charge created by a company registered in Scotland |
LLMG01s | Particulars of a charge created by a Limited Liability Partnership (LLP) registered in Scotland |
LLMG02s | Statement of satisfaction in full or part of a fixed charge by a Limited Liability Partnership (LLP) registered in Scotland |
LLMG03s | Statement of satisfaction in full or part of a floating charge by a Limited Liability Partnership (LLP) registered in Scotland |
LLMG04s | Application for registration of a memorandum of satisfaction that part (or the whole) of the property charged (a) has been released from the fixed charge; (b) no longer forms part of the Limited Liability Partnership's (LLP's) property by an LLP registered in Scotland |
LLMG05s | Application for registration of a memorandum of satisfaction that part (or the whole) of the property charged (a) has been released from the floating charge; (b) no longer forms part of the Limited Liability Partnership's (LLP's) property by an LLP registered in Scotland |
LLMG06s | Particulars of a charge subject to which property has been acquired by a Limited Liability Partnership (LLP) registered in Scotland |
LLMG07s | Particulars for the registration of a charge to secure a series of debentures by a Limited Liability Partnership (LLP) registered in Scotland |
LLMG08s | Particulars of an issue of secured debentures in a series by a Limited Liability Partnership (LLP) registered in Scotland |
1.6 CATEGORY NEWC: NEW INCORPORATIONS
NEWINC | New incorporation documents |
IN01 | Application for registration of a company |
IN01c | Application for registration of a company (Welsh language form) |
LLIN01 | Application for Incorporation of a Limited Liability Partnership |
LLIN01c | Application for Incorporation of a Limited Liability Partnership (Welsh language form) |
SEFM01 | Formation by Merger of Societas Europaea (SE) to be registered in GB |
SEFM02 | Formation of Holding Societas Europaea (SE) |
SEFM03 | Formation of Subsidiary Societas Europaea (SE) under Article 2(3) of Council Regulation (EC) No 2157/2001 |
SEFM05 | Formation of Subsidiary Societas Europaea (SE) under Article 2(3) of Council Regulation (EC) No 2157/2001 |
SETR02 | Transfer to GB of Societas Europaea (SE) |
OSIN01 | Registration of an overseas company |
OSNE01 | Registration of a new UK Establishment of an overseas company |
1.7 CATEGORY CAP: CAPITAL
SH01 | Return of Allotment of shares |
SH02 | Notice of consolidation, sub-division, redemption of shares or re-conversion of stock into shares |
SH03 | Return of purchase of own shares |
SH04 | Notice of sale or transfer of treasury shares for a public limited company |
SH05 | Notice of cancellation of treasury shares |
SH06 | Notice of cancellation of shares |
SH07 | Notice of cancellation of shares held by or for a public company |
SH08 | Notice of name or other designation of class of shares |
SH09 | Return of allotment by unlimited company allotting new class of shares |
SH10 | Notice of particulars of variation of rights attached to shares |
SH11 | Notice of new class of members |
SH12 | Notice of particulars of variation of class rights |
SH13 | Notice of name or other designation of class of members |
SH14 | Notice of redenomination |
SH15 | Notice of reduction of capital following redenomination |
SH16 | Notice by the applicants of application to court for cancellation of resolution approving a repurchase or redemption of shares out of capital |
SH17 | Notice by the company of application to court for cancellation of resolution approving a repurchase or redemption of shares out of capital |
SH18 | Statement of directors in accordance with reduction of capital following redenomination |
SH19 | Statement of capital (Section 644/649) |
Sh30 | Statement of directors in respect of the solvency statement made in accordance with section 643 |
Sh31 | Notice of non-assenting shareholders |
Sh32 | Statutory Declaration relating to a Notice to non-assenting shares |
Sh33 | Notice to non-assenting shareholders |
1.8 CATEGORY LIQ: LIQUIDATION DOCUMENTS
LQ01 | Notice of appointment of receiver or manager |
LQ02 | Notice of ceasing to act as receiver or manager |
SEWU01 | Notice of Initiation or Termination of Winding-up, Liquidation, Insolvency or Cessation of Payment Procedures and Decision to Continue Operating of Societas Europaea (SE) |
LLLQ01 | Notice of appointment of receiver or manager in respect of a Limited Liability Partnership |
LLLQ02 | Notice of ceasing to act as receiver or manager in respect of a Limited Liability Partnership See 'Codes and Description Pre 2009' help page for all other Liquidation Documents included in this category |
1.9 CATEGORY CON: CHANGE OF NAME
NM01 | Notice of change of name by resolution |
NM02 | Notice of change of name by conditional resolution |
NM03 | Notice confirming satisfaction of the resolution for the change of name |
NM04 | Notice of change of name by means provided for by the articles |
NM05 | Notice of change of name by resolution of directors |
NM06 | Request to seek comments of government department or other specified body on change of name |
NM01c | Notice of change of name by resolution (Welsh language form) |
NM02c | Notice of change of name by conditional resolution (Welsh language form) |
NM03c | Notice confirming satisfaction of the resolution for the change of name (Welsh language form) |
NM04c | Notice of change of name by resolution of directors (Welsh language form) |
NM05c | Notice of change of name by resolution of directors (Welsh language form) |
NM06c | Request to seek comments of government department or other specified body on change of name (Welsh language form) |
NE01 | Exemption from requirement as to use of "limited" or "cyfyngedig" on Change of Name |
LLNM01 | Notice of Change of Name of a Limited Liability Partnership |
LLNM01c | Notice of Change of Name of a Limited Liability Partnership (Welsh language form) |
CERTNM | Change of name certificate |
1.10 CATEGORY MISC: MISCELLANEOUS
AA01 | Change of accounting reference date |
AA02 | Dormant company accounts |
AA01c | Change of accounting reference date (Welsh language form) |
AA02c | Dormant company accounts (Welsh language form) |
AA03 | Notice of resolution removing auditors |
AD02 | Notification of Single Alternative Inspection Location (SAIL) |
AD03 | Change of location of company records to the Single Alternative Inspection Location |
AD04 | Change of location of company records to the registered office |
AD05 | Notification to change the sitiuation of an England and Wales company or a Welsh company |
AD02c | Notification of Single Alternative Inspection Location (SAIL) (Welsh language form) |
AD03c | Change of location of company records to the Single Alternative Inspection Location (SAIL) (Welsh language form) |
AD04c | Change of location of company records to the registered office (Welsh language form) |
AD05c | Notification to change the sitiuation of an England and Wales company or a Welsh company (Welsh language form) |
CC01 | Notice of restriction on the company's articles |
CC02 | Notice of removal of restriction on the company's articles |
CC03 | Statement of compliance where removal of articles restricted |
CC04 | Statement of companies objects |
CC05 | Change of constitution by enactment |
CC06 | Change of constitution by order of court or other authority |
CERT1 | Re-registration of a company from unlimited to limited |
CERT2 | Re-registration of a company from unlimited to limited with a change of name |
CERT3 | Re-registration of a company from limited to unlimited |
CERT4 | Re-registration of a company from limited to unlimited with a change of name |
CERT5 | Re-registration of a company from private to public |
CERT6 | Re-registration of a company from unlimited to PLC |
CERT7 | Re-registration of a company from private to public with a change of name |
CERT8 | Certificate to entitle a public company to commence business and borrow |
CERT10 | Re-registration of a company from public to private |
CERT11 | Re-registration of a company from public to private with a change of name |
CERT14 | Certificate of registration of a resolution on reduction of share capital |
CERT15 | Certificate of registration of order of court and minute on reduction of share capital |
CERT16 | Certificate of registration of order of court and minute on reduction of share capital and share premium account |
CERT17 | Certificate of registration of order of court and minute on reduction of share capital and cancellation of share premium account |
CERT18 | Certificate of registration of order of court and minute on reduction of share capital, cancellation of share premium account and cancellation of capital redemption reserve |
CERT19 | Certificate of registration of order of court on reduction of share premium account |
CERT20 | Certificate of registration of order of court on reduction of share capital and cancellation of capital redemption reserve |
CERT21 | Certificate of registration of order of court and minute on cancellation of share premium account |
CERTIPS | Registration as Friendly Society |
DS01 | Striking off application by a company |
DS02 | Withdrawal of striking off application by a company |
DS01c | Striking off application by a company (Welsh language form) |
DS02c | Withdrawal of striking off application by a company (Welsh language form) |
EEMP01 | Notice of documents and particulars required to be filed |
EEMP02 | Notice of setting up or closure of an establishment of an EEIG |
EEAP01 | Appointment of manager of an EEIG where the official address of the EEIG is in the UK |
EEAP02 | Appointment of corporate manager of an EEIG where the official address is in the UK |
EEFM01 | Statement of name, official address, members, objects and duration for EEIG whose official address is in the UK |
EEFM02 | Statement of name, establishment address in the UK and members of an EEIG whose official address is outside the UK |
EENM01 | Statement of name, other than registered name, under which an EEIG whose official address is outside the UK proposes to carry on business in the UK |
EENM02 | Statement of name, other than registered name, under which an EEIG whose official address is outside the UK proposes to carry on business in substitution for name previously approved |
EETM01 | Termination of appointment of manager of an EEIG where the official address is in the UK |
EECH01 | Change of particulars for a manager of an EEIG where the official address of the EEIG is in the UK |
EECH02 | Change of particulars for corporate manager of an EEIG where the official address of the EEIG is in the UK |
GAZ1 | First notification of strike-off action in London Gazette (Section 1000) |
GAZ2 | Second notification of strike-off action in London Gazette (Section 1000) |
GAZ1(A) | First notification of strike-off in London Gazette (Section 1003) |
GAZ2(A) | Second notification of strike-off action in London Gazette (Section 1003) |
ART | Articles of Association |
MISC | Miscellaneous document |
OC | Order of Court |
OC-DV | Order of Court - dissolution void |
OC-PRI | Order of Court for re-registration to private company |
OCREREG | Order of Court for re-registration |
OC138 | Order of Court |
OC425 | Order of Court |
OC427 | Order of Court (Section 427) |
*RES02 | Resolution to re-register |
*RES06 | Reduction of issued capital |
*RES08 | Purchase own shares |
*RES09 | Repurchase of shares |
*RES10 | Allotment of securities |
*RES11 | Disapplication of pre-emption rights |
*RES12 | Vary share rights/names |
*RES13 | Other resolution |
*RES16 | Redemption of shares |
SOAD(A) | Striking-off action discontinued (s1003) |
SOAS(A) | Striking-off action suspended (s1003) |
VAL | Valuation Report |
SH50 | Application for trading certificate for a public company |
LLAA01 | Change of accounting reference date of a Limited Liability Partnership |
LLAA01c | Change of accounting reference date of a Limited Liability Partnership (Welsh language form) |
LLAA02 | Notice of removal of auditor from a Limited Liability Partnership |
LLAD02 | Notification of a single alternative inspection location (SAIL) of a Limited Liability Partnership |
LLAD03 | Change of location of the records to the single alternative inspection location (SAIL) of a Limited Liability Partnership |
LLAD04 | Change of location of the records to the registered office of a Limited Liability Partnership |
LLAD05 | Notice to change the situation of a Welsh / England and Wales Limited Liability Partnership |
LLAD02c | Notification of a single alternative inspection location (SAIL) of a Limited Liability Partnership (Welsh language form) |
LLAD03c | Change of location of the records to the single alternative inspection location (SAIL) of a Limited Liability Partnership (Welsh language form) |
LLAD04c | Change of location of the records to the registered office of a Limited Liability Partnership (Welsh language form) |
LLAD05c | Notice to change the situation of a Welsh / England and Wales Limited Liability Partnership (Welsh language form) |
LLCC01 | Notice of Change of Status of a Limited Liability Partnership |
LLDS01 | Striking off application by a Limited Liability Partnership |
LLDS02 | Withdrawal of striking off application by a Limited Liability Partnership |
LLCC01c | Notice of Change of Status of a Limited Liability Partnership (Welsh language form) |
LLDS01c | Striking off application by a Limited Liability Partnership (Welsh language form) |
LLDS02c | Withdrawal of striking off application by a Limited Liability Partnership (Welsh language form) |
LLNM01c | Notice of Change of Name of a Limited Liability Partnership (Welsh language form) |
NCIN01 | Application by a joint stock company for registration as a public company under the Companies Act 2006 |
NCIN03 | Application by a company (not being a joint stock company) for registration under the Companies Act 2006 |
NCIN04 | Statement by Director or Secretary on application by a joint stock company for registration as a public company under the Companies Act 2006 |
OSNM01 | Registration of change of name of overseas company as registered in the UK |
OSLQ01 | Notice of appointment of a liquidator of an overseas company |
OSLQ02 | Notice by an Overseas Companies which becomes subject to proceedings relating to insolvency |
OSLQ03 | Notice of winding up of an overseas company |
OSLQ04 | Notice by an overseas companies on cessation of proceedings relating to insolvency |
OSDS01 | Notice of closure of a UK business of an overseas company |
OSDS02 | Notice of termination of winding up of an overseas companies |
OSCH01 | Return by a UK business of an Overseas Company for change of particulars |
OSCH02 | Return by an overseas company for change of company particulars |
OSCH03 | Change of details of a director of an overseas company |
OSCH04 | Change of details of a corporate director of an overseas company |
OSCH05 | Change of details of a secretary of an overseas company |
OSCH06 | Change of details of a corporate secretary of an overseas company |
OSCH07 | Change of details by an overseas company for a person authorised to represent the company in respect of a UK establishment |
OSCH08 | Change of service address for a judicial factor (Scotland) of an overseas company |
OSCH09 | Change of details by an overseas company for a person authorised to accept service of documents on behalf of the company in respect of a UK establishment |
OSCC01 | Return by an overseas company of an alteration to constitutional documents |
OSCC02 | Return by an overseas company of change of UK business at which the constitutional documents are kept |
OSMG01 | Particulars of a mortgage or charge by an overseas company |
RP01 | Replacement of document not meeting requirements for proper delivery |
RP02 | Application for rectification |
RP03 | Notice of objection to a rectification request |
RR01 | Application by a private company for re-registration as a public company |
RR02 | Application by a public company for re-registration as a private limited company |
RR03 | Notice by the company of application to the court for cancellation of resolution for re--registration |
RR04 | Notice by the applicants of application to the court for cancellation of resolution for re--registration |
RR05 | Application by a private limited company for re-registration as a private unlimited company |
RR06 | Application by an unlimited company for re-registration as a private limited company |
RR07 | Application by a public company for re-registration as a private unlimited company |
RR08 | Application by a public company for re-registration as a private limited company following a Court Order reducing capital |
RR09 | Application by a public company for re-registration as a private limited company following cancellation of shares |
RT01 | Application for administrative restoration to the register |
SEAS01 | Amendment of Statutes of Societas Europaea (SE) |
SECV01 | Conversion of Societas Europaea (SE) to PLC |
SEDT01 | Draft Terms of Formation of Holding Societas Europaea (SE) involving a GB Registered Company or SE |
SEDT02 | Draft Terms of Conversion of PLC to Societas Europaea (SE) |
SEDT03 | Notification of Draft Terms of Conversion of Societas Europaea (SE) to PLC |
SESC01 | Notice of Satisfaction of Conditions for the Formation of Holding Societas Europaea (SE) by a GB Registered Company or SE |
SESS01 | Statement of solvency by Members of Societas Europaea (SE) which is proposing to transfer from GB |
SETR01 | Proposed Transfer from GB of Societas Europaea (SE) |
SETR03 | Transfer from GB of Societas Europaea (SE) |
SEFM04 | Transformation of PLC to Societas Europaea (SE) |
VT01 | Voluntary translation of an original filing received by the Registrar |
2 Pre October 2009 Form Types and Descriptions
2.1 CATEGORY ACC: ANNUAL ACCOUNTS
AA | Annual Accounts |
AAMD | Amended Accounts |
2.2 CATEGORY RET: ANNUAL RETURNS
363 | Annual Return |
363a | Annual Return |
363b | Annual Return |
363s | Annual Return |
363x | Annual Return |
363CYM | Annual Return (Welsh language form) |
2.3 CATEGORY DIR: 288 DOCUMENTS
288a | Notice of appointment of directors or secretaries |
288b | Notice of resignation of directors or secretaries |
288c | Notice of change of directors or secretaries or in their particulars |
288aCYM | Notice of appointment of directors or secretaries (Welsh language form) |
288bCYM | Notice of resignation of directors or secretaries (Welsh language form) |
288cCYM | Notice of change of directors or secretaries or in their particulars (Welsh language form) |
2.4 CATEGORY ROC: 287 DOCUMENTS
287 | Change in situation or address of Registered Office |
287CYM | Change in situation or address of Registered Office (Welsh language form) |
2.5 CATEGORY NEWC: NEW COMPANIES
NEWINC | New Incorporation documents |
10 | First Directors and secretary and intended situation of Registered Office |
10CYM | Directors and secretary and intended situation of Registered Office (Welsh language form) |
12 | Declaration on application for registration |
12CYM | Declaration on application for registration (Welsh language form) |
BR1 | Return delivered for registration of a branch of an overseas company |
691 | Return and declaration delivered for registration of a place of business of an overseas company |
2.6 CATEGORY MORT: MORTGAGE DOCUMENTS
2.6.1 England and Wales
ZMORT | Mortgage Register |
REG 395 | Particulars of a mortgage or charge |
397 | Particulars for the registration of a charge to secure a series of debentures |
397a | Particulars of an issue of secured debentures in a series |
398 | Certification of registration in Scotland or Northern Ireland of a charge comprising property situated there |
400 | Particulars of a mortgage or charge subject to which property has been acquired |
401 | Register of Charges, Memoranda of Satisfaction and Appointment etc of Receivers. |
403a | Declaration of satisfaction in full or in part of a mortgage or charge |
403b | Declaration that part of the property or undertaking charges (a) has been released from the charge; (b) no longer forms part of the company’s property or undertaking |
2.6.2 Scotland
410 | Particulars of a charge created by a company registered in Scotland |
413 | Particulars for the registration of a charge to secure a series of debentures |
413a | Particulars for the registration of a charge to secure a series of debentures |
416 | Particulars of a charge subject to which property has been acquired by a company registered in Scotland |
419a | Application for registration of a memorandum of satisfaction in full or in part of a registered charge |
419b | Application for registration of a memorandum of fact that part of the property charged (a) has been released from the charge; (b) no longer forms part of the company's property |
466 | Particulars of an instrument of alteration to a floating charge created by a company registered in Scotland |
2.7 CATEGORY CAP: CAPITAL
52 | Particulars of contract relating to shares allotted as fully or partly paid up otherwise than in cash on or before 15/3/88 |
88(2) | Return of allotments of shares issued for cash or by way of capitalisation of reserves (bonus issues) |
397 | Particulars for the registration of a charge to secure a series of debentures |
88(2)R | Return of allotments of shares issued for cash or by way of capitalisation of reserves (bonus issues) - revised form |
88(2)O | Return of allotments of shares issued for other than cash - original document |
88(3) | Particulars of a contract relating to shares allotted as fully or partly paid up otherwise than in cash |
SA | Shares agreement |
122 | Notice of consolidation, division, sub-division, redemption or cancellation of shares, or conversion, re-conversion of stock into shares |
123 | Notice of increase in nominal capital |
128(1) | Statement of rights attached to allotted shares |
128(3) | Statement of particulars of variation of rights attached to shares |
128(4) | Notice of assignment of name or new name to any class of shares |
129(1) | Statement by a company without share capital of rights attached to newly created class of members |
129(2) | Statement by a company without share capital of particulars of a variation of members' class rights |
129(3) | Notice by a company without share capital of assignment of a name or other designation to a class of members |
155(6)a | Declaration in relation to assistance for the acquisition of shares |
155(6)b | Declaration by the directors of a holding company in relation to assistance for the acquisition of shares |
157 | Notice of application made to the Court for the cancellation of a special resolution regarding financial assistance for the acquisition of shares |
169 | Return by a company purchasing its own shares |
169(1B) | Return by a public company purchasing its own shares for holding in treasury |
169A(2) | Return by a public company cancelling or selling shares from treasury |
173 | Declaration in relation to the redemption or purchase of shares out of capital |
176 | Notice of application to the Court for the cancellation of a resolution for the redemption or purchase of shares out of capital |
PROSP | Prospectus |
*RESO4 | Increase in nominal capital |
*RESO5 | Decrease in nominal capital |
PUC2 | Return of allotments of shares issued for cash on or before 15/3/1988 |
PUC5 | Statement of amounts or further amounts paid on nil paid or partly paid on or before 15/3/1988 |
PUC30 | Return of allotments of shares issued wholly or partly paid up otherwise than in cash on or before 15/3/1988 |
*RES (resolution) | forms can be in the form, SRES, ORES, ERES or WRES relating to: special resolution, ordinary resolution, extraordinary resolution or written resolution |
2.8 CATEGORY LIQ: LIQUIDATION DOCUMENTS
2.8.1 England and Wales
1.1 | Report of meeting approving voluntary arrangement |
1.2 | Order or revocation or suspension of voluntary arrangement |
1.3 | Voluntary arrangement's supervisor's abstracts of receipts and payments |
1.4 | Notice of completion of voluntary arrangement |
2.6 | Notice of Administration Order |
2.7 | Administration Order |
2.15 | Administrator's Abstract of receipts and payments |
2.18 | Notice of Order to deal with charged property |
2.19 | Notice of discharge of Administration Order |
2.2 | Notice of variation of Administration Order |
2.21 | Statement of Administrator's proposals |
2.23 | Notice of result of meeting of creditors |
3.3 | Statement of Affairs in Administrative receivership following report to creditors |
3.4 | Certificate of constitution of creditors |
3.5 | Administrative Receiver's report to change in membership of creditors' committee |
3.6 | Abstract of receipt and payments in receivership |
3.7 | Notice of Administrative Receiver's death |
3.8 | Notice of Order to dispose of charged property |
3.1 | Administrative Receiver's report |
4.13 | Notice to Official Receiver of winding-up order |
4.2 | Statement of company's affairs |
4.31 | Notice of Appointment of Liquidator in winding up by the Court |
4.33 | Notice of resignation of Voluntary Liquidator under section 171(5) of Insolvency Act 1986 |
4.35 | Order of Court granting Voluntary Liquidator leave to resign |
4.38 | Certificate of removal of Voluntary Liquidator |
4.4 | Notice of ceasing to act as Voluntary Liquidator |
4.43 | Notice of final meeting of creditors |
4.44 | Notice of death of Voluntary Liquidator |
4.46 | Notice of vacation of office by Voluntary Liquidator |
4.48 | Notice of constitution of liquidation committee |
4.51 | Certificate that creditors have been paid in full |
4.68 | Liquidator's statement of receipts and payments |
4.69 | Order of court appealing against Secretary of State's decision under section 203(4) or section 205(4) of Insolvency Act 1986 |
4.7 | Declaration of Solvency |
4.71 | Return of final meeting in members' voluntary winding-up |
4.72 | Return of final meeting in creditors' voluntary winding-up |
405(1) | Notice of appointment of Receiver |
405(2) | Notice of ceasing to act of Receiver |
600 | Notice of appointment of Liquidator in a voluntary winding up (Members or Creditors) |
COCOMP | Order to wind up |
COLIQ | Orders to rescind, defer or stay |
F14 | Notice of wind up |
L64.01 | Early dissolution request |
L64.01HC | Early dissolution request |
L64.04 | Directions to defer dissolution |
L64.06 | Directions to defer dissolution |
L64.06HC | Directions to defer dissolution |
L64.07 | Release of Official Receiver |
L64.07HC | Release of Official Receiver |
LRESEX | Extraordinary resolution in creditors; voluntary liquidation |
LRESSP | Ordinary resolution in members' voluntary liquidation |
RELREC | Official Receiver's release |
SPECPEN | Certificate of specific penalty |
2.8.2 Scotland
1.1(scot) | Report of a meeting approving voluntary arangement |
2.2(scot) | Notice of administration order |
2.3(scot) | Notice of dismissal of petition for administration order |
2.4(scot) | Notice of discharge of administration order |
2.7(scot) | Notice of statement of administrator's proposals |
2.8(scot) | Notice of result of meeting of creditors |
2.9(SC) | Administrator's abstract of receipts and payments |
2.11(scot) | Notice of order to deal with secured property |
2.12(scot) | Notice of variation of administration order |
4.2(SC) | Notice of winding up order |
4.6(SC) | Liquidator's statement of receipts and payment |
4.9(SC) | Notice of appointment of Liquidator |
4.11(SC) | Notice of removal of Liquidator |
4.14(SC) | Certificate of release of Liquidator |
4.16(SC) | Notice of resignation of Liquidator |
4.17(SC) | Notice of final meeting of creditors |
4.18(SC) | Notice of death of Liquidator |
4.19(SC) | Notice of vacation of office by Liquidator |
4.20(SC) | Certificate of constitution of creditors/liquidation committee |
4.22(SC) | Notice of constitution/continuance of liquidation/creditors committee |
4.25(SC) | Declaration of solvency |
4.26(SC) | Return of final meeting in a voluntary winding up |
4.27(SC) | Notice of courts order sifting proceedings in winding up by the court |
4.28(SC) | Notice under sections 204(6) or 205(6) |
600 | Notice of appointment of Liquidator in a voluntary winding up |
COLIQ | Court order to dissolve in post 29/12/86 compulsory liquidation |
COLIQ86 | Court order to dissolve in a pre 29/12/86 compulsory liquidation |
CO4.2S | Court Order for notice of wind up |
1(scot) | Notice of appointment of a Receiver by the holder of a floating charge |
2(scot) | Notice of appointment of a Receiver by the Court |
3(scot) | Notice of the Receiver ceasing to act or of his removal |
3.3(scot) | Notice of receiver's death |
3.4(scot) | Notice of authorisation to dispose of secured property |
3.5(scot) | Notice of Receiver's report |
LRESEX | Extraordinary resolution in creditors' voluntary liquidation |
LRESSP | Ordinary resolution in members' voluntary liquidation |
2.9 CATEGORY CON: CHANGE OF NAME
CERTNM | Change of name certificate |
SRES15 | Change of Name Special Resolution |
2.10 CATEGORY MISC: MISCELLANEOUS DOCUMENTS
2.10.1 England, Wales and Scotland
AUD | Auditor's letter of resignation |
AUDR | Auditor’s report |
AUDS | Auditor's statement |
BONA | Bona Vacantia disclaimer |
BS | Balance sheet |
BR1 | Return delivered for registration of a branch of an overseas company |
BR2 | Return by an overseas company subject to branch registration of an alteration to constitutional documents |
BR3 | Return by an overseas company subject to branch registration, for alteration of company particulars |
BR4 | Return by an overseas company subject to branch registration of change of directors or secretary or of their particulars |
BR5 | Return by an overseas company subject to branch registration of change of address or other branch particulars |
BR6 | Return of change of person authorised to accept service or to represent the branch of an overseas company or of any change in their particulars |
BR7 | Return by an overseas company of the branch at which the constitutional documents of the company have been registered in substitution for a previous branch |
BUSADD CH | Business address changed |
CENT8 | Notice of closure of a place of business of an overseas company |
CERT1 | Re-registration of a company from unlimited to limited |
CERT2 | Re-registration of a company from unlimited to limited with a change of name |
CERT3 | Re-registration of a company from limited to unlimited |
CERT4 | Re-registration of a company from limited to unlimited with a change of name |
CERT5 | Re-registration of a company from private to public |
CERT6 | Re-registration of a company from unlimited to PLC |
CERT7 | Re-registration of a company from private to public with a change of name |
CERT8 | Certificate to entitle a public company to commence business and borrow |
CERT10 | Re-registration of a company from public to private |
CERT11 | Re-registration of a company from public to private with a change of name |
CERT14 | Certificate of registration of a resolution on reduction of share capital |
CERT15 | Certificate of registration of order of court and minute on reduction of share capital |
CERT16 | Certificate of registration of order of court and minute on reduction of share capital and share premium account |
CERT17 | Certificate of registration of order of court and minute on reduction of share capital and cancellation of share premium account |
CERT18 | Certificate of registration of order of court and minute on reduction of share capital, cancellation of share premium account and cancellation of capital redemption reserve |
CERT19 | Certificate of registration of order of court on reduction of share premium account |
CERT20 | Certificate of registration of order of court on reduction of share capital and cancellation of capital redemption reserve |
CERT21 | Certificate of registration of order of court and minute on cancellation of share premium account |
CERTIPS | Registration as Friendly Society |
COAD | Instrument issued under Section 244(5) |
COADLE TT | Letter to company regarding its request for an extension of time to deliver their annual accounts |
DISS6 | Notice of striking-off action suspended |
DISS40 | Notice of striking-off action discontinued |
DO1 | Notice of disqualification of an individual |
DO2 | Notice of disqualification order against a body corporate |
DO3 | Notice of leave granted in relation to a disqualification order |
DO4 | Notice of a variation or cessation of a disqualification order |
EEIG1 | Statement of name, official address, members, objects and duration for EEIG whose official address is in Great Britain |
EEIG2 | Statement of name, establishment address in Great Britain and members of an EEIG whose official address is outside the UK |
EEIG3 | Notice of manager's particulars, and of termination of appointment where the official address of the EEIG is in Great Britain |
EEIG4 | Notice of documents and particulars required to be filed |
EEIG5 | Notice of setting up or closure of an establishment of an EEIG |
EEIG6 | Statement of name, other than registered name, under which an EEIG whose official address is outside Great Britain proposes to carry on business in substitution for name previously approved |
ELRES | Elective resolution |
GAZ1 | First notification of strike-off action in London Gazette (Section 652) |
GAZ2 | Second notification of strike-off action in London Gazette (Section 652) 43(3) Application by a private company for re-registration as a public company |
GAZ1(A) | First notification of strike-off in London Gazette (Section 652A) |
GAZ2(A) | Second notification of strike-off action in London Gazette (Section 652A) |
LET-CESS | Notice of closure of a place of business of an overseas company |
LETTCESS | Notice of closure of a branch of an overseas company |
MA | Memorandum and Articles |
MAR | Memorandum and Articles - used in re-registration |
MISC | Miscellaneous document |
OC | Order of Court |
OC-DV | Order of Court - dissolution void |
OC-PRI | Order of Court for re-registration to private company |
OC138 | Order of Court (Section 138) |
OC425 | Order of Court (Section 425) |
OCREREG | Order of Court for re-registration |
*RES02 | Resolution to re-register |
*RES03 | Exempt from appointment of auditor |
*RES06 | Reduction of issued capital |
*RES07 | Financial assistance in shares acquisition |
*RES08 | Purchase own shares |
*RES09 | Confirmation of dissolution |
*RES10 | Allotment of securities |
*RES11 | Disapplication of pre-emption rights |
*RES12 | Vary share rights/names |
*RES13 | Other resolution |
*RES14 | Capital/bonus issue |
*RES16 | Redemption of shares |
SOAD(A) | Striking-off action discontinued (Section 652A) |
SOAS(A) | Striking-off action suspended (Section 652A) |
VAL | Valuation Report |
(W)ELRE S | Written elective resolution |
6 | Cancellation of alteration to the objects of a company |
43(3)e | Declaration on application by a private company for re-registration as a public company |
49(1) | Application by a limited company to be re-registered as unlimited |
49(8)a | Members' assent to company being re-registered as unlimited |
49(8)b | Statutory declaration by directors as to members' assent to re-register a company as unlimited |
51 | Application by an unlimited company to be re-registered as limited |
53 | Application by a public company for re-registration as a private company |
54 | Application to the Court for cancellation of resolution for re-registration |
54 92(SC) | Liquidator's statement of accounts (for Scottish companies only) |
97 | Statement for the amount or rate per cent of any commission payable in connection with the subscription of shares |
117 | Application by a public company for certificate to commence business and statutory declaration in support |
139 | Application by a public company for re-registration as a private company following a Court Order reducing capital |
147 | Application by a public company for re-registration as a private company following cancellation of shares and reduction of nominal value of issued capital |
190 | Notice of place where a register of holders of debentures or a duplicate is kept or of any change in that place |
190a | Notice of a place where a register of holders of debentures of a duplicate is kept or of any change in that place where the register is in non-legible form |
224 | Notice of accounting reference date (to be delivered within 9 months of incorporation) |
225 | Change of Accounting Reference Date |
225(1) | Notice of new accounting reference date given during the course of an accounting reference period |
225(2) | Notice by a holding or subsidiary company of a new accounting reference date given after the end of an accounting reference period |
225CYM | Change of accounting reference date (Welsh form) |
242 | Notice of claim to extension of period allowed for laying and delivering accounts - overseas business or interests |
244 | Notice of claim to extension of period allowed for laying and delivering accounts - overseas business or interests |
266(1) | Notice of intention to carry on business as an investment company |
266(3) | Notice that a company no longer wishes to be an investment company |
318 | Location of directors' service contracts |
325 | Location of register of directors' interests in shares etc |
325a | Location of register of directors' interests in shares etc where the register is in nonlegible form |
353 | Register of members |
353a | Register of members in non-legible form |
362 | Notice of place where an overseas branch register is kept, of any change in that place, or of discontinuance of any such register |
362a | Notice of place where an overseas branch register is kept, of any change in that place, or of discontinuance of any such register where the register is in a non-legible form |
386 | Notice of passing of resolution removing an auditor |
652A | Application for striking off |
652C | Withdrawal of application for striking off |
680a | Application by joint stock company for registration under Part XXII of the Companies Act 1985, and Declaration and related statements |
680b | Application by a company which is not a joint stock company for registration under Part |
XXII | of the Companies Act 1985, and Declaration and related statements |
684 | Registration under Part XXII of the Companies Act 1985. List of members - existing joint stock company |
685 | Declaration on application by a joint stock company for registration as a public company |
686 | Registration under Part XXII of the Companies Act 1985 Statutory Declaration verifying list of members |
691-REREG | Registration of a place of business of an overseas company previously registered as a branch |
692(1)(a) | Return of alteration in the charter, statutes etc of an overseas company subject to place of business registration |
692(1)(b) | Return of alteration in the directors or secretary of an overseas company subject to place of business registration or in their particulars |
692(1)(c) | Return of alteration in the names or addresses of persons resident in Great Britain authorised to accept service on behalf of an overseas company subject to place of business registration |
692(2) | Return of change in the corporate name of an overseas company subject to place of business registration |
694(4)(a) | Statement of name, other than corporate name, under which an overseas company proposes to carry on business in Great Britain |
694(4)(b) | Statement of name, other than corporate name, under which an overseas company proposes to carry on business in Great Britain in substitution for a name previously registered |
695A(3) | Notice of closure of a branch of an overseas company |
701(a) | Notice of accounting reference date (to be delivered within 9 months of incorporation) for an overseas company subject to section 700 |
701(b) | Notice of new accounting reference date given during the course of an accounting reference period for an overseas company subject to section 700 |
701(c) | Notice by an overseas holding or subsidiary company of new accounting reference date given after the end of an accounting reference period subject to section 700 |
703P(1) | Return by an overseas company that the company is being wound up |
703P(3) | Notice of appointment of a Liquidator of an overseas company |
703(P)(5) | Notice by the Liquidator of an overseas company concerning the termination of liquidation of the company |
703Q(1) | Return by an overseas company which becomes subject to insolvency proceedings, etc |
703Q(2) | Return by an overseas company on cessation of insolvency proceedings, etc |
CLOSE | Scheme of Arrangement |
EXLIQ | Request for dissolution of company where liquidator has ceased to act. |
*RES (resolution) | forms can be in the form, SRES, ORES, ERES or WRES relating to: special resolution, ordinary resolution, extraordinary resolution or written resolution. |
2.11 LLP DOCUMENTS
The majority of the above document codes that apply to companies also apply to Limited Liability Partnerships and have the same purpose or significance. Note, however, that LLPs do NOT file Partnership Agreements at Companies House. Nor do they file Share Capital documents, Resolutions, Memorandum of Association or Articles of Association
Northern Ireland codes and descriptions are detailed below but documents that align with GB documents are included in the above categories for 'Monitor' etc.
2.12 Northern Ireland Documents
Credit Union Annual Return
16(W) | Written resolution for change of company name |
CNRES | Special resolution change of company name |
2.12.1 Dormant Balance Sheet
17 | Cancellation of alteration to the objects of a company |
21 | (Incorporation) |
23 | (Statutory declaration) |
40(5)(a) | Declaration on application for the registration of a company exempt from the requirement to use 'limited' |
40(5)(b) | Declaration on application for the registration of a company under Article 629 of the Companies (NI) Order 1986 exempt from the from the requirement to use 'limited' |
40(5)(c) | Declaration of change of name omitting 'limited' |
53(3) | Application by a private company for re-registration as a public company |
53(3)(e) | Declaration on application by a private company for re-registration as a public company |
59 | Application by limited company to be re-registered as unlimited |
59(8)(a) | Members' assent to company being re-registered as unlimited |
61 | Application by an unlimited company to be re-registered as limited |
63 | Application by a public company for re-registration as private company |
64 | Application to the court for cancellation of resolution for re-registration |
98(2) | Return of allotment of shares |
98(3) | Particulars of a contract relating to shares allotted as fully or partly paid up otherwise than in cash. |
107 | Statement of the amount or rate per cent of any commission payable in connection with the subscription of shares |
127 | Application by a public company for certificate to commence business |
132 | Notice of consolidation, division, sub-division, redemption or cancellation of shares, or conversion, re-conversion of stock into shares |
133 | Notice of increase in nominal capital |
138(1) | Statement of rights attached to allotted shares |
138(3) | Statement of particulars of variation of rights attached to shares |
138(4) | Notice of assignment of name or new name to any class of shares |
139(1) | Statement by a company without share capital of rights attached to newly created class of members |
139(2) | Statement by a company without share capital of particulars of a variation of members' class rights |
139(3) | Notice by a company without share capital of assignment of a name or other designation to a class of members |
149 | Application by a public company for re-registration as a private company following a Court Order reducing capital |
157 | Application by a public company for re-registration as a private company following cancellation of shares and reduction of nominal value of issued capital |
165(6)A | Declaration in relation to assistance for the acquisition of shares |
165(6)B | Declaration by the directors of a holding company in relation to assistance for the acquisition of shares |
167 | Notice of application made to the Court for the cancellation of a special resolution regarding financial assistance for the acquisition of shares |
179 | Return by a company purchasing its own shares |
183 | Declaration in relation to the redemption or purchase of shares out of capital |
186 | Notice of application to the Court for the cancellation of a resolution for the redemption or purchase of shares out of capital |
199 | Location of register of debenture holders |
232 | Notice of accounting reference date (ARD) (to be delivered within 6 months of incorporation) |
233 | Change of accounting reference date |
233(1) | Notice of new ARD date given during an accounting reference period |
233(2) | Notice by a holding or subsidiary company of new ARD given after the end of an accounting reference period |
250 | Notice of interests outside of the UK, Channel Islands and Isle of Man |
252 | Notice of claim to extension of period allowed for laying and delivering accounts and reports - business or interests outside the UK, Channel Islands and Isle Man |
274(1) | Notice of intention to carry on business as an investment company |
274(3) | Notice that a company no longer wishes to be an investment company |
295 | Change of situation or address of registered office |
296 | Change of director or secretary or change of particulars |
326 | Location of directors' service contracts |
333 | Notice of place where register of directors' interests in shares etc is kept or of any change in that place |
361 | Location of Register of Members |
370 | Notice of place where an overseas branch register is kept, of any change in that place, or of discontinuance of any register |
371 | Annual Return |
394 | Notice of passing of resolution removing an auditor |
402 | Particulars of a mortgage or charge |
404 | Particulars for the registration of a charge to secure a series of debentures |
404A | Particulars of an issue of secured debentures in a series |
405 | Certificate of registration Great Britain of a charge comprising property situate there |
407 | Particulars of a mortgage or charge subject to which property has been acquired |
411A | Declaration of satisfaction in full or in part of mortgage or charge |
411B | Declaration that part of the property or undertaking charged has been released from the charge or no longer forms part of the company's property or undertaking |
413(1) | Notice of appointment of receiver or manager |
413(2) | Notice of ceasing to act as receiver or manager |
421 | Notice to dissenting shareholders |
422 | Notice to non-assenting shareholders |
422(3) | Notice to transferee company by a non-assenting shareholder |
461(2) | Notice to company of appointment of receiver or manager |
461(2)A | Statement of affairs: in the matter of a debenture |
461(2)B | Statement of affairs: in the high court |
463 | Receiver or manager's abstract of receipts and payments |
558 | Notice of appointment of liquidator voluntary winding up |
558A | Notice of appointment of liquidator voluntary winding up (members) |
558B | Notice of appointment of liquidator voluntary winding up (creditors) |
558C | Notice of appointment of liquidator: voluntary winding up subject to the supervision of the Court |
603a | Application for striking off |
603c | Withdrawal of application for striking off |
629A | Application by joint stock company for registration under Part XXII of the Companies (NI) Order 1986, and Declaration and related statements |
629B | Application by a company which is not a joint stock company for registration Under Part XXll of the Companies (NI) Order 1986, and Declaration and related statements |
633 | Registration under Part XXII of the Companies (NI) Order 1986 List of members - existing joint stock company |
634 | Declaration on application by a joint stock company for registration as a public company |
635 | Registration under Part XXII of the Companies (NI) Order 1986 Statutory Declaration verifying list of member |
R7 | Application by an old public company for re-registration as a public company |
R7a | Notice of application made to the Court for the cancellation of a special resolution by an old public company not to be re-registered as a public company |
R8 | Declaration by Director or Secretary on application by an old public company for reregistration as a public company |
R9 | Declaration by old public company that it does not meet the requirements for a public company |
BR1 | Return delivered for registration of a branch of an overseas company |
BR4 | Return by a part XXIII company subject to branch registration of change of directors or secretary or of their particulars |
641 | Return and declaration delivered for registration by a Part XXIII company |
642(1)(a) | Return of alteration in the charter, statutes etc of an overseas company (Part XXIII company) |
642(1)(b) | Return of alteration in the directors or secretary of an overseas company or in their particulars |
642(1)(c) | Return of alteration in the name or addresses of persons resident in NI authorised to accept service on behalf of an overseas company |
642(2) | Return of change in the corporate name of an overseas company |
644A | Name, other than corporate name, under which an overseas company proposes to carry on business in NI |
644B | Name, other than corporate name, under which an overseas company proposes to carry on business in NI in substitution for a name previously registered |
650(2) | Notice of accounting reference date by a Part XXIII (overseas) company |
650(6)A | Notice by a Part XXIII company of new ARD given during the course of an accounting reference period |
650(6)B | Notice by a part XXIII company of new ARD given after the end of an accounting reference period |
LLP2 | Application for Incorporation of a Limited Liability Partnership |
LLP3 | Notice of Change of Name of a Limited Liability Partnership |
LLP8 | Notice of Designated Member(s) of a Limited Liability Partnership |
LLP233 | Change of accounting reference date of a Limited Liability Partnership |
LLP252 | Notice of claim to extension of period allowed for laying and delivering accounts - Business interest if a LLP outside the UK, etc |
LLP295 | Change in situation or address of Registered Office of a Limited Liability Partnership |
LLP296a | Appointment of a member to an LLP |
LLP296b | Terminating the Membership of a Member of a Limited Liability Partnership |
LLP296c | Change of Particulars of a Member of a Limited Liability Partnership |
LLP402 | Particulars of a mortgage or charge in respect of a Limited Liability Partnership |
LLP603a | Application for striking off a Limited Liability Partnership |
LLP603c | Withdrawal of application for striking off a Limited Liability Partnership |
CIC 36 | application to form a community interest company (including form 21 and form 23) |
CIC 37 | application to convert a company to a community interest company |
CIC34 | Community Interest Company Report (Simplified and more detailed) |
CIC14 | Altering the object statement of the memorandum of a CIC |
CIC53 | Strike off and dissolution of a community interest company |
Company Officer Disqualification Details
1 Company Directors and Secretaries
A company director may be disqualified as a result of an investigation by one of the following authorities:-
- The Police - if fraud is suspected.
- DTI Investigations - for general misconduct whilst running a company.
- The Insolvency Service - usually as a result of an investigation of a failed company (e.g. a director knowingly continues to trade while insolvent).
- Companies House - for breaches of the filing requirements as specified in the Companies Act. The Courts also have power to make a disqualification order where a company director is convicted of an indictable offence in relation to certain matters in connection with a company.
If a person is disqualified then that person shall not, for the period of his disqualification except with leave of the court:-
- Be a director of a company
- Act as a receiver of a company's property
- Be concerned or take part, whether directly or indirectly, in the promotion, formation or management of a company
- Act as an insolvency practitioner
1.1 The Company Directors Disqualification Act 1986 (the "CDDA")
Disqualification orders are made, and undertakings accepted, under sections 2 – 8 and 10 of the Company Directors Disqualification Act 1986 (the "CDDA").
Sections 2 - 5: Disqualifications for general misconduct in connection with companies –
2. On conviction of an indictable offence.
3. Persistent breaches of company legislation.
4. For fraud, etc, in winding-up.
5. On conviction of summary offences.
Sections 6 - 8: Disqualification for unfitness to act as company director –
6. Duty of court to disqualify unfit directors of insolvent companies.
7. The Secretary of State may accept a disqualification order where the conditions in section 6 are met and it appears to him to be expedient to do so in the public interest.
8. Disqualification after investigation of company, under companies and other legislation. The Secretary of State may accept an undertaking from a company director under sections 7 or 8 of the Company Directors Disqualification Act 1986.
Section 10: Fraudulent or Wrongful Trading –
10. A court may make a disqualification order where it makes a declaration in relation to fraudulent or to wrongful trading.
Sections 11 and 12: Miscellaneous Disqualification –
11. This section provides that, except with leave of court, undischarged bankrupts are disqualified from acting as directors or taking part in or being concerned in the promotion, formation or management of a company
12. This section provides that, except with leave of court, where an administration order under section 429 of the County Courts Act 1984 has been revoked and an order made under that section a person subject to such an order is similarly disqualified and also may not act as a liquidator. The maximum period of disqualification depends upon the provision under which the order is made, or undertaking accepted, and is either 5 years or 15 years.
Section 17: Application for leave under an order or undertaking –
17. A Director may apply to a Court to vary the terms of the original Disqualification Order or undertaking. In certain circumstances the court may allow the disqualified individual to continue as a director of a specific company or companies for either an interim period of time or the whole term of the disqualification. Details of any exemptions will be provided.
For further information, please refer to the Company Directors Disqualification Act 1986.
1.2 Members of Limited Liability Partnerships
A member of a limited liability partnership (LLP) can be subject to a disqualification order or undertaking under the provisions of the Limited Liability Regulations 2001.
A partner can also be subject to a disqualification order or undertaking under the provisions of the Insolvent Partnerships Order 1994.
Company Officer Types
Director (often abbreviated to dir) |
Secretary (often abbreviated to sec) |
Member of a Limited Liability Partnership |
Designated member of a Limited Liability Partnership |
Limited Partner In accordance with Section 44R of the Partnership Act 1890 |
General Partner In accordance with Section 44S(4) of the Partnership Act 1890 |
Person Authorised to Accept service of documents on behalf of the company in respect of a UK establishment |
Person Authorised to Represent the company as a permanent representative in respect of a UK establishment |
Person Authorised to Accept service of documents on behalf of the company and Represent the company as a permanent representative in respect of a UK establishment |
Manager under Section 47 of the Companies (Audit, Investigations and Community Enterprise) Act 2004 |
Receiver and manager under Section 18 of the Charities Act 1993 |
Judicial factor (Scotland) |
Manager of an EEIG where the official address of the EEIG is in the UK |
Member of a supervisory organ of a Societas Europaea (SE) |
Member of an administrative organ of a Societas Europaea (SE) |
Member of a management organ of a Societas Europaea (SE) |
Company Statuses
Active |
Dissolved |
Liquidation |
Receivership |
Converted/Closed |
RECEIVERSHIP |
VOLUNTARY ARRANGEMENT |
VOLUNTARY ARRANGEMENT/RECEIVERSHIP |
ADMINISTRATION ORDER |
ADMINISTRATION ORDER/RECEIVERSHIP |
RECEIVER MANAGER |
ADMINISTRATIVE RECEIVER |
RECEIVER MANAGER/ADMINISTRATIVE RECEIVER |
VOLUNTARY ARRANGEMENT |
VOLUNTARY ARRANGEMENT/RECEIVER MANAGER |
VOLUNTARY ARRANGEMENT/ADMINISTRATIVE RECEIVER |
VOLUNTARY ARRANGEMENT/ADMINISTRATIVE RECEIVER/RECEIVER MANAGER |
ADMINISTRATION ORDER |
ADMINISTRATION ORDER/ RECEIVER MANAGER |
ADMINISTRATION ORDER/ ADMINISTRATIVE RECEIVER |
ADMINISTRATION ORDER/ RECEIVER MANAGER |
PROPOSAL TO STRIKE OFF |
PETITION TO RESTORE |
IN ADMIN / RECIVERSHIP |
IN ADMIN |
IN ADMIN / RECEIVER MANAGER |
IN ADMIN / ADMINISTRATIVE RECEIVER |
IN ADMIN / RECEIVER MANAGER / ADMINISTRATIVE RECEIVER |
TRANSFORMED TO SE |
PROPOSED SE |
CONVERTED TO PLC |
TRANSFERRED FROM GB |