Menu
Zip2Tax LLC
zip2tax cart0
  • Home |
  • Online Lookup |
  • Sales Tax API |
  • Sales Tax Tables |
    • Single State Rate Table
    • U.S. Tax Rate Table
    • Canada Tax Table
  • Subscriber Portal Login |
  • Zip2Tax Blog |
  • Contact Us |
  • Search
  • 1-866-492-8494
  • Zip2Tax LLC on Facebook
  • Zip2Tax LLC on YouTube
  • Zip2Tax LLC on LinkedIn
  • Email Zip2Tax LLC
  • 1-866-492-8494
zip2tax cart 0

Your Cart is Empty

    • $0.00 Subtotal
      • Home |
      • Online Lookup |
      • Sales Tax API |
      • Sales Tax Tables |
        • Single State Rate Table
        • U.S. Tax Rate Table
        • Canada Tax Table
      Zip2Tax LLC
      • Subscriber Portal Login |
      • Zip2Tax Blog |
      • Contact Us |
      • Search
      • Single State Rate Table
      • U.S. Tax Rate Table
      • Canada Tax Table

      Sales Tax API Response Fields

      Developer's API Menu

      • Overview
      • Sample Results
        • ZIP Code API
        • SalesTax+4® API
        • Spot-On® API
      • Endpoints
      • Response Fields
      • Coding Examples
        • Classic ASP
        • C#.NET
        • PHP
      • Error Codes

      Response fields for XML and JSON

      Programming Note:

      Consider when using the API response, it should be read using the field names and not the relative position.  This will avoid problems to your program if we add additional fields as the service improves and grows.

      We will never remove a field name to ensure constant success of legacy coding.         

      Output container/fieldTypeDescription
      z2tLookupRoot container
      z2tLookup/errorInfoNodeContains summary information about request processing.
      Occurrence: Always
      z2tLookup/errorInfo/errorCodeElementDescribe result of request processing.
      Format: Digital Code
      Occurrence: Always
      See the page sidebar menu for a list of error codes.
      z2tLookup/errorInfo/errorMessageElementDescribe result of request processing.
      Format: String
      Occurrence: Always
      z2tLookup/errorInfo/errorMessageVerboseElementTextual value of described exception.
      Format: String
      Occurrence: Conditional
      z2tLookup/errorInfo/elapsedTimeElementDescribes duration time of request processing.
      Format: Time (hh:mm:dd.ms)
      Occurrence: Always
      z2tLookup/errorInfo/startTimeElementDescribes date and time request received.
      Format: Time (hh:mm:dd.ms)
      Occurrence: Always
      z2tLookup/errorInfo/endTimeElementDescribes date and time request completed.
      Format: Time (hh:mm:dd.ms)
      Occurrence: Always
      z2tLookup/errorInfo/ServerNameElementServer name where request received.
      Format: String
      Occurrence: Always
      z2tLookup/errorInfo/VersionElementCurrent version of API processor.
      Format: String
      Occurrence: Always
      z2tLookup/errorInfo/warningsNodeList of warnings during request processing.
      Occurrence: Always
      z2tLookup/errorInfo/warnings/warningElementList of warnings during request processing.
      Format: String
      Occurrence: Conditional
      z2tLookup/addressInfoNodeResult of request processing.
      Format: Object
      Occurrence: Always
      z2tLookup/addressInfo/addressResolutionElementDescribe address resolution used in processing.
      Format: String
      Occurrence: Always
      z2tLookup/addressInfo/addressesArray of NodesList of tax jurisdiction objects.
      Format: Array
      Occurrence: Always
      z2tLookup/addressInfo/addresses/addressNodeDescriber tax jurisdiction object.
      Format: Object
      Occurrence: Conditional

      z2tLookup/addressInfo/addresses/address/ addressLine1

      ElementStreet address used for processing. (if any).
      Format: String
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/ placeElementCity used for processing (if any).
      Format: String
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/ stateElementState used for processing (if any).
      Format: String
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/ zipCodeElementZIP code used for processing / detected during processing.
      Format: String
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/ countyElementCounty detected during processing.
      Format: String
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/ latitudeElementLatitude as per geolocation (for Spot-On resolution).
      Blank for zip resolution
      Format: decimal (12,6)
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/ longitudeElementLongitude as per geolocation (for Spot-On resolution).
      Blank for zip resolution
      Format: Decimal (12,6)
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/ salesTaxNodeDescriber sales tax rate for current address object
      Format: Object
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/ salesTax/taxRateElementTotal value of sales tax rate for current address.
      Format: Percentage
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/ salesTax/rateInfoArray of NodesDetailed description of sales tax by jurisdiction level.
      Format: Object
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/ salesTax/rateInfo/rateDetailsNodeDetailed jurisdiction level for sales tax.
      Format: Object
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/ salesTax/rateInfo/rateDetails/jurisdictionLevelElementJurisdiction level name.
      Format: string
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/ salesTax/rateInfo/rateDetails/jurisdictionCodeElementJurisdiction level code.
      Format: String
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/ salesTax/rateInfo/rateDetails/taxRateElementJurisdiction level sales tax rate value.
      Format: percentage
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/ salesTax/rateInfo/rateDetails/rateDetail/authorityNameElementAuthority name.
      Format: String
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/useTaxNodeDescriber use tax rate for current address object
      Format: Object
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/useTax/taxRateElementTotal value of use tax rate for current address.
      Format: Percentage
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/ useTax/rateInfoArray of NodesDetailed description of use tax by jurisdiction level.
      Format: Object
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/ useTax/rateInfo/rateDetailsNodeDetailed jurisdiction level for use tax.
      Format: Object
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/ useTax/rateInfo/rateDetails/jurisdictionLevelElementJurisdiction level name.
      Format: String
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/ useTax/rateInfo/rateDetails/jurisdictionCodeElementJurisdiction level code.
      Format: String
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/ useTax/rateInfo/rateDetails/taxRateElementJurisdiction level use tax rate value.
      Format: Percentage
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/ useTax/rateInfo/rateDetails/rateDetail/authorityNameElementAuthority name.
      Format: String
      Occurrence: Always
      z2tLookup/addressInfo/addresses/ address/notesNodeAny notes for current address.
      Format: Object
      Occurrence: Always
      z2tLookup/addressInfo/addresses/address/ notes/noteDetailsArray of NodesList of notes.
      Format: Array
      Occurrence: Conditional
      z2tLookup/addressInfo/addresses/address/ notes/noteDetails/noteDetail/jurisdictionElementJurisdiction level for note.
      Format: String
      Occurrence: Conditional
      z2tLookup/addressInfo/addresses/address/ notes/noteDetails/noteDetail/categoryElementCategory of note.
      Format: String
      Occurrence: Conditional
      z2tLookup/addressInfo/addresses/address/ notes/noteDetails/noteDetail/noteElementCategory of note.
      Format: string
      Occurrence: Conditional
      Zip2Tax, LLC
      • About Us

      • Terms of Service

      • Privacy Policy

      • Refund Policy

      Our Solutions
      • Sales Tax Online Lookup

      • Sales Tax API

      • Sales Tax Tables

      • Sales and Use Tax Resources

      More Information
      • Tax Table Formats

      • Table FAQs

      • Subscription FAQs

      • Compare ZIP Code Resolutions

      Free Sales Tax Information
      • Canada Sales Tax Map

      • U.S. Sales Tax Map

      • Zip2Tax Facts Blog

      • Trusted Resources

      • Zip2Tax LLC on Facebook
      • Zip2Tax LLC on YouTube
      • Zip2Tax LLC on LinkedIn
      • Email Zip2Tax LLC
      • Zip2Tax LLC on Facebook
      • Zip2Tax LLC on YouTube
      • Zip2Tax LLC on LinkedIn
      • Email Zip2Tax LLC

      © 2023 Zip2Tax LLC. All rights reserved. Zip2Tax™ , SalesTax+4™ and Spot-On™ are registered trademarks of Zip2Tax, LLC.

      Payment Methods