Search TIC Codes
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.
Request
- Base URL: https://api.v3.taxcloud.com
- URL: https://api.v3.taxcloud.com/tax/tic/search
- Auth: HTTP bearer
Request body
Response
OK
Changes
No recorded changes to this operation across all 1 revision of this API.