T2A Web Service

T2A

Click here for a complete list of operations.

business_search

Find a business by entering name and location.

Test

To test the operation using the HTTP POST protocol, click the 'Invoke' button.

Parameter	Value
api_key:
client:
name:
place:
premises:
street:
page_number:
records_per_page:
ltd_company_number:

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/business_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>
    <business_search xmlns="https://api.t2a.io/soap">
      <api_key>string</api_key>
      <client>string</client>
      <name>string</name>
      <place>string</place>
      <premises>string</premises>
      <street>string</street>
      <page_number>string</page_number>
      <records_per_page>string</records_per_page>
      <ltd_company_number>string</ltd_company_number>
    </business_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>
    <business_searchResponse xmlns="https://api.t2a.io/soap">
      <business_searchResult>
        <csv_data>string</csv_data>
        <place_list>
          <place>
            <name>string</name>
          </place>
          <place>
            <name>string</name>
          </place>
        </place_list>
        <business_list>
          <business>
            <name>string</name>
            <tps_status>string</tps_status>
            <telephone_number>string</telephone_number>
            <email_address>string</email_address>
            <web>string</web>
            <fax_number>string</fax_number>
            <contact_list xsi:nil="true" />
            <classification>string</classification>
            <class_code>string</class_code>
            <total_employees>string</total_employees>
            <turnover>string</turnover>
            <ltdplc>string</ltdplc>
            <year_established>string</year_established>
            <previous_name>string</previous_name>
            <company_number>string</company_number>
            <non_ltd>string</non_ltd>
            <sic07>string</sic07>
            <priority>string</priority>
            <mobile>string</mobile>
            <mobile_tps_status>string</mobile_tps_status>
            <search_type>string</search_type>
            <extra_address_list xsi:nil="true" />
          </business>
          <business>
            <name>string</name>
            <tps_status>string</tps_status>
            <telephone_number>string</telephone_number>
            <email_address>string</email_address>
            <web>string</web>
            <fax_number>string</fax_number>
            <contact_list xsi:nil="true" />
            <classification>string</classification>
            <class_code>string</class_code>
            <total_employees>string</total_employees>
            <turnover>string</turnover>
            <ltdplc>string</ltdplc>
            <year_established>string</year_established>
            <previous_name>string</previous_name>
            <company_number>string</company_number>
            <non_ltd>string</non_ltd>
            <sic07>string</sic07>
            <priority>string</priority>
            <mobile>string</mobile>
            <mobile_tps_status>string</mobile_tps_status>
            <search_type>string</search_type>
            <extra_address_list xsi:nil="true" />
          </business>
        </business_list>
        <total_ex_directory>string</total_ex_directory>
      </business_searchResult>
    </business_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>
    <business_search xmlns="https://api.t2a.io/soap">
      <api_key>string</api_key>
      <client>string</client>
      <name>string</name>
      <place>string</place>
      <premises>string</premises>
      <street>string</street>
      <page_number>string</page_number>
      <records_per_page>string</records_per_page>
      <ltd_company_number>string</ltd_company_number>
    </business_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>
    <business_searchResponse xmlns="https://api.t2a.io/soap">
      <business_searchResult>
        <csv_data>string</csv_data>
        <place_list>
          <place>
            <name>string</name>
          </place>
          <place>
            <name>string</name>
          </place>
        </place_list>
        <business_list>
          <business>
            <name>string</name>
            <tps_status>string</tps_status>
            <telephone_number>string</telephone_number>
            <email_address>string</email_address>
            <web>string</web>
            <fax_number>string</fax_number>
            <contact_list xsi:nil="true" />
            <classification>string</classification>
            <class_code>string</class_code>
            <total_employees>string</total_employees>
            <turnover>string</turnover>
            <ltdplc>string</ltdplc>
            <year_established>string</year_established>
            <previous_name>string</previous_name>
            <company_number>string</company_number>
            <non_ltd>string</non_ltd>
            <sic07>string</sic07>
            <priority>string</priority>
            <mobile>string</mobile>
            <mobile_tps_status>string</mobile_tps_status>
            <search_type>string</search_type>
            <extra_address_list xsi:nil="true" />
          </business>
          <business>
            <name>string</name>
            <tps_status>string</tps_status>
            <telephone_number>string</telephone_number>
            <email_address>string</email_address>
            <web>string</web>
            <fax_number>string</fax_number>
            <contact_list xsi:nil="true" />
            <classification>string</classification>
            <class_code>string</class_code>
            <total_employees>string</total_employees>
            <turnover>string</turnover>
            <ltdplc>string</ltdplc>
            <year_established>string</year_established>
            <previous_name>string</previous_name>
            <company_number>string</company_number>
            <non_ltd>string</non_ltd>
            <sic07>string</sic07>
            <priority>string</priority>
            <mobile>string</mobile>
            <mobile_tps_status>string</mobile_tps_status>
            <search_type>string</search_type>
            <extra_address_list xsi:nil="true" />
          </business>
        </business_list>
        <total_ex_directory>string</total_ex_directory>
      </business_searchResult>
    </business_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/business_search?api_key=string&client=string&name=string&place=string&premises=string&street=string&page_number=string&records_per_page=string&ltd_company_number=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"?>
<business_search_res xmlns="https://api.t2a.io/soap">
  <csv_data>string</csv_data>
  <place_list>
    <place>
      <name>string</name>
    </place>
    <place>
      <name>string</name>
    </place>
  </place_list>
  <business_list>
    <business>
      <name>string</name>
      <tps_status>string</tps_status>
      <telephone_number>string</telephone_number>
      <email_address>string</email_address>
      <web>string</web>
      <fax_number>string</fax_number>
      <contact_list>
        <person d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
        <person d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
      </contact_list>
      <classification>string</classification>
      <class_code>string</class_code>
      <total_employees>string</total_employees>
      <turnover>string</turnover>
      <ltdplc>string</ltdplc>
      <year_established>string</year_established>
      <previous_name>string</previous_name>
      <company_number>string</company_number>
      <non_ltd>string</non_ltd>
      <sic07>string</sic07>
      <priority>string</priority>
      <mobile>string</mobile>
      <mobile_tps_status>string</mobile_tps_status>
      <search_type>string</search_type>
      <extra_address_list>
        <address d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
        <address d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
      </extra_address_list>
    </business>
    <business>
      <name>string</name>
      <tps_status>string</tps_status>
      <telephone_number>string</telephone_number>
      <email_address>string</email_address>
      <web>string</web>
      <fax_number>string</fax_number>
      <contact_list>
        <person d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
        <person d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
      </contact_list>
      <classification>string</classification>
      <class_code>string</class_code>
      <total_employees>string</total_employees>
      <turnover>string</turnover>
      <ltdplc>string</ltdplc>
      <year_established>string</year_established>
      <previous_name>string</previous_name>
      <company_number>string</company_number>
      <non_ltd>string</non_ltd>
      <sic07>string</sic07>
      <priority>string</priority>
      <mobile>string</mobile>
      <mobile_tps_status>string</mobile_tps_status>
      <search_type>string</search_type>
      <extra_address_list>
        <address d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
        <address d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
      </extra_address_list>
    </business>
  </business_list>
  <total_ex_directory>string</total_ex_directory>
</business_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/business_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&place=string&premises=string&street=string&page_number=string&records_per_page=string&ltd_company_number=string

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<business_search_res xmlns="https://api.t2a.io/soap">
  <csv_data>string</csv_data>
  <place_list>
    <place>
      <name>string</name>
    </place>
    <place>
      <name>string</name>
    </place>
  </place_list>
  <business_list>
    <business>
      <name>string</name>
      <tps_status>string</tps_status>
      <telephone_number>string</telephone_number>
      <email_address>string</email_address>
      <web>string</web>
      <fax_number>string</fax_number>
      <contact_list>
        <person d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
        <person d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
      </contact_list>
      <classification>string</classification>
      <class_code>string</class_code>
      <total_employees>string</total_employees>
      <turnover>string</turnover>
      <ltdplc>string</ltdplc>
      <year_established>string</year_established>
      <previous_name>string</previous_name>
      <company_number>string</company_number>
      <non_ltd>string</non_ltd>
      <sic07>string</sic07>
      <priority>string</priority>
      <mobile>string</mobile>
      <mobile_tps_status>string</mobile_tps_status>
      <search_type>string</search_type>
      <extra_address_list>
        <address d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
        <address d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
      </extra_address_list>
    </business>
    <business>
      <name>string</name>
      <tps_status>string</tps_status>
      <telephone_number>string</telephone_number>
      <email_address>string</email_address>
      <web>string</web>
      <fax_number>string</fax_number>
      <contact_list>
        <person d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
        <person d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
      </contact_list>
      <classification>string</classification>
      <class_code>string</class_code>
      <total_employees>string</total_employees>
      <turnover>string</turnover>
      <ltdplc>string</ltdplc>
      <year_established>string</year_established>
      <previous_name>string</previous_name>
      <company_number>string</company_number>
      <non_ltd>string</non_ltd>
      <sic07>string</sic07>
      <priority>string</priority>
      <mobile>string</mobile>
      <mobile_tps_status>string</mobile_tps_status>
      <search_type>string</search_type>
      <extra_address_list>
        <address d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
        <address d5p1:nil="true" xmlns:d5p1="http://www.w3.org/2001/XMLSchema-instance" />
      </extra_address_list>
    </business>
  </business_list>
  <total_ex_directory>string</total_ex_directory>
</business_search_res>