Resolve Taxable Location
Find or create a Taxable Location object in Zeal’s system. This request will try to match an existing record with a case-sensitive search.
curl --request POST \
--url https://api.zeal.com/taxableLocations \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"street1": "<string>",
"city": "<string>",
"street2": "<string>",
"state": "<string>",
"zip": "<string>",
"postal_code": "<string>"
}
'import requests
url = "https://api.zeal.com/taxableLocations"
payload = {
"street1": "<string>",
"city": "<string>",
"street2": "<string>",
"state": "<string>",
"zip": "<string>",
"postal_code": "<string>"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
street1: '<string>',
city: '<string>',
street2: '<string>',
state: '<string>',
zip: '<string>',
postal_code: '<string>'
})
};
fetch('https://api.zeal.com/taxableLocations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.zeal.com/taxableLocations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'street1' => '<string>',
'city' => '<string>',
'street2' => '<string>',
'state' => '<string>',
'zip' => '<string>',
'postal_code' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.zeal.com/taxableLocations"
payload := strings.NewReader("{\n \"street1\": \"<string>\",\n \"city\": \"<string>\",\n \"street2\": \"<string>\",\n \"state\": \"<string>\",\n \"zip\": \"<string>\",\n \"postal_code\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.zeal.com/taxableLocations")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"street1\": \"<string>\",\n \"city\": \"<string>\",\n \"street2\": \"<string>\",\n \"state\": \"<string>\",\n \"zip\": \"<string>\",\n \"postal_code\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zeal.com/taxableLocations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"street1\": \"<string>\",\n \"city\": \"<string>\",\n \"street2\": \"<string>\",\n \"state\": \"<string>\",\n \"zip\": \"<string>\",\n \"postal_code\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"taxableLocationID": "609ffdf81a5f9c4c10b0c443",
"street1": "1 Ferry Building",
"street2": "",
"city": "San Francisco",
"state": "CA",
"zip": "94111",
"is_suitable_for_taxation": true,
"is_po_box": false,
"is_state_mismatch": false,
"is_armed_forces_address": false,
"is_foreign_address": false,
"is_deliverable": true
}
}{
"success": false,
"errors": [
{
"message": "The address provided is not suitable for taxation.",
"code": 34
}
]
}Authorizations
Body
Address Line 1 (Street Name)
City/Subdivision
Address Line 2 (Apt/Suite). Empty string if not applicable
US State or Territory (2-letter abbreviation). Used when country is US. Optional for Canadian addresses.
ZIP code (5 digits). Used when country is US. Optional for Canadian addresses.
Country for the address. One of US or CA. Defaults to US if omitted. NOTE: CA is only applicable for Canadian Payroll (Early Access)
US, CA Canadian province/territory (2-letter abbreviation). Used when country is CA. NOTE: Only applicable for Canadian Payroll (Early Access)
AB, BC, MB, NB, NL, NS, NT, NU, ON, PE, QC, SK, YT Canadian postal code. Used when country is CA. NOTE: Only applicable for Canadian Payroll (Early Access)
curl --request POST \
--url https://api.zeal.com/taxableLocations \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"street1": "<string>",
"city": "<string>",
"street2": "<string>",
"state": "<string>",
"zip": "<string>",
"postal_code": "<string>"
}
'import requests
url = "https://api.zeal.com/taxableLocations"
payload = {
"street1": "<string>",
"city": "<string>",
"street2": "<string>",
"state": "<string>",
"zip": "<string>",
"postal_code": "<string>"
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
street1: '<string>',
city: '<string>',
street2: '<string>',
state: '<string>',
zip: '<string>',
postal_code: '<string>'
})
};
fetch('https://api.zeal.com/taxableLocations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.zeal.com/taxableLocations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'street1' => '<string>',
'city' => '<string>',
'street2' => '<string>',
'state' => '<string>',
'zip' => '<string>',
'postal_code' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.zeal.com/taxableLocations"
payload := strings.NewReader("{\n \"street1\": \"<string>\",\n \"city\": \"<string>\",\n \"street2\": \"<string>\",\n \"state\": \"<string>\",\n \"zip\": \"<string>\",\n \"postal_code\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.zeal.com/taxableLocations")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"street1\": \"<string>\",\n \"city\": \"<string>\",\n \"street2\": \"<string>\",\n \"state\": \"<string>\",\n \"zip\": \"<string>\",\n \"postal_code\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zeal.com/taxableLocations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"street1\": \"<string>\",\n \"city\": \"<string>\",\n \"street2\": \"<string>\",\n \"state\": \"<string>\",\n \"zip\": \"<string>\",\n \"postal_code\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"data": {
"taxableLocationID": "609ffdf81a5f9c4c10b0c443",
"street1": "1 Ferry Building",
"street2": "",
"city": "San Francisco",
"state": "CA",
"zip": "94111",
"is_suitable_for_taxation": true,
"is_po_box": false,
"is_state_mismatch": false,
"is_armed_forces_address": false,
"is_foreign_address": false,
"is_deliverable": true
}
}{
"success": false,
"errors": [
{
"message": "The address provided is not suitable for taxation.",
"code": 34
}
]
}