T2A


Click here for a complete list of operations.

company_name_search

Search the UK Companies House data for a UK company by name.

This returns a company number which can then be used with the 'Company Details' and other methods to obtain the full information on that organisation.

You may choose to search for present, past and proposed companies.

Test

To test the operation using the HTTP POST protocol, click the 'Invoke' button.
Parameter Value
api_key:
client:
name:
type:
page_id:

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_search"

<?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_search xmlns="https://api.t2a.io/soap">
      <api_key>string</api_key>
      <client>string</client>
      <name>string</name>
      <type>string</type>
      <page_id>string</page_id>
    </company_name_search>
  </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_searchResponse xmlns="https://api.t2a.io/soap">
      <company_name_searchResult>
        <previous_page_id>string</previous_page_id>
        <next_page_id>string</next_page_id>
        <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>
        <place_list>
          <place>
            <name>string</name>
          </place>
          <place>
            <name>string</name>
          </place>
        </place_list>
      </company_name_searchResult>
    </company_name_searchResponse>
  </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_search xmlns="https://api.t2a.io/soap">
      <api_key>string</api_key>
      <client>string</client>
      <name>string</name>
      <type>string</type>
      <page_id>string</page_id>
    </company_name_search>
  </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_searchResponse xmlns="https://api.t2a.io/soap">
      <company_name_searchResult>
        <previous_page_id>string</previous_page_id>
        <next_page_id>string</next_page_id>
        <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>
        <place_list>
          <place>
            <name>string</name>
          </place>
          <place>
            <name>string</name>
          </place>
        </place_list>
      </company_name_searchResult>
    </company_name_searchResponse>
  </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_search?api_key=string&client=string&name=string&type=string&page_id=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_search_res xmlns="https://api.t2a.io/soap">
  <previous_page_id>string</previous_page_id>
  <next_page_id>string</next_page_id>
  <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>
  <place_list>
    <place>
      <name>string</name>
    </place>
    <place>
      <name>string</name>
    </place>
  </place_list>
</company_name_search_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_search HTTP/1.1
Host: api.t2a.io
Content-Type: application/x-www-form-urlencoded
Content-Length: length

api_key=string&client=string&name=string&type=string&page_id=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_search_res xmlns="https://api.t2a.io/soap">
  <previous_page_id>string</previous_page_id>
  <next_page_id>string</next_page_id>
  <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>
  <place_list>
    <place>
      <name>string</name>
    </place>
    <place>
      <name>string</name>
    </place>
  </place_list>
</company_name_search_res>