Product Codes | Ziptax

Available onProEnterprise

Ziptax offers two endpoints for mapping product descriptions to Taxability Information Codes (TICs):

Product Code Search — returns a ranked list of all applicable TICs matching a natural language description, each with a relevance score.
Product Code Recommendation — uses the same natural language input, plus an AI-powered model, to return the single best TIC match for your product.

Use Search when you want to present multiple options (e.g. in a merchant-facing UI). Use Recommendation when you want the system to pick the best TIC automatically.

Product Code Search

The Product Code Search endpoint returns a ranked list of all applicable Product Codes (TICs) that match a natural language product description. Each result includes a relevance score so you can surface the best matches in your application.

Endpoint

POST

/search/tic

curl -X POST https://api.zip-tax.com/search/tic \
     -H "X-API-KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "query": "Ceramic & Pottery Kilns"
}'

Try it

Header Parameters

X-API-KEY

stringRequired

Your Ziptax API key.

Body Parameters

query

stringRequired

A full-text product description. The API returns all applicable product codes matching this description, ranked by relevance.

Example

curl -X POST https://api.zip-tax.com/search/tic \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "baked bread in plastic packaging"
  }'

Example Response

{
  "$schema": "https://api.zip-tax.com/schemas/ticsearch",
  "nextCursor": "eyJxdWVyeV9oYXNoIjoiYmFrZWQtYnJlYWQtaW4tcGxhc3RpYy1wYWNrYWdpbmciLCJvZmZzZXQiOjEwfQ==",
  "query": "baked bread in plastic packaging",
  "results": [
    {
      "ticId": 41030,
      "label": "Bakery Items",
      "naturalLabel": "Bakery Items",
      "description": "Bakery items sold without eating utensils provided by the seller, including bread, rolls, buns, biscuits, bagels, croissants, pastries, donuts, Danish, cakes, tortes, pies, tarts, muffins, bars, cookies, tortillas ",
      "documentation": "Bakery items sold without eating utensils provided by the seller, including bread, rolls, buns, biscuits, bagels, croissants, pastries, donuts, Danish, cakes, tortes, pies, tarts, muffins, bars, cookies, and tortillas.",
      "rank": 1,
      "score": 0.891025641025641
    },
    {
      "ticId": 0,
      "label": "General",
      "naturalLabel": "Uncategorized tangilble personal property",
      "description": "Uncategorized tangilble personal property",
      "documentation": "Any tangible personal property that does not fit within the other defined categories. This TIC defaults to taxable in all states. For uncategorized services, use TIC 00001.",
      "rank": 2,
      "score": 0.8249269005847953
    },
    {
      "ticId": 40030,
      "label": "Food and Food ingredients",
      "naturalLabel": "Food and food ingredients excluding alcoholic beverages and tobacco",
      "description": "Food and food ingredients excluding alcoholic beverages and tobacco",
      "documentation": "Food and food ingredients means substances, whether in liquid, concentrated, solid, frozen, dried, or dehydrated form, that are sold for ingestion or chewing by humans and are consumed for their taste or nutritional value. Note: Excludes alcoholic beverages and tobacco.",
      "rank": 3,
      "score": 0.7809034572733202
    }
  ]
}

Product Code Recommendation

The Product Code Recommendation endpoint accepts the same natural language input as Product Code Search, but adds an AI-powered model that selects the single best TIC match for your product. Use this endpoint when you need the most accurate automatic recommendation for a given product description.

Endpoint

POST

/search/tic/recommend

curl -X POST https://api.zip-tax.com/search/tic/recommend \
     -H "X-API-KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "query": "wireless bluetooth headphones"
}'

Try it

Header Parameters

X-API-KEY

stringRequired

Your Ziptax API key.

Body Parameters

query

stringRequired

A full-text product description. The model returns the best matching TIC for this description.

Example

curl -X POST https://api.zip-tax.com/search/tic/recommend \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "baked bread in plastic packaging"
  }'

Example Response

{
    "predictions": [
        {
            "status": "success",
            "error": null,
            "ticId": 41030,
            "label": "Bakery Items",
            "naturalLabel": "Bakery Items",
            "tic_description": "Bakery items sold without eating utensils provided by the seller, including bread, rolls, buns, biscuits, bagels, croissants, pastries, donuts, Danish, cakes, tortes, pies, tarts, muffins, bars, cookies, tortillas ",
            "product_description": "baked bread in plastic packaging"
        }
    ]
}