GeoTAX
Determines tax jurisdiction and tax codes of given coordinates
This endpoint takes a latitude and longitude as input and determines which tax jurisdiction a given address is located in, and which current tax codes apply.
post/v1/geo-tax/location
Request
- Base URL: https://api.cloud.precisely.com
- URL: https://api.cloud.precisely.com/v1/geo-tax/location
- 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
{
"location": {
"addressId": "1",
"longitude": -98.401796,
"latitude": 34.688726
},
"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 location 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.