Search TIC Codes | TaxCloud

Search for Taxability Information Codes (TICs) using semantic search.

This endpoint helps you find the correct TICs for your products using natural language product descriptions, category names, or search terms. It uses semantic similarity (vector-based) to match meaning and context, so results can be relevant even when exact terminology doesn’t match.

How it works:

Provide a product description, category name, or search term
The system searches available TICs using semantic similarity
Results are ranked by relevance (most relevant first)
Set limit from 1–100 (defaults to 10 when omitted)
Use cursor to paginate through results (optional, from previous response’s nextCursor)

Best Practices:

Use specific descriptions: “Ceramic & Pottery Kilns” works better than “kilns”
Include context: “Women’s Athletic Shoes” is better than “shoes”
If you don’t find a match, try broader or more specific terms

Example Queries:

“Ceramic & Pottery Kilns”, “Women’s Running Shoes”, “Laptop Computer”
“Clothing”, “Electronics”, “Food & Beverages”
“shipping charges”, “digital goods”, “prescription drugs”

Service Availability: If you receive a service unavailable error (HTTP 503), this indicates temporary downstream service unavailability, potentially due to rate limiting. Check the Retry-After header (if present) and retry your request after the specified delay. Use exponential backoff for retries.

Search for Taxability Information Codes (TICs) using semantic search. This endpoint helps you find the correct TICs for your products using natural language product descriptions, category names, or search terms. It uses semantic similarity (vector-based) to match meaning and context, so results can be relevant even when exact terminology doesn't match. **How it works:** - Provide a product description, category name, or search term - The system searches available TICs using semantic similarity - Results are ranked by relevance (most relevant first) - Set **limit** from 1–100 (defaults to **10** when omitted) - Use **cursor** to paginate through results (optional, from previous response's nextCursor) **Best Practices:** - Use specific descriptions: "Ceramic & Pottery Kilns" works better than "kilns" - Include context: "Women's Athletic Shoes" is better than "shoes" - If you don't find a match, try broader or more specific terms **Example Queries:** - "Ceramic & Pottery Kilns", "Women's Running Shoes", "Laptop Computer" - "Clothing", "Electronics", "Food & Beverages" - "shipping charges", "digital goods", "prescription drugs" **Service Availability:** If you receive a service unavailable error (HTTP 503), this indicates temporary downstream service unavailability, potentially due to rate limiting. Check the Retry-After header (if present) and retry your request after the specified delay. Use exponential backoff for retries.

Authentication

AuthorizationBearer

This authentication type can be used to directly call the service.

X-API-KEYstring

This authentication type is supported by using the provided API key for the merchant account.

Request

This endpoint expects an object.

querystringRequired

Product description, category name, or search term

cursorstringOptional

Pagination cursor from previous response. Use the nextCursor value from a previous request to get the next page of results.

limitlongOptional

Maximum number of TIC results to return (1-100). Defaults to 10 if not provided. Fewer results may be returned if fewer matches are available.

Response

querystring

Echo of the input query

resultslist of objects

Ranked TIC results (most relevant first)

$schemastring or nullRead-onlyformat: "uri"

A URL to the JSON Schema for this object.

nextCursorstring or null

Cursor for retrieving next page of results

Errors

Search for Taxability Information Codes (TICs) using semantic search.

How it works:

Provide a product description, category name, or search term
The system searches available TICs using semantic similarity
Results are ranked by relevance (most relevant first)
Set limit from 1–100 (defaults to 10 when omitted)
Use cursor to paginate through results (optional, from previous response’s nextCursor)

Best Practices:

Use specific descriptions: “Ceramic & Pottery Kilns” works better than “kilns”
Include context: “Women’s Athletic Shoes” is better than “shoes”
If you don’t find a match, try broader or more specific terms

Example Queries:

“Ceramic & Pottery Kilns”, “Women’s Running Shoes”, “Laptop Computer”
“Clothing”, “Electronics”, “Food & Beverages”
“shipping charges”, “digital goods”, “prescription drugs”

1	import requests
2
3	url = "https://api.v3.taxcloud.com/tax/tic/search"
4
5	payload = { "query": "Ceramic & Pottery Kilns" }
6	headers = {
7	"Authorization": "Bearer <token>",
8	"Content-Type": "application/json"
9	}
10
11	response = requests.post(url, json=payload, headers=headers)
12
13	print(response.json())

1	{
2	"query": "Ceramic & Pottery Kilns",
3	"results": [
4	{
5	"description": "School computer supply",
6	"documentation": "Computer supplies (School supply)",
7	"label": "Computer supplies",
8	"naturalLabel": "School computer supply",
9	"rank": 1,
10	"score": 0.9841269841269842,
11	"ticId": 20010
12	}
13	],
14	"$schema": "https://example.com/tax/schemas/TicSearchResponse.json",
15	"nextCursor": "string"
16	}