GeoTAX
Determines tax jurisdiction and tax codes of given address
This endpoint takes a single input address and determines which tax jurisdiction a given address is located in, and which current tax codes apply.
post/v1/geo-tax/address
Request
- Base URL: https://api.cloud.precisely.com
- URL: https://api.cloud.precisely.com/v1/geo-tax/address
- Auth: one of:
- HTTP bearer
- API key in header Authorization
Headers
X-Request-Idstring
The X-Request-Id header is optional but incredibly useful for developers. It serves as a unique identifier for requests within our system. When you encounter any problems with your requests, providing us with the X-Request-Id will enable us to pinpoint the specific request in question without the need for extensive manual searching. This means faster and more efficient troubleshooting. The maximum allowed length is 38 characters.
Request body
Example request
{
"address": {
"addressId": "1",
"addressLines": [
"2001 Main St, Eagle Butte, SD 57625"
],
"addressNumber": "2001",
"admin1": "Minnesota",
"admin2": "Dakota County",
"city": "HASTINGS",
"neighborhood": "Downtown",
"postalCode": "55033",
"postalCodeExt": "8012",
"street": "Main St",
"building": "Building A",
"unit": "5B",
"unitType": "APT"
},
"preferences": {
"geocoding": {
"latLongOffset": "NONE",
"squeeze": "NO",
"latLongAltFormat": "DecimalDirectional",
"usePointData": "YES"
},
"matching": {
"matchMode": "EXACT",
"useGeoTaxAuxiliaryFile": "YES",
"useUserAuxiliaryFile": "NO"
},
"output": {
"taxDistrict": "SPD",
"salesTaxRateType": "GENERAL",
"outputCasing": "UPPER",
"taxCrossReferenceKey": "VERTEX",
"usePTC": "NO",
"userBoundary": "NO"
}
}
}Response
Tax Details Retrieved Successfully for GeoTAX by address API
Example response
{
"response": {
"status": "OK",
"errorMessage": "Request is not valid",
"result": {
"addressId": "1",
"gnisCode": "001267480",
"preciselyId": "PBS003PYQJX9",
"confidence": 100,
"jurisdiction": {
"state": {
"code": "46",
"name": "SD"
},
"county": {
"code": "035",
"name": "DAVISON"
},
"place": {
"name": "MITCHELL",
"code": "43100",
"gnisCode": "001267480",
"classCode": "C5",
"incorporatedFlag": "Inc",
"lastAnnexedDate": "01/2020",
"lastUpdatedDate": "10/2022",
"lastVerifiedDate": "04/2022",
"pointStatus": "p",
"distanceToBorder": "1776",
"confidence": "98"
},
"geoTaxKey": "5282",
"geoTaxKeyMatchCode": "E",
"spds": [
{
"stateId": "426",
"districtName": "PHILADELPHIA CITY - PHILADELPHIA CITY S D",
"districtCode": "SCD",
"districtNumber": "00004",
"versionDate": "092006",
"effectiveDate": "012004",
"compiledDate": "092006",
"updateDate": "062024",
"boundaryBuffer": {
"bufferRelation": {
"description": " ",
"value": "P"
},
"distanceToBorder": {
"unit": "feet",
"value": "7887"
}
}
}
]
},
"matchedAddress": {
"formattedAddress": "2001 N MAIN ST MITCHELL, SD 57301",
"formattedStreetAddress": "2001 N MAIN ST",
"formattedLocationAddress": "MITCHELL, SD 57301",
"addressNumber": "2001",
"stateName": "SD",
"countyName": "DAVISON",
"cityName": "MITCHELL",
"postalCode": "57301",
"postalCodeExt": "2890",
"placeName": "MITCHELL",
"unit": "123 E Main St APT 3",
"unitType": "APT",
"street": "MAIN",
"firmName": "Mayfire Corporation",
"dataTypeName": "TOMTOM STREETS",
"genRC": "S",
"locationCode": "AS0",
"matchCode": "TB21",
"numCandidates": "0",
"urbanization": "URB COUNTRY CLUB",
"houseNumber": "2001",
"preDirectional": "N",
"streetType": "ST",
"postDirectional": "N",
"country": "USA",
"city": "New York"
},
"salesTax": {
"totalTaxRate": 0.876,
"stateTaxRate": 0.715,
"municipalTaxRate": 0.318,
"resultCode": "E",
"spdsTax": [
{
"districtNumber": "00004",
"taxRate": 0.8
}
]
},
"useTax": {
"totalTaxRate": 0.062,
"stateTaxRate": 0.042,
"countyTaxRate": 0.07,
"municipalTaxRate": 0.065,
"resultCode": "E",
"spdsTax": [
{
"districtNumber": "00004",
"taxRate": 0.8
}
]
},
"census": {
"block": "050",
"blockCode": "170898531002008",
"blockGroup": "5",
"cbsa": {
"name": "MITCHELL, SD MICROPOLITAN STATISTICAL AREA",
"code": "33580",
"metroFlag": "N"
},
"matchLevel": "Street",
"matchCode": "5",
"tract": "962700",
"mcd": {
"name": "MITCHELL CITY",
"code": "43100",
"pointStatus": "p",
"distanceToBorder": "1776",
"confidence": "98"
},
"cbsad": {
"name": "MICROPOLITAN STATISTICAL AREA",
"code": "459012"
},
"csa": {
"name": "DENVER-AURORA-GREELEY, CO COMBINED STATISTICAL AREA",
"code": "216"
}
},
"latLongFields": {
"matchCode": "R",
"matchLevel": "Rooftop",
"geometry": {
"latLongAltFmt": "DecimalSign",
"latLongAltFmtValue": "43.731783-098.025936",
"type": "Point",
"coordinates": [
43.731783,
-98.025936
]
}
},
"ipds": [
{
"districtID": "546",
"districtName": "LAKELAND",
"districtType": {
"description": "LAKELAND",
"value": "546"
},
"taxCodeDescription": "Minimum",
"notes": "33",
"effectiveDate": "010108",
"expirationDate": "063009",
"versionDate": "032023",
"updateDate": "072024",
"changeDate": "062024",
"boundaryBuffer": {
"bufferRelation": {
"description": " ",
"value": "P"
},
"distanceToBorder": {
"unit": "feet",
"value": "7887"
}
},
"rates": [
{
"name": "Other",
"format": "0.575",
"formatDescription": "P",
"value": ".13"
}
]
}
],
"ptds": [
{
"id": "18990",
"districtId": "A2654",
"districtName": "PHILADELPHIA CITY - PHILADELPHIA CITY S D",
"districtType": "UNI",
"updateDate": "082015",
"municipalEMSTax": "Y",
"municipalIncomeTax": "B",
"schoolDistrictEMSTax": "N",
"schoolDistrictIncomeTax": "R",
"boundaryBuffer": {
"bufferRelation": {
"description": " ",
"value": "P"
},
"distanceToBorder": {
"unit": "feet",
"value": "7887"
}
}
}
],
"ptc": {
"matchCode": "TB21",
"ptcs": [
{
"payrollCode": "48000",
"payrollDescription": "LOUISVILLE METRO",
"payrollFlag": "X"
}
]
},
"userBoundaries": [
{
"boundaryID": "21",
"boundaryDescription": "Kentucky",
"supplementalBoundaryID": "KY",
"boundaryConfidence": "22",
"bufferRelation": "P",
"distanceToBorder": "11533"
}
]
}
}
}Changes
No recorded changes to this operation across all 1 revision of this API.