ZipCodes Web Service

NOTE: This service requires a subscription.
You can register online using Subscriptions interface. There're several types of subscriptions available including a free subscription so you can continue using the web service without paying. When you subscribe you will be issued a subscriber ID that uniquely identify you. You must submit that ID with every request by setting AuthenticationHeader SOAP header. Consult WSDL for more information.

Help and samples Contact info

Click here for a complete list of operations.

SaveUserPlaces

Saves user-defined places.

Test

No test form is available as this service or method does not support the HTTP GET protocol.

SOAP 1.1 (show / hide)

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /services/zipcodelookup.asmx HTTP/1.1
Host: codebump.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://skats.net/services/SaveUserPlaces"

<?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:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns="http://skats.net/services/" xmlns:types="http://skats.net/services/encodedTypes" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <tns:AuthenticationHeader>
      <SessionID xsi:type="xsd:string">string</SessionID>
    </tns:AuthenticationHeader>
  </soap:Header>
  <soap:Body soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
    <tns:SaveUserPlaces>
      <places href="#id1" />
    </tns:SaveUserPlaces>
    <soapenc:Array id="id1" soapenc:arrayType="tns:UserPlaceDetail[2]">
      <Item href="#id2" />
      <Item href="#id3" />
    </soapenc:Array>
    <tns:UserPlaceDetail id="id2" xsi:type="tns:UserPlaceDetail">
      <Id xsi:type="xsd:int">int</Id>
      <Name xsi:type="xsd:string">string</Name>
      <Address xsi:type="xsd:string">string</Address>
      <City xsi:type="xsd:string">string</City>
      <State xsi:type="xsd:string">string</State>
      <ZipCode xsi:type="xsd:string">string</ZipCode>
      <Category xsi:type="xsd:string">string</Category>
      <Data xsi:type="xsd:string">string</Data>
      <LatDegrees xsi:type="xsd:float">float</LatDegrees>
      <LonDegrees xsi:type="xsd:float">float</LonDegrees>
      <LatRadians xsi:type="xsd:float">float</LatRadians>
      <LonRadians xsi:type="xsd:float">float</LonRadians>
      <Distance xsi:type="xsd:float">float</Distance>
      <Country xsi:type="xsd:string">string</Country>
    </tns:UserPlaceDetail>
    <tns:UserPlaceDetail id="id3" xsi:type="tns:UserPlaceDetail">
      <Id xsi:type="xsd:int">int</Id>
      <Name xsi:type="xsd:string">string</Name>
      <Address xsi:type="xsd:string">string</Address>
      <City xsi:type="xsd:string">string</City>
      <State xsi:type="xsd:string">string</State>
      <ZipCode xsi:type="xsd:string">string</ZipCode>
      <Category xsi:type="xsd:string">string</Category>
      <Data xsi:type="xsd:string">string</Data>
      <LatDegrees xsi:type="xsd:float">float</LatDegrees>
      <LonDegrees xsi:type="xsd:float">float</LonDegrees>
      <LatRadians xsi:type="xsd:float">float</LatRadians>
      <LonRadians xsi:type="xsd:float">float</LonRadians>
      <Distance xsi:type="xsd:float">float</Distance>
      <Country xsi:type="xsd:string">string</Country>
    </tns:UserPlaceDetail>
  </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:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns="http://skats.net/services/" xmlns:types="http://skats.net/services/encodedTypes" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
    <tns:SaveUserPlacesResponse />
  </soap:Body>
</soap:Envelope>

HTTP GET (show / hide)

HTTP POST (show / hide)