T2A
Click here for a complete list of operations.
company_name_check
Checks if a proposed company name is already registered, or if there is an existing company name which is too similar to the proposed name, under the Companies House 2006 regulations.
For example, a name check on “Simunix Wholesellers” will return “no match”, but a name check on “Simunix International” will return “Simunix Limited” because the proposed name is too similar to the latter.
Test
To test the operation using the HTTP POST protocol, click the 'Invoke' button.SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
POST /soap/t2a.asmx HTTP/1.1
Host: api.t2a.io
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://api.t2a.io/soap/company_name_check"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<company_name_check xmlns="https://api.t2a.io/soap">
<api_key>string</api_key>
<client>string</client>
<name>string</name>
</company_name_check>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<company_name_checkResponse xmlns="https://api.t2a.io/soap">
<company_name_checkResult>
<input_name>string</input_name>
<company_short_list>
<company_short>
<name>string</name>
<company_number>string</company_number>
<data_set>string</data_set>
<company_index_status>string</company_index_status>
<company_date>string</company_date>
<place>string</place>
<sic_code xsi:nil="true" />
<email_address>string</email_address>
<non_ltd>string</non_ltd>
<company_status>string</company_status>
</company_short>
<company_short>
<name>string</name>
<company_number>string</company_number>
<data_set>string</data_set>
<company_index_status>string</company_index_status>
<company_date>string</company_date>
<place>string</place>
<sic_code xsi:nil="true" />
<email_address>string</email_address>
<non_ltd>string</non_ltd>
<company_status>string</company_status>
</company_short>
</company_short_list>
</company_name_checkResult>
</company_name_checkResponse>
</soap:Body>
</soap:Envelope>
SOAP 1.2
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
POST /soap/t2a.asmx HTTP/1.1
Host: api.t2a.io
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<company_name_check xmlns="https://api.t2a.io/soap">
<api_key>string</api_key>
<client>string</client>
<name>string</name>
</company_name_check>
</soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<company_name_checkResponse xmlns="https://api.t2a.io/soap">
<company_name_checkResult>
<input_name>string</input_name>
<company_short_list>
<company_short>
<name>string</name>
<company_number>string</company_number>
<data_set>string</data_set>
<company_index_status>string</company_index_status>
<company_date>string</company_date>
<place>string</place>
<sic_code xsi:nil="true" />
<email_address>string</email_address>
<non_ltd>string</non_ltd>
<company_status>string</company_status>
</company_short>
<company_short>
<name>string</name>
<company_number>string</company_number>
<data_set>string</data_set>
<company_index_status>string</company_index_status>
<company_date>string</company_date>
<place>string</place>
<sic_code xsi:nil="true" />
<email_address>string</email_address>
<non_ltd>string</non_ltd>
<company_status>string</company_status>
</company_short>
</company_short_list>
</company_name_checkResult>
</company_name_checkResponse>
</soap12:Body>
</soap12:Envelope>
HTTP GET
The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.
GET /soap/t2a.asmx/company_name_check?api_key=string&client=string&name=string HTTP/1.1 Host: api.t2a.io
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<company_name_check_res xmlns="https://api.t2a.io/soap">
<input_name>string</input_name>
<company_short_list>
<company_short>
<name>string</name>
<company_number>string</company_number>
<data_set>string</data_set>
<company_index_status>string</company_index_status>
<company_date>string</company_date>
<place>string</place>
<sic_code>
<sic_text>string</sic_text>
</sic_code>
<email_address>string</email_address>
<non_ltd>string</non_ltd>
<company_status>string</company_status>
</company_short>
<company_short>
<name>string</name>
<company_number>string</company_number>
<data_set>string</data_set>
<company_index_status>string</company_index_status>
<company_date>string</company_date>
<place>string</place>
<sic_code>
<sic_text>string</sic_text>
</sic_code>
<email_address>string</email_address>
<non_ltd>string</non_ltd>
<company_status>string</company_status>
</company_short>
</company_short_list>
</company_name_check_res>
HTTP POST
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.
POST /soap/t2a.asmx/company_name_check HTTP/1.1 Host: api.t2a.io Content-Type: application/x-www-form-urlencoded Content-Length: length api_key=string&client=string&name=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<company_name_check_res xmlns="https://api.t2a.io/soap">
<input_name>string</input_name>
<company_short_list>
<company_short>
<name>string</name>
<company_number>string</company_number>
<data_set>string</data_set>
<company_index_status>string</company_index_status>
<company_date>string</company_date>
<place>string</place>
<sic_code>
<sic_text>string</sic_text>
</sic_code>
<email_address>string</email_address>
<non_ltd>string</non_ltd>
<company_status>string</company_status>
</company_short>
<company_short>
<name>string</name>
<company_number>string</company_number>
<data_set>string</data_set>
<company_index_status>string</company_index_status>
<company_date>string</company_date>
<place>string</place>
<sic_code>
<sic_text>string</sic_text>
</sic_code>
<email_address>string</email_address>
<non_ltd>string</non_ltd>
<company_status>string</company_status>
</company_short>
</company_short_list>
</company_name_check_res>