Chapter 5.3.4 - Geocode Requests

Use Geo REST when:

  • You need quick, on-demand responses for individual addresses or latitude/longitude combinations

Geo Batch allows you to upload a CSV containing your address or latitude/longitude geocoding requests. The results can then be downloaded and exported to your database. When to use Geo Batch:

  • You have a high volume of address or latitude/longitude geocoding requests
  • You perform bill runs on a regular basis
  • You are interested in importing your response file into a spreadsheet or a database
  • A backup of the input and output data is needing to be stored in the AvaTax for Communications platform
  • An immediate response for your batch files isn't needed

Geocode Requests

The geocodeRequests object contains a list of street addresses and/or latitude/longitude coordinate pairs to geocode within the GeocodeRequest object.

Geocode Request

The geocodeRequest object contains the input data to geocode:


Only address information or latitude/longitude coordinates can be provided in the request, but not both.

Key Value
ref [string] Reference ID
Optional Reference ID for the geocode request
cass [bool] CASS Validated Address
Indicates if the CASS validated address is desired in the results
  • true: Return the CASS validated address in the results
  • false: Do not return the CASS validated address
lat [double] Latitude
Latitude for geocoding based on lat/long coordinates
long [double] Longitude
Longitude for geocoding based on lat/long coordinates
addr [string] Street address
city [string] City name
st [string] State name or abbreviation
zip [string] Postal Code


"ref": "Address Request",
"cass": true,
"addr": "255 S. King St.",
"city": "Seattle",
"st": "WA",
"zip": "98104"
"ref": "Lat/Long Request",
"lat": 35.991130741436415,
"long": -78.90267307450108