T2A Web Service

T2A

Click here for a complete list of operations.

geo_code_telephone

Returns approximate geographical area of a telephone number. For GB data returns OSGB36 Eastings and Northings (X,Y in metres) and WGS84 (used by GPS) Latitude and Longitude co-ordinates. Enter the ISO 3166-1 two-character country code; currently only GB is supported.

Test

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

Parameter	Value
api_key:
client:
country_ISO_3166_1:
telephone_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/geo_code_telephone"

<?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>
    <geo_code_telephone xmlns="https://api.t2a.io/soap">
      <api_key>string</api_key>
      <client>string</client>
      <country_ISO_3166_1>string</country_ISO_3166_1>
      <telephone_number>string</telephone_number>
    </geo_code_telephone>
  </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>
    <geo_code_telephoneResponse xmlns="https://api.t2a.io/soap">
      <geo_code_telephoneResult>
        <geo_data>
          <north>string</north>
          <east>string</east>
          <country_code>string</country_code>
          <country_name>string</country_name>
          <latitude>string</latitude>
          <longitude>string</longitude>
          <description>string</description>
          <postcode>string</postcode>
          <city>string</city>
          <accurate>string</accurate>
          <uprn>string</uprn>
          <uprn_enc>string</uprn_enc>
          <level>string</level>
        </geo_data>
        <job_id>string</job_id>
        <accuracy_radius>string</accuracy_radius>
        <postcode_area>string</postcode_area>
        <name>string</name>
        <containing_name>string</containing_name>
        <containing_name2>string</containing_name2>
        <date_time>
          <year>string</year>
          <month>string</month>
          <day>string</day>
          <hour>string</hour>
          <min>string</min>
          <sec>string</sec>
        </date_time>
      </geo_code_telephoneResult>
    </geo_code_telephoneResponse>
  </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>
    <geo_code_telephone xmlns="https://api.t2a.io/soap">
      <api_key>string</api_key>
      <client>string</client>
      <country_ISO_3166_1>string</country_ISO_3166_1>
      <telephone_number>string</telephone_number>
    </geo_code_telephone>
  </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>
    <geo_code_telephoneResponse xmlns="https://api.t2a.io/soap">
      <geo_code_telephoneResult>
        <geo_data>
          <north>string</north>
          <east>string</east>
          <country_code>string</country_code>
          <country_name>string</country_name>
          <latitude>string</latitude>
          <longitude>string</longitude>
          <description>string</description>
          <postcode>string</postcode>
          <city>string</city>
          <accurate>string</accurate>
          <uprn>string</uprn>
          <uprn_enc>string</uprn_enc>
          <level>string</level>
        </geo_data>
        <job_id>string</job_id>
        <accuracy_radius>string</accuracy_radius>
        <postcode_area>string</postcode_area>
        <name>string</name>
        <containing_name>string</containing_name>
        <containing_name2>string</containing_name2>
        <date_time>
          <year>string</year>
          <month>string</month>
          <day>string</day>
          <hour>string</hour>
          <min>string</min>
          <sec>string</sec>
        </date_time>
      </geo_code_telephoneResult>
    </geo_code_telephoneResponse>
  </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/geo_code_telephone?api_key=string&client=string&country_ISO_3166_1=string&telephone_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"?>
<geo_code_telephone_res xmlns="https://api.t2a.io/soap">
  <geo_data>
    <north>string</north>
    <east>string</east>
    <country_code>string</country_code>
    <country_name>string</country_name>
    <latitude>string</latitude>
    <longitude>string</longitude>
    <description>string</description>
    <postcode>string</postcode>
    <city>string</city>
    <accurate>string</accurate>
    <uprn>string</uprn>
    <uprn_enc>string</uprn_enc>
    <level>string</level>
  </geo_data>
  <job_id>string</job_id>
  <accuracy_radius>string</accuracy_radius>
  <postcode_area>string</postcode_area>
  <name>string</name>
  <containing_name>string</containing_name>
  <containing_name2>string</containing_name2>
  <date_time>
    <year>string</year>
    <month>string</month>
    <day>string</day>
    <hour>string</hour>
    <min>string</min>
    <sec>string</sec>
  </date_time>
</geo_code_telephone_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/geo_code_telephone HTTP/1.1
Host: api.t2a.io
Content-Type: application/x-www-form-urlencoded
Content-Length: length

api_key=string&client=string&country_ISO_3166_1=string&telephone_number=string

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

<?xml version="1.0" encoding="utf-8"?>
<geo_code_telephone_res xmlns="https://api.t2a.io/soap">
  <geo_data>
    <north>string</north>
    <east>string</east>
    <country_code>string</country_code>
    <country_name>string</country_name>
    <latitude>string</latitude>
    <longitude>string</longitude>
    <description>string</description>
    <postcode>string</postcode>
    <city>string</city>
    <accurate>string</accurate>
    <uprn>string</uprn>
    <uprn_enc>string</uprn_enc>
    <level>string</level>
  </geo_data>
  <job_id>string</job_id>
  <accuracy_radius>string</accuracy_radius>
  <postcode_area>string</postcode_area>
  <name>string</name>
  <containing_name>string</containing_name>
  <containing_name2>string</containing_name2>
  <date_time>
    <year>string</year>
    <month>string</month>
    <day>string</day>
    <hour>string</hour>
    <min>string</min>
    <sec>string</sec>
  </date_time>
</geo_code_telephone_res>