Investigator API

POST Search TaxChanges

OVERVIEWREQUESTRESPONSETRY IT OUT

Overview

Tax changes based on client number refer to the process of identifying, tracking, and applying updates or modifications to a client's tax situation using a unique client identifier (client number).

OperationId: POST Search TaxChanges

Authorization Method(s): OAuth

Verb: POST

End Point: /api/taxchanges/search

Request Body

OVERVIEWEXAMPLE

Request Model

Display Name	Field Name	Field Type
Client Number *	clientNumber	string
Search Country	searchCountry	SearchCountry
Search Option	searchOption	SearchOption
Search Type	searchType	string
Filters	filters	CommonSearchFilters
Parameters	parameters	CommonSearchParameters

SearchCountry

Display Name	Field Name	Field Type

SearchOption

Display Name	Field Name	Field Type

CommonSearchFilters

Display Name	Field Name	Field Type
Customer Usage Type *	customerUsageType	string
Provider Type *	providerType	providerTypes
Start Date	startDate	DataYearMonth
End Date	endDate	DataYearMonth
Release Number	releaseNumber	integer
Date Type	dateType	SearchDateType

DataYearMonth

Display Name	Field Name	Field Type
Year *	year	string
Month *	month	string
Day	day	integer

DataYearMonth

Display Name	Field Name	Field Type
Year *	year	string
Month *	month	string
Day	day	integer

SearchDateType

Display Name	Field Name	Field Type

CommonSearchParameters

Display Name	Field Name	Field Type
Pgpis	pgpis	array[Pgpi]
Postal Code	postalCode	string
Npanxx	npanxx	string
Locations	locations	array[]
Address	address	Address
State County City	stateCountyCity	StateCountyCity
Geocode	geocode	string
By	by	SearchListItemsBy
Skus	skus	array[]

Pgpi

Display Name	Field Name	Field Type
Product Group	productGroup	string
Product Item	productItem	string

Address

Display Name	Field Name	Field Type
Address1	address1	string
Address2	address2	string
City	city	string
County	county	string
Postal Code	postalCode	string
Plus4	plus4	string
State	state	string

StateCountyCity

Display Name	Field Name	Field Type
State *	state	string
County	county	string
City	city	string

SearchListItemsBy

Display Name	Field Name	Field Type

Example Request

{
  "filters": {
    "customerUsageType": "07",
    "providerType": "80",
    "startDate": {
      "year": "2024",
      "month": "12",
      "day": 1
    },
    "endDate": {
      "year": "2025",
      "month": "01",
      "day": 1
    },
    "releaseNumber": null,
    "dateType": "Date"
  },
  "parameters": {
    "pgpis": [],
    "postalCode": null,
    "npanxx": null,
    "locations": null,
    "address": null,
    "stateCountyCity": null,
    "geocode": "US48113A0004",
    "by": "ProductGroupItem",
    "skus": []
  },
  "clientNumber": "ZREGRSV06",
  "searchCountry": "UnitedStates",
  "searchOption": "Geocode",
  "searchType": "TaxabilityChanges"
}

Query Parameters

Display String	Field Name	Field Type
Api-version*	api-version	undefined

*Mandatory parameter

ProblemDetails

OVERVIEWEXAMPLE

Overview

ProblemDetails

Display Name	Field Name	Field Type
Type	type	string
Title	title	string
Status	status	integer
Detail	detail	string
Instance	instance	string

Example Response

{
  "results": [
    {
      "taxabilityChangeId": 0,
      "groupID": "",
      "groupDescription": "",
      "itemID": "",
      "itemDescription": "",
      "state": "",
      "county": "",
      "city": "",
      "otherLocal": "",
      "postalCode": "",
      "plus4": "",
      "taxAuthority": "",
      "taxName": "",
      "taxType": "",
      "taxTypeDescription": "",
      "taxTypeFullDescription": "",
      "taxCategory": "",
      "taxCategoryDescription": "",
      "taxCategoryFullDescription": "",
      "currentTaxability": true,
      "currentPercentTaxable": 0,
      "currentEffectiveDate": "2025-03-12T13:54:43.8671566-06:00",
      "previousTaxability": true,
      "previousPercentTaxable": 0,
      "previousEffectiveDate": "2025-03-12T13:54:43.8671626-06:00",
      "customerType": "",
      "providerType": "",
      "geocode": "",
      "locationId": "",
      "sales_Use": ""
    }
  ],
  "locationResults": [
    {
      "locationId": "",
      "results": [
        {
          "taxabilityChangeId": 0,
          "groupID": "",
          "groupDescription": "",
          "itemID": "",
          "itemDescription": "",
          "state": "",
          "county": "",
          "city": "",
          "otherLocal": "",
          "postalCode": "",
          "plus4": "",
          "taxAuthority": "",
          "taxName": "",
          "taxType": "",
          "taxTypeDescription": "",
          "taxTypeFullDescription": "",
          "taxCategory": "",
          "taxCategoryDescription": "",
          "taxCategoryFullDescription": "",
          "currentTaxability": true,
          "currentPercentTaxable": 0,
          "currentEffectiveDate": "2025-03-12T13:54:43.8671652-06:00",
          "previousTaxability": true,
          "previousPercentTaxable": 0,
          "previousEffectiveDate": "2025-03-12T13:54:43.8671656-06:00",
          "customerType": "",
          "providerType": "",
          "geocode": "",
          "locationId": "",
          "sales_Use": ""
        }
      ]
    }
  ],
  "errors": []
}

Response Codes

code	description
200	Search was successful for the given client number.
401	User doesn't have access to use the API.

To execute a web service call for API Key Enabled APIs, Select an environment and enter the client number and validation api key corresponding to that environment.

Select Environment:End Point:

/api/taxchanges/search

Add Request Headers:

{
  "filters": {
    "customerUsageType": "07",
    "providerType": "80",
    "startDate": {
      "year": "2024",
      "month": "12",
      "day": 1
    },
    "endDate": {
      "year": "2025",
      "month": "01",
      "day": 1
    },
    "releaseNumber": null,
    "dateType": "Date"
  },
  "parameters": {
    "pgpis": [],
    "postalCode": null,
    "npanxx": null,
    "locations": null,
    "address": null,
    "stateCountyCity": null,
    "geocode": "US48113A0004",
    "by": "ProductGroupItem",
    "skus": []
  },
  "clientNumber": "ZREGRSV06",
  "searchCountry": "UnitedStates",
  "searchOption": "Geocode",
  "searchType": "TaxabilityChanges"
}