For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
SupportLog InSign Up
GuidesAPI Reference
GuidesAPI Reference
  • Tax Rates
    • GETGet Tax Rates (v6.0)
  • Account
    • GETGet Account Metrics (v6.0)
  • Data
    • GETGet TIC Codes
    • POSTSearch TIC Codes
    • POSTRecommend TIC Codes
    • GETGet TIC Search JSON Schema
  • System
    • GETHealth Check
    • GETGet System Metadata
Logo
SupportLog InSign Up
Data

Recommend TIC Codes

POST
/search/tic/recommend
POST
/search/tic/recommend
$curl -X POST https://api.ziptax.com/search/tic/recommend \
>     -H "X-API-KEY: <apiKey>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "query": "sliced bread in plastic packaging"
>}'
1{
2  "predictions": [
3    {
4      "status": "success",
5      "error": "null",
6      "label": "TIC123",
7      "naturalLabel": "Packaged Bread Products",
8      "product_description": "sliced bread in plastic packaging",
9      "ticId": 123,
10      "tic_description": "Taxability Information Code for packaged bread and bakery products"
11    }
12  ]
13}

Returns ML-driven TIC recommendations for a natural-language product description. Backed by a Databricks model serving endpoint and rate-limited to 10 requests per minute per API key.

Was this page helpful?
Previous

Get TIC Search JSON Schema

Next
Built with

Authentication

X-API-KEYstring
API key in header

Request

This endpoint expects an object.
querystringRequired1-1024 characters

Natural-language product description used to drive the ML recommendation.

Response

OK
predictionslist of objects

Ranked TIC recommendations from the ML model. Always contains at least one entry; on failure it contains a single entry with status set to fail.

Errors

400
Bad Request Error
401
Unauthorized Error
429
Too Many Requests Error
502
Bad Gateway Error
504
Gateway Timeout Error