GeoTAX by Batch Address - Precisely Data Integrity Suite

This section describes how to get taxrate for an address using the GeoTAX API service. You may want to try it out with a Free Trial Account.

This method will consume credits.

• HTTP Request
  • URL Composition
    • Base URL: https://api.cloud.precisely.com
    • GeoTAX by address :/v1/geo-tax/address/batch
  • Supported Methods: POST only
  • Rate Limit (Transactions per second): 50
  • Input Fields Each request to the API service requires a few parameters, all of which are listed below. All requests require a Bearer token, that can be generated using your account's key-secret. To produce a bearer token for an API request, the generated key-secret combinations are used . The generated token is valid for 3600sec (1 hour) and then it needs to be regenerated.

    The data should be encoded as a JSON array where each element in the array is a JSON object with field names identical to those in the input/output fields listed below.

    Table 1. Parameters

    Parameter	Description	Example Value
    preferences	Options supported by the GeoTAX Service which include a variety of settings categorized into output, geocoding, matching, and custom. Some of the preferences under geocoding include, defaultBufferWidth, latLongOffset, and many more.	defaultBufferWidth: Set a different default buffer width. Default= The default integer value is 0.
    addresses	List of addresses to be processed.	addressLines: Requested address, based on the country's addressing standard. Single-line request: "201 N ALTAS PALMAS DR HARLINGEN, TX" Multi-line request: "201 N ALTAS PALMAS DR", "HARLINGEN, TX"

    Below is a sample request for GeoTAX by batch address end point.

    {
      "preferences": {
        "output": {
          "taxDistrict": "NONE",
          "salesTaxRateType": "NONE",
          "outputCasing": "UPPER",
          "taxCrossReferenceKey": "NONE",
          "usePTC": "NO",
          "userBoundary": "NO"
        },
        "geocoding": {
          "defaultBufferWidth": 0,
          "latLongOffset": "NONE",
          "squeeze": "NO",
          "latLongAltFormat": "DecimalSign",
          "usePointData": "NO"
        },
        "matching": {
          "matchMode": "CLOSE",
          "useGeoTaxAuxiliaryFile": "NO",
          "useUserAuxiliaryFile": "NO"
        }
      },
      "addresses": [
        {
          "addressLines": [
            "2001 Main St, Eagle Butte, SD 57625"
          ]
        },
        {
          "addressLines": [
            "2520 Columbia House Blvd #108, Vancouver, WA 98661"
          ]
        }
      ]
    }

"201 N ALTAS PALMAS DR HARLINGEN, TX 78552"

"201 N ALTAS PALMAS DR",
"HARLINGEN, TX 78552".